ControlSetProp

value ControlSetProp ( string/value strName/rxPattern, string strProperty, string/value Value );

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 bzw. das zum Muster rxPattern passt gefunden.

Parameter

strName

Der Name des Bauelements dessen Eigenschaft gesetzt werden soll.

rxPattern

Das Suchmuster das die Namen der Bauelemente beschreibt deren Eigenschaft gesetzt werden soll.

strProperty

Der Name der Eigenschaft, das gesetzt werden soll.

Value

Der Wert auf den die Eigenschaft gesetzt werden soll.

Bemerkung

Setzt die Eigenschaft strProperty eines Bauelements mit dem Namen strName auf den angegeben Wert Value. Wird anstelle des Namens ein Regex-Verweis rxPattern übergeben, so wird die Eigenschaft bei allen Bauelementen gesetzt, die einen entsprechenden Namen besitzen. Verweist der Name strName auf eine Bauelementgruppe, so wird die Eigenschaft eines jeden Bauelement innerhalb der Gruppe gesetzt.

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 ControlSetProp verfügbar sind

Bauelement Schaltfläche

strProperty	Datentyp von Value	Beschreibung
rgbFace	value	Die Flächenfarbe.
rgbHilite	value	Die Kantenfarbe für den links-oben Quadranten.
rgbShadow	value	Die Kantenfarbe für den rechts-unten Quadranten.
rgbFrame	value	Die Rahmenfarbe.

Bauelement 'Eingabe'

strProperty	Datentyp	Beschreibung
EditValue	string	Setzt das Eingabefeld auf Value.

Bauelement Listenfeld

strProperty	Datentyp von Value	Beschreibung
ResetContent	ohne	Löscht alle Einträge des Listenfelds.
Add	string	Fügt den Eintrag Value dem Listenfeld hinzu. Der Eintrag besteht aus dem Text für den Eintrag und falls erforderlich mit ';' getrennt dem auszuführenden Code der bei Auswahl des Eintrags abgearbeitet werden soll. Beispiel nur Eintrag: "Eintrag 1" Beispiel für Eintrag mit Auswahlprogrammcode: "Eintrag 1;Selektion = 1"
SetRedraw	value	Wird benötigt um ein Flackern des Listenfeldes zu verhindern. Wenn z.B. mit ResetContent alle Einträge gelöscht und dann mit Add Einträge hinzugefügt werden. true - Sperrt das Neuzeichnen des Listenfelds. false -  Gibt das Neuzeichnen des Listenfelds frei und löst ein Neuzeichnen aus.
SetChoiseList	string	Löscht alle Einträge des Listenfeldes und lädt sie mit den '\n' verketteten Einträgen von Value. Beispiel: "Eintrag1\nEintrag2\nEintrag3"
strCurSel	string	Setzt die Selektion auf den Eintrag dem Value entspricht.
iCurSel	value	Setzt die Selektion auf die Zeilennummer Value.

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.
BackColorAlpha	value	Die Transparenz der Hintergrundfarbe. Der Wertebereich liegt zwischen 0 und 255, wobei 0 = völlige Transparenz und 255 = keine Transparenz.

 

Beispiel

//Setzt die Schaltflächenfarbe der Schaltfläche "Übernehmen" auf die Farbe 'Coral'
ControlSetProp("Übernehmen", "rgbFace", RGB_Coral);
 

//Setzt die Füllfarbe aller Bauelemente der Gruppe3 bis Gruppe7 auf die Farbe 'Rot'
value rxName;
RegexCreate(rxName, "Gruppe[3-7]");
ControlSetProp(rxName, "rgbFill", RGB_Red);
RegexClose(rxName);
 

Bauelementfunktionen

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