Benutzeroberflächenautomatisierungs-Unterstützung für den Table-Steuerelementtyp

Aktualisiert: November 2007

Dieses Thema enthält Informationen über die UI-Automatisierung-Unterstützung für den Table-Steuerelementtyp. Bei der UI-Automatisierung umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen schließen bestimmte Richtlinien für UI-Automatisierung-Struktur, UI-Automatisierung-Eigenschaftenwerte und Steuerelementmuster ein.

Table-Steuerelemente enthalten Textzeilen und -spalten sowie optional Zeilen- und Spaltenheader.

In den folgenden Abschnitten werden die UI-Automatisierung-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Table-Steuerelementtyp erforderlich sind. Die UI-Automatisierung-Anforderungen gelten für alle Table-Steuerelemente aus Windows Presentation Foundation (WPF), Win32 oder Windows Forms.

Dieses Thema enthält folgende Abschnitte.

  • Erforderliche Benutzeroberflächenautomatisierungs-Struktur
  • Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
  • Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
  • Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
  • Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI-Automatisierung-Struktur für Table-Steuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI-Automatisierung-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht

Inhaltsansicht

  • Table

  • Header (0 oder 1)

  • Text (0 oder 1)

  • Table

  • Text (1 oder mehr)

Wenn ein Table-Steuerelement Zeilen- oder Spaltenheader besitzt, müssen sie in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur verfügbar gemacht werden. Die Inhaltsansicht muss diese Informationen nicht verfügbar machen, da mit dem TablePattern auf sie zugegriffen werden kann.

Beachten Sie, dass immer wenigstens ein Textelement in der Teilstruktur des Table-Elements vorhanden ist.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI-Automatisierung-Eigenschaften aufgelistet, deren Wert oder Definition für Table-Steuerelemente besonders relevant ist. Weitere Informationen über UI-Automatisierung-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI-Automatisierung-Eigenschaft

Wert

Hinweise

AutomationIdProperty()

Siehe Hinweise.

Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein.

BoundingRectangleProperty

Siehe Hinweise.

Das äußere Rechteck, welches das gesamte Steuerelement umfasst.

ClickablePointProperty

Siehe Hinweise.

Unterstützt, wenn ein umschließendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umschließenden Rechtecks durch Klicken aktiviert werden kann und Sie eine spezielle Trefferprüfung ausführen, setzen Sie diese Eigenschaft außer Kraft, und geben Sie einen durch Klicken aktivierbaren Punkt an.

IsKeyboardFocusableProperty

Siehe Hinweise.

Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.

NameProperty

Siehe Hinweise.

Das Table-Steuerelement ruft seinen Namen in der Regel aus einer statischen Textbezeichnung ab. Wenn keine statische Textbezeichnung vorhanden ist, müssen Sie eine Name-Eigenschaft zuweisen, die immer verfügbar sein muss, um den Zweck der Tabelle zu erläutern.

LabeledByProperty

Siehe Hinweise.

Wenn eine statische Textbezeichnung vorhanden ist, muss diese Eigenschaft einen Verweis auf das entsprechende Steuerelement verfügbar machen.

ControlTypeProperty

Table

Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.

LocalizedControlTypeProperty

"table"

Lokalisierte Zeichenfolge für den Table-Steuerelementtyp.

HelpTextProperty

""

Über diese Eigenschaft sollten weitere Details über den Zweck der Tabelle verfügbar gemacht werden, wenn er nicht durch Zugriff auf die NameProperty ausreichend erläutert wird.

IsContentElementProperty

True

Das Table-Steuerelement muss stets ein Inhaltselement sein.

IsControlElementProperty

True

Das Table-Steuerelement muss stets ein Steuerelement sein.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle werden die UI-Automatisierung-Steuerelementmuster aufgelistet, die von allen Table-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.

Steuerelementmuster/Mustereigenschaft

Unterstützung/Wert

Hinweise

IGridProvider

Ja

Das Table-Steuerelement unterstützt immer dieses Steuerelementmuster, da die enthaltenen Elemente über Daten verfügen, die in einem Raster dargestellt werden.

ITableProvider

Ja

Das Table-Steuerelement verfügt immer über die Fähigkeit, dem Inhalt zugeordnete Header zu haben.

ITableItemProvider

Variabel

Wenn das Textelement innerhalb eines Table-Steuerelements enthalten ist, muss dies unterstützt werden.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle sind die UI-Automatisierung-Ereignisse aufgelistet, die von allen Table-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI-Automatisierung-Ereignis

Unterstützung

Hinweise

Durch geänderte Eigenschaft ausgelöstes BoundingRectangleProperty-Ereignis.

Erforderlich

Keine

Durch geänderte Eigenschaft ausgelöstes IsOffscreenProperty-Ereignis.

Erforderlich

Keine

Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis.

Erforderlich

Keine

AutomationFocusChangedEvent

Erforderlich

Keine

StructureChangedEvent

Erforderlich

Keine

Siehe auch

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung

Referenz

Table