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 |
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 |
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: Beispiel für Eintrag mit Auswahlprogrammcode: |
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: |
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);
Siehe auch ControlGetProp, ControlGetRect, ControlMove, ControlRestore, ControlSetRect, ControlZoom