Implementieren des Value-Steuerelementmusters der Benutzeroberflächenautomatisierung

Artikel
08/10/2011

Hinweis
Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation.

In diesem Thema werden Richtlinien und Konventionen zum Implementieren von IValueProvider vorgestellt sowie Ereignisse und Eigenschaften erläutert. Am Ende des Themas finden Sie Links zu zusätzlichen Verweisen.

Das ValuePattern-Steuerelementmuster wird verwendet, um Steuerelemente mit einem systeminternen Wert zu unterstützen, der nicht abschnittsübergreifend ist und als Zeichenfolge dargestellt werden kann. Diese Zeichenfolge kann bearbeitbar sein, abhängig vom Steuerelement und dessen Einstellungen. Beispiele für Steuerelemente, von denen dieses Muster implementiert wird, finden Sie unter Zuordnen von Steuerelementmustern für Benutzeroberflächenautomatisierungs-Clients.

Dieses Thema enthält folgende Abschnitte.

Implementierungsrichtlinien und Konventionen
Erforderliche Member für IValueProvider
Ausnahmen
Verwandte Abschnitte

Implementierungsrichtlinien und Konventionen

Beachten Sie beim Implementieren des Value-Steuerelementmusters die folgenden Richtlinien und Konventionen:

Von Steuerelementen wie ListItem und TreeItem muss ValuePattern unterstützt werden, wenn der Wert von einem der Elemente bearbeitbar ist, unabhängig vom aktuellen Bearbeitungsmodus des Steuerelements. Das übergeordnete Steuerelement muss ebenfalls ValuePattern unterstützen, wenn die untergeordneten Elemente bearbeitbar sind.

Beispiel für ein bearbeitbares Listenelement

Bearbeitbares Listenelement

Einzeilige Bearbeitungssteuerelemente unterstützen den programmgesteuerten Zugriff auf ihren Inhalt durch Implementierung von IValueProvider. Mehrzeilige Bearbeitungssteuerelemente implementieren IValueProvider jedoch nicht, sondern stellen den Zugriff auf ihre Inhalte durch Implementieren von ITextProvider bereit.
Um den Textinhalt mehrzeiliger Bearbeitungssteuerelemente abrufen zu können, müssen die Steuerelemente ITextProvider implementieren. ITextProvider unterstützt das Festlegen des Werts für ein Steuerelement jedoch nicht.
Von IValueProvider wird das Abrufen von Formatierungsinformationen oder von Teilzeichenfolgen nicht unterstützt. Implementieren Sie in diesen Szenarien ITextProvider.
IValueProvider muss von Steuerelementen wie z. B. vom Auswahlsteuerelement Farbauswahl von Microsoft Word (unten dargestellt) implementiert werden. Hierdurch werden Zeichenfolgenzuordnungen zwischen einem Farbwert (beispielsweise "gelb") und der entsprechenden internen RGB-Struktur unterstützt.

Beispiel für eine Farbfeld-Zeichenfolgenzuordnung

Farbauswahl mit ausgewählter Farbe Gelb.

Bei einem Steuerelement sollte die IsEnabledProperty auf true und die IsReadOnlyProperty auf false festgelegt sein, bevor ein Aufruf an den SetValue zulässig ist.

Erforderliche Member für IValueProvider

Zum Implementieren von IValueProvider werden die folgenden Eigenschaften und Methoden benötigt.

Erforderliche Member	Membertyp	Hinweise
IsReadOnlyProperty	Eigenschaft	Keine
ValueProperty	Eigenschaft	Keine
SetValue	Methode	Keine

Ausnahmen

Anbieter müssen die folgenden Ausnahmen auslösen.

Ausnahmetyp	Bedingung
InvalidOperationException	SetValue Wenn gebietsschemaspezifische Informationen in einem falschen Format an ein Steuerelement übergeben werden, z. B. mit einem falsch formatierten Datum.
ArgumentException	SetValue Wenn ein neuer Wert nicht aus einer Zeichenfolge in ein Format konvertiert werden kann, das vom Steuerelement erkannt wird.
ElementNotEnabledException	SetValue Wenn versucht wird, ein nicht aktiviertes Steuerelement zu bearbeiten.

InvalidOperationException

SetValue

Wenn gebietsschemaspezifische Informationen in einem falschen Format an ein Steuerelement übergeben werden, z. B. mit einem falsch formatierten Datum.

ArgumentException

SetValue