Eigenschaften (Edit-Control)

Eigenschaften

Name	Typ	Beschreibung
Alignment	EAlignment	Über die Eigenschaft Alignment können Sie den Text innerhalb des Controls nach Ihren Wünschen horizontal ausrichten.
AllowedChars	String	Controls, bei denen eine Benutzereingabe erwartet wird, können über diese Eigenschaft vor unerlaubten Eingaben von bestimmten Zeichen geschützt werden.
BackColor	Long (OLE_COLOR)	Mit der Eigenschaft BackColor können Sie die Hintergrundfarbe des Editierbereiches 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).
BorderStyle	EStyle	Mit der Eigenschaft BorderStyle können Sie Darstellung des Randes des Editierbereiches des Controls einstellen.
Caption	String	Mit der Eigenschaft Caption können Sie die Beschriftung des Controls definieren, die als Spaltenüberschrift direkt über den Wertezellen eingetragen wird. 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.
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 Edit-Control keinen Text anzeigt. Die Eigenschaft wirkt sich nur bei einzeiligen Edit-Controls aus.
Enabled	Boolean	Die Eigenschaft Enabled bestimmt, ob das Edit-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.
FontScale	Boolean	Die Eigenschaft FontScale bestimmt, ob die Zeichensatzgröße der Eingabeschrift sich an Größenänderungen des Controls anpasst.
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). Natürlich wird diese Einstellung nur dann verwendet wenn das Validierungssymbol angezeigt werden soll (ValidationSymbol= TRUE).
ImmediateChange	Boolean	Bestimmt, ob die Steuervariable des Controls bei jeder Textänderung aktualisiert wird und somit eine Regelüberprüfung auslöst.
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.
MultiLine	Boolean	Über die Eigenschaft MultiLine können Sie bestimmen, ob der Text ein- oder mehrzeilig – d.h. in einer Editline oder einem Texteditor - angezeigt werden soll.
PasswordChar	String	Mit Hilfe der Eigenschaft PasswordChar können Sie eine Editline für eine Passworteingabe verwenden. Das hier hinterlegte Zeichen wird bei jedem Tastendruck statt des eigentlich getippten Zeichens in der Editline angezeigt.
RTLReading	Boolean	Die Eigenschaft RTLReading legt die Schreibrichtung fest. Die Option RTL (=Right To Left) muss für arabische Schriftarten aktiviert werden.
ScrollBars	Scrollbars	Über die Eigenschaft ScrollBars können Sie definieren, welche Scrollbar (horizontal und/oder vertikal) im Control eingeblendet werden soll. Scrollbars werden für das Control Edit nur benötigt, wenn dieses als Texteditor (Multiline=TRUE) verwendet wird.
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
Softbreak	Boolean	Die Eigenschaft Softbreak bestimmt, ob Softbreak-Steuerzeichen an die Steuervariable übergeben werden
Tooltip	String	Ein ToolTip ist ein Hilfstext, der zur Laufzeit angezeigt wird, wenn der Benutzer mit dem Mauszeiger über das Element fährt
UseComboHeight	Boolean	Über die Eigenschaft UseComboHeight können Sie die Höhe einer Editline an die Höhe einer Combobox anpassen. Normalerweise unterscheidet sich die Höhe einer Editline von der einer Combobox minimal. Falls jedoch auf dem Formular eine Editline neben einer Combobox positioniert wird, kann man die Höhen mit dieser Eigenschaft angleichen.
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	Ausdruck	Über die Eigenschaft Value können Sie das Control mit einer Einflussgröße hinterlegen. Der Einflussgröße wird dann der im Eingabebereich eingegebene Wert zugewiesen bzw. der Wert der Einflussgröße angezeigt.