Benutzeroberflächenautomatisierungs-Unterstützung für den Edit-Steuerelementtyp
Hinweis
Diese Dokumentation ist für .NET Framework-Entwickler konzipiert, die die verwalteten Klassen zur Automatisierung der Benutzeroberfläche verwenden möchten, die im Namespace System.Windows.Automation definiert sind. Aktuelle Informationen zur Automatisierung der Benutzeroberfläche finden Sie auf der Seite zur Windows-Automatisierungs-API: Benutzeroberflächenautomatisierung.
Dieser Artikel enthält Informationen zur Unterstützung der Benutzeroberflächenautomatisierung für den Steuerelementtyp „Edit“. Bei der Benutzeroberflächenautomatisierung entspricht ein Steuerelementtyp einer Reihe von Bedingungen, die ein Steuerelement erfüllen muss, um die ControlTypeProperty-Eigenschaft verwendet zu können. Zu den Bedingungen gehören spezifische Richtlinien für die Struktur der Benutzeroberflächenautomatisierung, Eigenschaftswerte der Benutzeroberflächenautomatisierung und Steuerelementmuster.
Mit einem Bearbeitungssteuerelement kann ein Benutzer eine einfache Textzeile ohne umfangreiche Formatierungsunterstützung anzeigen und bearbeiten
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierung, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp „Edit“ definiert. Die Anforderungen für die Benutzeroberflächenautomatisierung gelten für alle Bearbeitungssteuerelemente, unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms verwendet wird.
Erforderliche Benutzeroberflächenautomatisierungs-Struktur
In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung für Bearbeitungssteuerelemente sowie die möglichen Inhalte der Ansichten beschrieben. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
| Bearbeiten | Bearbeiten |
Die Steuerelemente, die den Steuerelementtyp „Edit“ implementieren, enthalten keine Scrollleisten in der Steuerelementansicht der Struktur der Benutzeroberflächenautomatisierung, da es sich um ein einzeiliges Steuerelement handelt. Die einzelne Textzeile wird in einigen Layoutszenarien möglicherweise umgebrochen. Der Edit-Steuerelementtyp eignet sich optimal für kleine Mengen von bearbeitbarem oder auswählbarem Text.
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
Die folgende Tabelle enthält die Eigenschaften der Benutzeroberflächenautomatisierung, deren Werte oder Definitionen für Bearbeitungssteuerelemente besonders relevant sind. Weitere Informationen zu den Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Hinweise |
|---|---|---|
| AutomationIdProperty | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Steuerelemente in einer Anwendung eindeutig sein. |
| BoundingRectangleProperty | Siehe Hinweise. | Das äußere Rechteck, das das gesamte Steuerelement enthält. |
| ClickablePointProperty | Siehe Hinweise. | Das Bearbeitungssteuerelement muss über einen durch Klicken aktivierbaren Punkt verfügen, der den Eingabefokus an den Bearbeitungsbereich des Steuerelements übergibt, wenn ein Benutzer dort mit der Maus klickt. |
| IsKeyboardFocusableProperty | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| NameProperty | Siehe Hinweise. | Der Name des Bearbeitungssteuerelements wird üblicherweise aus einer statischen Textbezeichnung generiert. Ist keine statische Textbezeichnung vorhanden, muss der Anwendungsentwickler einen Eigenschaftswert für Name zuweisen. Die Name -Eigenschaft darf niemals den Textinhalt des Bearbeitungssteuerelements enthalten. |
| LabeledByProperty | Siehe Hinweise. | Wenn dem Steuerelement eine statische Textbezeichnung zugewiesen ist, muss diese Eigenschaft einen Verweis auf dieses Steuerelement verfügbar machen. Ist das Textsteuerelement eine Unterkomponente eines anderen Steuerelements, ist für das Textsteuerelement keine LabeledBy -Eigenschaft festgelegt. |
| ControlTypeProperty | Bearbeiten | Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
| LocalizedControlTypeProperty | „Bearbeiten“ | Lokalisierte Zeichenfolge für den Steuerelementtyp „Edit“. |
| IsContentElementProperty | True | Das Bearbeitungssteuerelement ist in der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung immer enthalten. |
| IsControlElementProperty | True | Das Bearbeitungssteuerelement ist in der Steuerelementansicht der Struktur der Benutzeroberflächenautomatisierung immer enthalten. |
| IsPasswordProperty | Siehe Hinweise. | Muss für Bearbeitungssteuerelemente auf „true“ festgelegt werden, die Kennwörter enthalten. Wenn ein Bearbeitungssteuerelement Kennwörter enthält, kann diese Eigenschaft von einer Sprachausgabe verwendet werden, um zu ermitteln, ob Tastatureingaben bei der Eingabe durch den Benutzer vorgelesen werden sollen. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster und -Eigenschaften
In der folgenden Tabelle werden die Steuerelementmuster aufgelistet, die von allen Bearbeitungssteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster/Steuerelementmustereigenschaft | Unterstützung/Wert | Hinweise |
|---|---|---|
| ITextProvider | Depends (Abhängig) | Bearbeitungssteuerelemente sollten das Text-Steuerelementmuster unterstützen, da ausführliche Textinformationen für Clients immer verfügbar sein sollten. |
| IValueProvider | Depends (Abhängig) | Alle Bearbeitungssteuerelemente, die eine Zeichenfolge übernehmen, müssen das Value-Muster verfügbar machen. |
| IsReadOnly | Siehe Hinweise. | Diese Eigenschaft muss festgelegt werden, um anzugeben, ob für das Steuerelement ein Wert programmgesteuert festgelegt oder er vom Benutzer bearbeitet werden kann. |
| Value | Siehe Hinweise. | Diese Eigenschaft gibt den Textinhalt des Bearbeitungssteuerelements zurück. Wenn die IsPasswordProperty auf truefestgelegt ist, muss diese Eigenschaft auf Anforderung eine InvalidOperationException auslösen. |
| IRangeValueProvider | Depends (Abhängig) | Alle Bearbeitungssteuerelemente, die einen numerischen Bereich übernehmen, müssen das Steuerelementmuster „Range Value“ verfügbar machen. |
| Minimum | Siehe Hinweise. | Diese Eigenschaft muss der kleinste Wert sein, auf den der Inhalt des Bearbeitungssteuerelements festgelegt werden kann. |
| Maximum | Siehe Hinweise. | Diese Eigenschaft muss der größte Wert sein, auf den der Inhalt des Bearbeitungssteuerelements festgelegt werden kann. |
| SmallChange | Siehe Hinweise. | Diese Eigenschaft muss die Anzahl der Dezimalstellen angeben, die für den Wert festgelegt werden kann. Wenn das Bearbeitungssteuerelement nur ganze Zahlen annimmt, muss die SmallChangeProperty 1 sein. Wenn das Bearbeitungssteuerelement einen Bereich von 1,0 bis 2,0 annimmt, muss die SmallChangeProperty 0,1 sein. Wenn das Bearbeitungssteuerelement einen Bereich von 1,00 bis 2,00 annimmt, muss die SmallChangeProperty 0,001 sein. |
| LargeChange | Null |
Diese Eigenschaft muss auf einem Bearbeitungssteuerelement nicht verfügbar gemacht werden. |
| Value | Siehe Hinweise. | Diese Eigenschaft gibt die numerischen Inhalte des Bearbeitungssteuerelements an. Wenn durch einen Benutzeroberflächenautomatisierungs-Client innerhalb der Bereiche, die gemäß der Eigenschaften Minimum und Maximum angegeben sind, ein präziserer Wert festgelegt ist, wird die Value-Eigenschaft automatisch auf den nächsten zulässigen Wert gerundet. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabellen sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die von allen Bearbeitungssteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Support | Notizen |
|---|---|---|
| InvalidatedEvent | Erforderlich | Keine |
| TextSelectionChangedEvent | Erforderlich | Keine |
| TextChangedEvent | Erforderlich | Keine |
| Durch geänderteBoundingRectangleProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsOffscreenProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsEnabledProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteNameProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteValueProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| Durch geänderteHorizontallyScrollableProperty -Eigenschaft ausgelöstes Ereignis. | Nie | Keine |
| Durch geänderteHorizontalScrollPercentProperty -Eigenschaft ausgelöstes Ereignis. | Nie | Keine |
| Durch geänderteHorizontalViewSizeProperty -Eigenschaft ausgelöstes Ereignis. | Nie | Keine |
| Durch geänderteVerticalScrollPercentProperty -Eigenschaft ausgelöstes Ereignis. | Nie | Keine |
| Durch geänderteVerticallyScrollableProperty -Eigenschaft ausgelöstes Ereignis. | Nie | Keine |
| Durch geänderteVerticalViewSizeProperty -Eigenschaft ausgelöstes Ereignis. | Nie | Keine |
| Durch geänderteValueProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Wenn das Steuerelement das „Range Value“-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| AutomationFocusChangedEvent | Erforderlich | Keine |
| StructureChangedEvent | Erforderlich | Keine |