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

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.

    Abbildung mit bearbeitbarem 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.

    Abbildung zur Zuordnung von Farbwatchzeichenfolgen

  • 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.

Steuerelementtypen und deren unterstützte Steuerelementmuster

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierungs-Struktur

Text- und TextRange-Steuerelementmuster