Wertsteuerelementmuster
Beschreibt Richtlinien und Konventionen für die Implementierung von IValueProvider,einschließlich Informationen zu Eigenschaften und Methoden. Das Wert-Steuerelementmuster wird verwendet, um Steuerelemente zu unterstützen, deren systeminterner Wert sich nicht über einen Bereich erstreckt und als Zeichenfolge dargestellt werden kann.
Die Wertzeichenfolge kann abhängig vom Steuerelement und seinen Einstellungen bearbeitet werden. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementtypen und deren unterstützte Steuerelementmuster.
Dieses Thema enthält folgende Abschnitte:
- Implementierungsrichtlinien und -konventionen
- Erforderliche Member für IValueProvider
- Zugehörige Themen
Implementierungsrichtlinien und -konventionen
Beachten Sie beim Implementieren des Value-Steuerelementmusters die folgenden Richtlinien und Konventionen:
Steuerelemente wie ein Listenelement oder Strukturelement müssen das Wert-Steuerelementmuster unterstützen, wenn der Wert eines der Elemente unabhängig vom aktuellen Bearbeitungsmodus des Steuerelements bearbeitet werden kann. Das übergeordnete Steuerelement muss auch das Value-Steuerelementmuster unterstützen, wenn die untergeordneten Elemente bearbeitet werden können. Die folgende Abbildung zeigt ein Beispiel für ein bearbeitbares Listenelement.

Ein- und mehrzeilige Bearbeitungssteuerelemente müssen ITextProvider implementieren, um ihren schreibgeschützten Inhalt verfügbar zu machen.
Mehrzeilige Bearbeitungssteuerelemente müssen IValueProvider implementieren, wenn ihre Inhalte geändert werden können.
IValueProvider unterstützt nicht das Abrufen von Formatierungsinformationen oder Teilzeichenfolgenwerten. Implementieren Sie ITextProvider in diesen Szenarien.
IValueProvider muss von Steuerelementen wie dem Steuerelement für die Farbauswahl aus Microsoft Word implementiert werden (siehe folgende Abbildung), das die Zeichenfolgenzuordnung zwischen einem Farbwert (z. B. "gelb") und einem entsprechenden internen RGB-Wert unterstützt.

Für ein Steuerelement muss die IsEnabled-Eigenschaft auf TRUE und die ITextProvider::IsReadOnly-Eigenschaft auf FALSE festgelegt sein, bevor ein Aufruf von ITextProvider::SetValuezugelassen wird.
Erforderliche Member für IValueProvider
Die folgenden Eigenschaften und Methoden sind für die Implementierung der IValueProvider-Schnittstelle erforderlich.
| Erforderliche Member | Memberart | Hinweise |
|---|---|---|
| IsReadOnly | Eigenschaft | Keine |
| Wert | Eigenschaft | Keine |
| SetValue | Methode | Keine |
Diesem Steuerelementmuster sind keine Ereignisse zugeordnet.