WP Get frame

Home

4D v20 R7

WP Get frame


WP Get frame ( {* ;} wpArea {; textBoxID} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
*	Operator	Mit Stern: wpArea ist Name des Formularobjekts (String) Ohne Stern: wpArea ist ein Objektfeld oder Variable
wpArea	String	Name des Formularobjekts (mit ) oder 4D Write Pro Objektvariable oder Feld (ohne )
textBoxID	String	ID of the text box (only filled if a text box has the focus)
Funktionsergebnis	Lange Ganzzahl	Rahmen, wo der Cursor aktuell steht

Beschreibung

Die Funktion WP Get frame gibt den Rahmen innerhalb des Bereichs 4D Write Pro wpArea zurück, wo der Cursor aktuell steht.

Mit dem optionalen Parameter * geben Sie an, dass wpArea ein Formularobjekt Name (String) ist. Ohne diesen Parameter geben Sie an, dass wpArea eine 4D Write Pro Objektvariable oder Feld ist.

Hinweis: WP Get frame lässt sich nur verwenden, wenn der Bereich wpArea einem Formularobjekt zugewiesen ist (z.B. im aktuellen Formular bzw. Seite angezeigt wird).

Der zurückgegebene Wert lässt sich mit einer der folgenden Konstanten unter dem Thema 4D Write Pro Konstanten vergleichen:

Konstante	Typ	Wert	Kommentar
wk body	Lange Ganzzahl	0	Hauptteilrahmen des Bereichs
wk current section default footer	Lange Ganzzahl	10	Hauptfußteil des Bereichs (nur verfügbar, wenn kein Fußteil für Unterbereich aktiv ist)
wk current section default header	Lange Ganzzahl	9	Hauptkopfteil des Bereichs (nur verfügbar, wenn kein Kopfteil für Unterbereich aktiv ist)
wk current section first footer	Lange Ganzzahl	4	Fußteil der ersten Seite des Bereichs
wk current section first header	Lange Ganzzahl	3	Kopfteil der ersten Seite des Bereichs
wk current section left footer	Lange Ganzzahl	6	Fußteil der linken Seite(n) des Bereichs
wk current section left header	Lange Ganzzahl	5	Kopfteil der linken Seite(n) des Bereichs
wk current section right footer	Lange Ganzzahl	8	Fußteil der rechten Seite(n) des Bereichs
wk current section right header	Lange Ganzzahl	7	Kopfteil der rechten Seite(n) des Bereichs
wk text box	Lange Ganzzahl	11	Textfeld

Wenn sich der Cursor derzeit in einem Textfeld befindet, wird die Element-ID des Textfeldes im Parameter textBoxID zurückgegeben. In allen anderen Fällen wird dieser Parameter leer zurückgegeben.

Beispiel

Sie möchten sicherstellen, dass der User den Cursor in ein Kopfteil oder ein Fußteil gesetzt hat:

 var $frameGet : Integer

 $frameGet:=WP Get frame(*;"WParea")

 If($frameGet=wk body)|($frameGet=wk text box)

    ALERT("Bitte wählen Sie ein Fußteil oder ein Kopfteil.")

 End if

Siehe auch

WP Get footer
WP SET FRAME