Eigenschaften (Combobox-Control)

Eigenschaften

Name	Typ	Beschreibung
AllowedChars	String	Controls, bei denen eine Benutzereingabe erwartet wird, können über diese Eigenschaft vor unerlaubten Eingaben von bestimmten Zeichen geschützt werden, wenn die Combobox editierbar ist.
BackColor	Long (OLE_COLOR)	Mit der Eigenschaft BackColor können Sie die Hintergrundfarbe des Eingabebereiches sowie des Aufklappbereiches des Controls definieren. Farben werden im Hex-Code im Modus GBR abgespeichert. Führende Nullen werden bei der Farbcode-Anzeige gestrichen (z.B. steht die Codierung &HFF für rot, was aus dem Wert &H0000FF resultiert).
Caption	String	Über die Eigenschaft Caption definieren Sie die Beschriftung des Controls. So können Sie sich das mühselige Voranstellen eines Labels zur Beschriftung des Controls sparen. Für die Beschriftung kann ein entsprechender Bereich des Controls reserviert werden (s. CaptionWidth). In diesem Bereich können Sie den Text beliebig gestalten und auch positionieren. Voraussetzung dafür ist jedoch, dass in der Eigenschaft CaptionType der Wert 2 – UseCaption eingestellt ist.
CaptionBackColorEnd	Long (OLE_COLOR)	In dieser Eigenschaft legen Sie eine von zwei möglichen Hintergrundfarben für den Beschriftungsbereich des Controls fest. Wie die Hintergrundfarbe erscheinen soll, definieren Sie mit der Eigenschaft CaptionStyle: die hier eingestellte Hintergrundfarbe wird als einzige Hintergrundfarbe angezeigt wenn Sie in der Eigenschaft CaptionStyle die Einstellung 1 – OnlyEndColor auswählen. Für weitere Darstellungsmöglichkeiten lesen Sie bitte die Beschreibung zur Eigenschaft CaptionStyle. Farben werden im Hex-Code im Modus GBR abgespeichert. Führende Nullen werden bei der Farbcode-Anzeige gestrichen (z.B. steht die Codierung &HFF für rot, was aus dem Wert &H0000FF resultiert).
CaptionBackColorStart	Long (OLE_COLOR)	In dieser Eigenschaft legen Sie eine von zwei möglichen Hintergrundfarben für den Beschriftungsbereich des Controls fest. Wie die Hintergrundfarbe erscheinen soll, definieren Sie mit der Eigenschaft CaptionStyle: die hier eingestellte Hintergrundfarbe wird als einzige Hintergrundfarbe angezeigt wenn Sie in der Eigenschaft CaptionStyle die Einstellung 0 – OnlyStartColor auswählen. Für weitere Darstellungsmöglichkeiten lesen Sie bitte die Beschreibung zur Eigenschaft CaptionStyle.
CaptionColorStyle	BackColorStyle	Mit der Eigenschaft CaptionColorStyle definieren Sie den Farbverlauf im Bereich der Beschriftung. Sie können zwei verschiedene Farben definieren: CaptionBackColorStart und CaptionBackColorEnd. Mit diesen Farben können Sie die Beschriftung entweder einfarbig anzeigen oder diese mit verschiedenen Farbeffekten füllen.
CaptionFont	Font	In der Eigenschaft CaptionFont wird die Schriftart sowie die Schriftgröße definiert, in der die Beschriftung des Controls angezeigt werden soll.
CaptionForeColor	Long (OLE_COLOR)	Die Eigenschaft CaptionForeColor legt die Schriftfarbe (=Vordergrundfarbe) der Beschriftung fest. Farben werden im Hex-Code im Modus GBR abgespeichert. Führende Nullen werden bei der Farbcode-Anzeige gestrichen (z.B. steht die Codierung &HFF für rot, was aus dem Wert &H0000FF resultiert).
CaptionHAlignment	HAlignment	In der Eigenschaft CaptionHAlignment können Sie die horizontale Ausrichtung des Beschriftungstextes definieren.
CaptionScale	Boolean	Die Eigenschaft CaptionScale bestimmt, ob die Zeichensatzgröße der Überschrift sich an Größenänderungen des Controls anpasst.
CaptionType	DescriptionType	Über die Eigenschaft CaptionType können Sie definieren, welche Beschriftung das Control erhalten soll.
CaptionVAlignment	VAlignment	In der Eigenschaft CaptionVAlignment können Sie die vertikale Ausrichtung des Beschriftungstextes definieren.
CaptionWidth	Double	Über die Eigenschaft CaptionWidth können Sie die Breite der Beschriftung festlegen. Diese Angabe erfolgt in Twips. Wenn Sie die Breite in Pixel erfassen möchten, geben Sie zum Beispiel „100px“ an. Die Eingabe in Pixel wird dann in Twips umgerechnet.
ComboIsDropped	Boolean ReadOnly	Wird bei einer Combobox die Drop-Down-Liste angezeigt, liefert diese Eigenschaft True, ansonsten False
ContextMenu	String	Hinterlegen Sie bei dieser Eigenschaft den Namen eines Menüs aus der TCE Klasse, das der Benutzer durch Drücken der rechten Maustaste aufrufen kann, wenn sich der Mauszeiger über dem Control befindet.
CueBanner	String	Hinterlegen Sie bei dieser Eigenschaft einen Hinweistext, der angezeigt wird, wenn das Control keinen anderen Text anzeigt. Die Eigenschaft wirkt sich nur bei Style=0 aus.
DoAutoComplete	Boolean	Die Eigenschaft DoAutoComplete kann ein automatisches Vervollständigen eines Strings während der Benutzereingabe veranlassen: ist diese Eigenschaft aktiviert, sucht die Combobox automatisch während der Eingabe der ersten Zeichen eines Strings nach einem passenden Wert .in der Werteliste und vervollständigt sich selbständig.
DropDownWidth	Double	Über die Eigenschaft DropDownWidth können Sie die Breite des Aufklappfeldes festlegen. Diese Angabe erfolgt in Twips. Soll das Aufklappfeld automatisch so breit wie das Control angezeigt werden, geben Sie den Wert 0 ein.
Enabled	Boolean	Die Eigenschaft Enabled bestimmt, ob das Control vom Benutzer aktiviert werden kann.
Font	Font	In der Eigenschaft Font wird die Schriftart sowie die Schriftgröße definiert, in der der Text des Controls angezeigt werden soll.
ForeColor	Long (OLE_COLOR)	Mit der Eigenschaft ForeColor können Sie die Textfarbe des Eingabebereiches des Controls definieren. Farben werden im Hex-Code im Modus GBR abgespeichert. Führende Nullen werden bei der Farbcode-Anzeige gestrichen (z.B. steht die Codierung &HFF für rot, was aus dem Wert &H0000FF resultiert).
HAlignPicture	HAlignment	Über die Eigenschaft HAlignPicture können Sie die horizontale Position des Validierungssymbols innerhalb der Beschriftung (s. Caption) festlegen. Zudem ist die Positionierung von der Breite des Beschriftungsbereichs abhängig (s. CaptionWidth). Diese Einstellung nur dann verwendet wenn das Validierungssymbol angezeigt werden soll (ValidationSymbol= TRUE).
Language	String	Um die Mehrsprachigkeit zu unterstützen, können Sie für das Control ein mehrsprachiges Merkmal hinterlegen Mit Hilfe der Einstellung Language können Sie dann die Sprache definieren, deren Text im Control angezeigt werden soll. Dazu geben Sie in dieser Eigenschaft die ID der anzuzeigenden Sprache an. Es wird automatisch der Text der aktuellen Dialogsprache angezeigt, wenn Sie diese Eigenschaft nicht verwenden.
Languages	String	Um die Mehrsprachigkeit zu unterstützen, können Sie für das Control ein mehrsprachiges Merkmal hinterlegen. Mit Hilfe der Eigenschaft Languages können Sie die Sprachen definieren, die dem Anwender zur Verfügung stehen sollen. Tragen Sie bei dieser Eigenschaft mehrere Sprachen ein damit automatisch rechts neben dem Control ein Button angezeigt wird, mit dessen Hilfe Sie die aktuelle Sprache für das Control aufrufen können. Beachten Sie, dass die Auflistung der gewünschten LanguageIDs durch Semikolon getrennt erfolgen muss: z.B: DE;UK;FR
Locked	Boolean	Verwenden Sie diese Eigenschaft, um den Eingabebereich des Controls für Benutzereingaben zu sperren oder freizugeben. Im gesperrten Zustand kann der Anwender keine Eingaben machen. Lediglich das Markieren und Kopieren von Text ist dann dem Anwender gestattet.
MaxLength	Long	Über die Eigenschaft MaxLength definieren Sie die maximale Anzahl der Zeichen, die im Eingabebereich des Controls vom Anwender eingegeben werden können.
NoDimWhenOutOfFocus	Boolean	Die Eigenschaft NoDimWhenOutOfFocus bestimmt, ob die Textselektion sichtbar bleibt, auch wenn das Control den Focus verliert
NoGrayWhenDisabled	Boolean	Mit der Eigenschaft NoGrayWhenDisabled können Sie die Textfarbe des Controls unverändert lassen, wenn das Control deaktiviert ist.
SelLength	Long ReadOnly	Die Eigenschaft SelLength ermittelt die Anzahl der markierten Zeichen des Edit-Controls.
SelStart	Long ReadOnly	Die Eigenschaft SelStart ermittelt die Position des Cursors.
SelText	String ReadOnly	Die Eigenschaft SelText ermittelt den markierten Text
ShowBaseClass	Boolean	Über die Eigenschaft ShowBaseClass können Sie steuern ob auch die Klassen angezeigt werden sollen, deren Einstellung Wertebereich anzeigen nicht gesetzt ist, falls es sich bei der gewählten Einflussgröße um eine Objektvariable von TCE-Klassen handelt.
ShowEmpty	Boolean	Die Eigenschaft ShowEmpty ermöglicht die Einstellung, dass auch leere Werte zur Auswahl angezeigt werden.
ShowOnlyValid	Boolean	Die Eigenschaft ShowOnlyValid ermöglicht die Einstellung, dass nur gültige Werte zur Auswahl angezeigt werden.
Sorted	Boolean	Über die Eigenschaft Sorted können Sie einstellen, dass die zur Auswahl angezeigten Werte nach dem Alphabet sortiert werden.
Style	CBStyle	Mit dieser Eigenschaft können Sie das Erscheinungsbild und dadurch auch das Verhalten der Combobox definieren.
Tooltip	String	Ein ToolTip ist ein Hilfstext, der zur Laufzeit angezeigt wird, wenn der Benutzer mit dem Mauszeiger über das Element fährt
ValidationAction	ValidationActions	Über die Eigenschaft ValidationAction können Sie festlegen, wie auf das Klicken des Validierungssymbols reagiert werden soll.
ValidationSymbol	Boolean	Mit Hilfe der Eigenschaft ValidationSymbol können Sie vor dem Control das aktuell zur Einflussgröße (s. Value) passende Validierungssymbol anzeigen lassen. Dazu muss genügend Platz durch die Eingabe eines Wertes in CaptionWidth vorgesehen sein.
VAlignPicture	VAlignment	Über die Eigenschaft VAlignPicture können Sie die vertikale Position des Validierungssymbols innerhalb der Beschriftung (s. Caption) festlegen. Natürlich wird diese Einstellung nur dann verwendet wenn das Validierungssymbol angezeigt werden soll (ValidationSymbol = TRUE).
Value	Ausdrücke	Über die Eigenschaft Value können Sie das Control mit einer Einflussgröße hinterlegen. Dem Control wird dann der über das Control eingegebene Wert zugewiesen.