4D Doc Center : GET HIGHLIGHT

4D v12.4

GET HIGHLIGHT


GET HIGHLIGHT ( {* ;} Objekt ; StartAusw ; EndeAusw )

Parameter	Typ	Beschreibung
*	Operator	Mit , Objekt ist ein Objektname (String), Ohne , Objekt ist Feld oder Variable
Objekt	Feld, Variable, Formularobjekt	Objektname (mit ) oder Feld oder Variable (ohne )
StartAusw	Lange Ganzzahl	Startpunkt der aktuellen Textauswahl
EndeAusw	Lange Ganzzahl	Endpunkt der aktuellen Auswahl

Beschreibung

Der Befehl GET HIGHLIGHT gibt die Position des ausgewählten Textes des aktuellen Objekts zurück.

Mit dem optionalen Parameter * geben Sie an, dass der Parameter Objekt ein Objektname (Zeichenkette) ist. Ohne den Parameter * geben Sie an, dass Objekt ein Feld oder eine Variable ist. In diesem Fall übergeben Sie anstelle einer Zeichenkette die Feld- oder Variablenreferenz (nur Formularfelder oder Variablen).

Warnung: Auch wenn Sie in Objekt einen Feld- oder Variablennamen übergeben haben, wird die ausgewählte Position nur angegeben, wenn GET HIGHLIGHT auf den Bereich angewandt wird, der gerade in Bearbeitung ist.

Hinweis: Sie können diesen Befehl nicht für Felder eines Ausgabeformulars in einem Unterformular verwenden.

Der Text kann entweder vom Benutzer oder über den Befehl HIGHLIGHT TEXT markiert werden.
Der Parameter StartAusw gibt die Position des ersten markierten Zeichens zurück. Der Parameter EndeAusw gibt die Position nach dem letzten markierten Zeichen zurück. Haben StartAusw und EndeAusw denselben Wert, wird die Einfügemarke vor dem ersten markierten Zeichen gesetzt. In diesem Fall hat der Benutzer keinen Text ausgewählt, es werden keine Zeichen markiert.

Beispiel 1

Folgendes Beispiel erhält den markierten Text aus dem Datenfeld [Products]Comments:

 GET HIGHLIGHT([Products]Comments;vFirst;vLast)

 If(vFirst<vLast)

    ALERT("Der ausgewählte Text ist: "+Substring([Products]Comments;vFirst;vLast-vFirst))

 End if

Beispiel 2

Siehe Beispiel zum Befehl FILTER KEYSTROKE.

Beispiel 3

Markierten Textstil verändern:

 GET HIGHLIGHT(*;"meinText";$startsel,$endsel)

 OBJECT SET STYLED TEXT ATTRIBUTES(*;"meinText";$startsel,$endsel;Attribute underline style;1;Attribute bold style;1)