4D Doc Center : SVG Find element IDs by rect

Home

4D v14.3

SVG

SVG Find element IDs by rect


SVG Find element IDs by rect ( {* ;} Bildobjekt ; PositionX ; PositionY ; Breite ; Höhe ; arrIDs ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
*	Operator	Mit Stern: Bildobjekt ist ein Objektname (String) Ohne Stern: Bildobjekt ist eine Variable
Bildobjekt	Bild	Mit : Objektname, ohne : Feld oder Variable
PositionX	Lange Ganzzahl	Horizontale Koordinate der oberen linken Ecke des Auswahlrechtecks
PositionY	Lange Ganzzahl	Vertikale Koordinate der oberen linken Ecke des Auswahlrechtecks
Breite	Lange Ganzzahl	Breite des Auswahlrechtecks
Höhe	Lange Ganzzahl	Höhe des Auswahlrechtecks
arrIDs	Array Text	IDs der Elemente, deren begrenzendes Rechteck sich mit dem Auswahlrechteck überschneidet.
Funktionsergebnis	Boolean	Wahr = mindestens ein Element wird gefunden

Beschreibung

Die Funktion SVG Find element IDs by rect füllt das Array vom Typ Text oder alphanumerisch mit den IDs (Attribute "id" oder "xml:id") der XML Elemente, deren begrenzendes Rechteck sich mit dem Auswahlrechteck überschneidet, dessen Position in den Parametern PositionX und PositionY angegeben ist.

Die Funktion gibt wahr zurück, wenn mindestens ein Element gefunden wird, d.h. das Array arrIDs ist nicht leer. Andernfalls gibt sie wahr zurück.

Diese Funktion eignet sich besonders zum Verwalten von interaktiven grafischen Oberflächen. Mit dem optionalen Parameter * geben Sie an, dass der Parameter Bildobjekt ein Objektname ist (String). Ohne diesen Parameter geben Sie an, dass Bildobjekt ein Feld oder eine Variable ist. In diesem Fall übergeben Sie eine Variablenreferenz (nur Objektfeld oder -variable) anstelle eines String.

Arbeiten Sie mit einem Bildfeld bzw. einer -variablen, verwendet die Funktion das Originalbild, das der Datenquelle entspricht. Arbeiten Sie dagegen mit einem Formularobjekt, verwendet die Funktion das aktuelle Bild, das u.U. über den Befehl SVG SET ATTRIBUTE verändert wurde und mit den Eigenschaften des Formularobjekts beibehalten wird.

Die in den Parametern PositionX und PositionY übergebenen Koordinaten müssen in Pixel in Bezug auf die linke obere Ecke des Bildes (0,0) ausgedrückt werden. Sie können die Werte verwenden, die von den Systemvariablen MouseX und Mouse Y zurückgegeben werden. Sie werden von den Formularereignissen On Clicked und On Double Clicked sowie den Formularereignissen On Mouse Enter und On Mouse Move aktualisiert.

Hinweis: Im System der Bildkoordinaten geben [x;y] immer denselben Punkt an, und zwar unabhängig vom Anzeigeformat des Bildes mit Ausnahme des Formats "Replicated".

Alle Elemente, deren begrenzendes Rechteck sich mit dem Auswahlrechteck überschneidet, werden berücksichtigt, auch wenn sie unter anderen Elementen liegen.