Freigeben über

Implementieren des Value-Steuerelementmusters der Benutzeroberflächenautomatisierung

Hinweis

Diese Dokumentation richtet sich an .NET Framework-Entwickler, die die verwalteten Benutzeroberflächenautomatisierungs-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind. Die neuesten Informationen zur Benutzeroberflächenautomatisierung finden Sie unter Windows Automation API: Benutzeroberflächenautomatisierung.

In diesem Thema werden Richtlinien und Konventionen für die Implementierung IValueProvidervorgestellt, einschließlich Informationen zu Ereignissen und Eigenschaften. Links zu zusätzlichen Verweisen werden am Ende des Themas aufgeführt.

Das ValuePattern Steuerelementmuster wird verwendet, um Steuerelemente zu unterstützen, die einen systeminternen Wert haben, der keinen Bereich überspannt und die als Zeichenfolge dargestellt werden kann. Diese Zeichenfolge kann je nach Steuerelement und den zugehörigen Einstellungen bearbeitet werden. Beispiele für Steuerelemente, die dieses Muster implementieren, finden Sie unter Steuerelementmusterzuordnung für Benutzeroberflächenautomatisierungs-Clients.

Implementierungsrichtlinien und -konventionen

Beachten Sie bei der Implementierung des Wertsteuerungsmusters die folgenden Richtlinien und Konventionen:

  • Steuerelemente wie ListItem und TreeItem müssen ValuePattern unterstützen, wenn der Wert eines der Elemente bearbeitbar ist, unabhängig vom aktuellen Bearbeitungsmodus des Steuerelements. Das übergeordnete Steuerelement muss außerdem ValuePattern unterstützen, wenn die untergeordneten Elemente bearbeitbar sind.

Bearbeitbares Listenelement. Beispiel für ein bearbeitbares Listenelement

  • Einzeilige Bearbeitungssteuerelemente unterstützen den programmgesteuerten Zugriff auf ihre Inhalte durch die Implementierung von IValueProvider. Mehrzeilige Bearbeitungssteuerelemente implementieren IValueProviderjedoch nicht; stattdessen ermöglichen sie den Zugriff auf ihre Inhalte, indem sie implementieren ITextProvider.

  • Um den Textinhalt eines mehrzeiligen Bearbeitungssteuerelements abzurufen, muss das Steuerelement ITextProvider implementieren. ITextProvider Das Festlegen des Werts eines Steuerelements wird jedoch nicht unterstützt.

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

  • IValueProvider muss von Steuerelementen wie dem Auswahlsteuerelement "Farbauswahl " aus Microsoft Word (unten dargestellt) implementiert werden, das die Zeichenfolgenzuordnung zwischen einem Farbwert (z. B. "gelb") und einer entsprechenden internen RGB-Struktur unterstützt.

Farbwähler mit Hervorhebung von Gelb. Beispiel für eine Zuordnung zwischen Farbmustern und Zeichenfolgen

Erforderliche Mitglieder für IValueProvider

Die folgenden Eigenschaften und Methoden sind für die Implementierung IValueProvidererforderlich.

Erforderliche Mitglieder Elementtyp Hinweise
IsReadOnlyProperty Eigentum Nichts
ValueProperty Eigentum Nichts
SetValue Methode Nichts

Ausnahmen

Anbieter müssen die folgenden Ausnahmen auslösen.

Ausnahmetyp Zustand
InvalidOperationException SetValue

- Wenn gebietsschemaspezifische Informationen an ein Steuerelement in einem falschen Format übergeben werden, z. B. ein falsch formatiertes Datum.
ArgumentException SetValue

- Wenn ein neuer Wert nicht aus einer Zeichenfolge in ein Format konvertiert werden kann, das das Steuerelement erkennt.
ElementNotEnabledException SetValue

– Wenn versucht wird, ein Steuerelement zu bearbeiten, das nicht aktiviert ist.

Siehe auch

  • Last updated on