Freigeben über


Benutzeroberflächenautomatisierung-Unterstützung für den TitleBar-Steuerelementtyp

HinweisHinweis

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.

Dieses Thema enthält Informationen über die UI Automation-Unterstützung für den TitleBar-Steuerelementtyp. Bei der UI Automation 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 Automation-Struktur, UI Automation-Eigenschaftswerte und Steuerelementmuster ein.

TitleBar-Steuerelemente stellen Titel oder Beschriftungsleisten in einem Fenster dar.

In den folgenden Abschnitten werden die UI Automation-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den TitleBar-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle TitleBar-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 Automation-Struktur, die sich auf TitleBar-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht

Inhaltsansicht

TitleBar

  • Menu (0 oder 1)

  • Button (0 oder mehr)

Nicht zutreffend. (Das TitleBar-Steuerelement enthält keinen Inhalt.)

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

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

UI Automation-Eigenschaft

Wert

Hinweise

AutomationIdProperty

Siehe Hinweise.

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

BoundingRectangleProperty

Siehe Hinweise.

Das umschließende Rechteck einer Titelleiste muss alle darin enthaltenen Steuerelemente vollständig einschließen.

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 einen speziellen Treffertest ausführen, überschreiben Sie diese Eigenschaft, und geben Sie einen durch Klicken aktivierbaren Punkt an.

IsKeyboardFocusableProperty

False

Titelleisten erhalten nie den Tastaturfokus.

NameProperty

""

Die Titelleiste ist kein Inhalt. Ihre Textinformationen werden auf dem übergeordneten Fenster verfügbar gemacht.

LabeledByProperty

Siehe Hinweise.

Das TitleBar-Steuerelement weist in der Regel keine Bezeichnung auf.

ControlTypeProperty

TitleBar

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

LocalizedControlTypeProperty

"title bar"

Lokalisierte Zeichenfolge, die dem TitleBar-Steuerelementtyp entspricht.

IsContentElementProperty

False

Das TitleBar-Steuerelement ist nie ein Inhaltselement.

IsControlElementProperty

True

Das TitleBar-Steuerelement muss stets ein Steuerelement sein.

IsOffscreenProperty

Variabel

Dieses Steuerelement gibt einen Wert abhängig davon zurück, ob die Titelleiste auf dem Bildschirm sichtbar ist.

HelpTextProperty

""

Es ist nicht erforderlich, Hilfetext verfügbar zu machen.

AcceleratorKeyProperty

""

Titelleisten haben niemals Tastenkombinationen.

AccessKeyProperty

""

Das TitleBar-Steuerelement verfügt nicht über eine Zugriffstaste.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

Der TitleBar-Steuerelementtyp ist nicht erforderlich, um Steuerelementmuster zu unterstützen. Seine Funktionalität wird durch das Window-Steuerelementmuster für das Window-Steuerelement verfügbar gemacht.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

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

UI Automation-Ereignis

Unterstützung

Hinweise

Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis

Nie

Keine

AutomationFocusChangedEvent

Nie

Keine

StructureChangedEvent

Erforderlich

Keine

Siehe auch

Referenz

TitleBar

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung