Wertlisteneditoren
Nach oben zu Steuerelementtypen - Index
TValueListEditor ist ein spezialisiertes Gitter für die Bearbeitung von Stringlisten, die Namen-/Wertpaare in der Form Name=Wert enthalten. Die Namen und Werte sind als Abkömmling von TStrings gespeichert, der der Wert der Eigenschaft Strings ist. Mit der Eigenschaft Values können Sie den Wert für jeden Namen nachschlagen. TValueListEditor ist nur für Windows vorgesehen.
Das Gitter besteht aus zwei Spalten, eine für die Namen und eine für die Werte. Standardmäßig wird die Namensspalte mit "Key" bezeichnet und die Wertespalte mit "Value". Sie können diese Voreinstellungen ändern, indem Sie die Eigenschaft TitleCaptions angeben. Mit der Eigenschaft DisplayOptions (die auch das Skalieren steuert, wenn Sie die Größe des Steuerelements ändern) können Sie diese Titel auslassen.
Mit der Eigenschaft KeyOptions könne Sie steuern, ob der Anwender die Namensspalte bearbeiten kann. KeyOptions enthält separate Optionen, um das Bearbeiten, Hinzufügen von neuen Namen und Löschen von Namen zuzulassen und um festzulegen, ob neue Namen eindeutig sein müssen.
Mit der Eigenschaft ItemProps können Sie festlegen, wie Anwender die Einträge in der Wertespalte bearbeiten. Jedes Elemente hat ein eigenes TItemProp-Objekt, mit dem Sie
- eine Bearbeitungsmaske angeben können, um die gültige Eingabe zu beschränken;
- eine Maximallänge für Werte angeben können;
- die Werte als schreibgeschützt definieren können;
- Geben Sie an, dass der Wertelisteneditor einen Dropdown-Pfeil anzeigt, der entweder eine Auswahlliste mit Werten öffnet, aus denen der Anwender auswählen kann, oder eine Ellipsen-Schaltfläche, die ein Ereignis auslöst, mit dem Sie ein Dialogfeld anzeigen können, in das der Anwender Werte eingeben kann.
Wenn Sie festlegen, dass es keinen Dropdown-Pfeil gibt, müssen Sie eine Werteliste angeben, aus der der Anwender auswählen kann. Dabei kann es sich um eine statische Liste handeln (die PickList-Eigenschaft des TItemProp-Objekts), oder die Werte können mit dem OnGetPickList-Ereignis des Wertelisteneditors zur Laufzeit dynamisch hinzugefügt werden. Sie können diese Verfahren auch kombinieren und eine statische Liste verwenden, die durch die Behandlungsroutine des Ereignisses OnGetPickList modifiziert wird.
Wenn Sie festlegen, dass es eine Ellipsenschaltfläche gibt, müssen Sie angeben, was geschieht, wenn der Anwender die Schaltfläche anklickt (einschließlich der Definition eines Wertes, falls erforderlich). Sie geben diese Reaktion an, indem Sie eine Behandlungsroutine für das Ereignis OnEditButtonClick schreiben.