Freigeben über


Wert-Steuerelementmuster

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, die über einen systeminternen Wert verfügen, der 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 ihre unterstützten 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 ein 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.

    Abbildung mit bearbeitbarem Listenelement

  • Ein- und mehrzeilige Bearbeitungssteuerelemente müssen ITextProvider implementieren, um ihre schreibgeschützten Inhalte verfügbar zu machen.

  • Mehrzeilige Bearbeitungssteuerelemente müssen IValueProvider implementieren, wenn ihr Inhalt geändert werden kann.

  • IValueProvider unterstützt das Abrufen von Formatierungsinformationen oder Teilzeichenfolgenwerten nicht. Implementieren Sie ITextProvider in diesen Szenarien.

  • IValueProvider muss durch Steuerelemente wie das Farbauswahlsteuerelement von 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 der Farbfeldzeichenfolgenzuordnung

  • Für ein Steuerelement sollte seine IsEnabled-Eigenschaft auf TRUE und seine ITextProvider::IsReadOnly-Eigenschaft auf FALSE festgelegt sein, bevor ein Aufruf von ITextProvider::SetValue zugelassen 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 ihre unterstützten Steuerelementmuster

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierungs-Struktur

Text- und TextRange-Steuerelementmuster