ControlGetProp

value ControlGetProp ( string strName, string strProperty, value/string BYREF Result );

Rückgabewert

Rückgabewert	Beschreibung
TRUE / true / 1	Der Befehl wurde erfolgreich ausgeführt.
FALSE / false / 0	Es wurde kein Bauelement mit dem Namen strName gefunden bzw. im Bauelement wurde die Eigenschaft strProperty nicht gefunden.

Parameter

strName

Der Name des Bauelements dessen Eigenschaft ausgelesen werden soll.

strProperty

Der Name der Eigenschaft, das ausgelesen werden soll.

Result

Die Variable an welche der Wert der Eigenschaft übergeben werden soll.

Bemerkung

Liest den Wert Result der Eigenschaft strProperty des Bauelements strName aus.

Benutzerdefinierte Eigenschaften

Wird beim Aufruf von ControlSetProp ein Eigenschaftsname übergeben, der dem Bauelement nicht zugeordnet werden kann, dann wird eine neue Eigenschaft mit diesem Namen und dem Wert Value angelegt. Diese neue Eigenschaft kann dann mit ControlGetProp ausgelesen werden. Auf diese Weise können im Bauelement während der Laufzeit bauelementbezogene Daten hinzugefügt werden.

Vordefinierte Eigenschaften der Bauelemente die für ControlGetProp verfügbar sind

Bauelement Listenfeld

strProperty	Datentyp von Value	Beschreibung
GetChoiseList	string	Liest alle Einträge des Listenfeldes aus und lädt sie Linefeed '\n' verkettetet  nach Result. Beispiel: "Eintrag1\nEintrag2\nEintrag3"
strCurSel	string	Liest den Text der aktuellen Selektion nach Result aus.
iCurSel	value	Liest die Zeilennummer der aktuellen Selektion nach Result aus.

Bauelement 'Ellipse',  'Rechteck', 'Zylinder'

strProperty	Datentyp	Beschreibung
rgbBackgr	value	Die Hintergrundfarbe.
rgbFill	value	Die Füllfarbe.

Bauelement 'Text-/Wertanzeige'

strProperty	Datentyp	Beschreibung
rgbBackgr	value	Die Hintergrundfarbe.
rgbText	value	Die Textfarbe.

Beispiel

ControlGetProp ("Rechteck1","rgbColor",RGBColor);

liest den Wert des Property "rgbColor" des Bauelements "Rechteck1" in die Variable RGBColor aus.

Bauelementfunktionen

Siehe auch ControlGetRect, ControlMove, ControlRestore, ControlSetProp, ControlSetRect, ControlZoom