Wertsteuerelementmuster

Beschreibt Richtlinien und Konventionen für die Implementierung von IValueProvider-, einschließlich Informationen zu Eigenschaften und Methoden. Das Wert- Steuerelementmusters wird verwendet, um Steuerelemente zu unterstützen, die einen systeminternen Wert aufweisen, der keinen Bereich überspannt und die als Zeichenfolge dargestellt werden kann.

Die Wertzeichenfolge kann je nach Steuerelement und den zugehörigen Einstellungen bearbeitbar sein. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementtypen und deren unterstützte Steuerelementmuster.

Dieses Thema enthält die folgenden Abschnitte.

• Implementierungsrichtlinien und -konventionen
• Erforderliche Member für IValueProvider-
• Verwandte Themen

Implementierungsrichtlinien und -konventionen

Beachten Sie bei der Implementierung des Wert- 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 bearbeitbar ist, unabhängig vom aktuellen Bearbeitungsmodus des Steuerelements. Das übergeordnete Steuerelement muss auch das Wert- Steuerelementmuster unterstützen, wenn die untergeordneten Elemente bearbeitbar sind. Die folgende Abbildung zeigt ein Beispiel für ein bearbeitbares Listenelement.

  

• Einzelne und mehrzeilige Bearbeitungssteuerelemente müssen ITextProvider- implementieren, um ihre schreibgeschützten Inhalte 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- müssen von Steuerelementen wie dem Farbauswahl-Auswahlsteuerelement 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.

  

• Ein Steuerelement sollte seine IsEnabled-eigenschaft auf TRUE und dessen ITextProvider::IsReadOnly-Eigenschaft auf FALSE- festgelegt haben, bevor ein Aufruf ITextProvider::SetValuezugelassen wird.

Erforderliche Elemente für IValueProvider-

Die folgenden Eigenschaften und Methoden sind für die Implementierung der IValueProvider Schnittstelle erforderlich.

Dieses Steuerelementmuster hat keine zugehörigen Ereignisse.

Verwandte Themen

Steuerelementtypen und deren unterstützte Steuerelementmuster

Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung

übersicht über Benutzeroberflächenautomatisierungsstruktur

Text- und TextRange-Steuerelementmuster