Freigeben über

Steuerelementtyp bearbeiten

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den steuerelementtyp Bearbeiten.

Mit Bearbeitungssteuerelementen kann ein Benutzer eine einfache Textzeile ohne umfassende Formatierungsunterstützung anzeigen und bearbeiten.

In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Bearbeitungssteuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Bearbeitungssteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Benutzeroberflächenautomatisierungsunterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält die folgenden Abschnitte.

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Bearbeitungssteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.

Steuerelementansicht Inhaltsansicht
  • Redigieren
  • Redigieren

 

Die Steuerelemente, die den Steuerelementtyp Bearbeiten Steuerelement implementieren, verfügen immer über null Bildlaufleisten in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur, da es sich um ein einzeiliges Steuerelement handelt. Die einzelne Textzeile kann in einigen Layoutszenarien umbrochen werden. Der Steuerelementtyp "Bearbeiten" ist nur für kleine Textmengen vorgesehen.

Relevante Eigenschaften

In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für die Bearbeitungssteuerelemente relevant ist. Weitere Informationen zu Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus benutzeroberflächenautomatisierungs-Elementen.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss zwischen allen Peerelementen in der unformatierten Ansicht der Benutzeroberflächenautomatisierungs-Struktur eindeutig sein.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußerste Rechteck, das das gesamte Steuerelement enthält.
UIA_ClickablePointPropertyId Siehe Hinweise. Das Bearbeitungssteuerelement muss über einen klickbaren Punkt verfügen, der dem Bearbeitungsbereich des Steuerelements den Eingabefokus verleiht, wenn ein Benutzer dort auf die Maus klickt.
UIA_ControlTypePropertyId bearbeiten
UIA_IsContentElementPropertyId TRUE- Das Bearbeitungssteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsControlElementPropertyId TRUE- Das Bearbeitungssteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsKeyboardFocusablePropertyId Siehe Hinweise. Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
UIA_IsPasswordPropertyId Siehe Hinweise. Muss auf TRUE- für Bearbeitungssteuerelemente festgelegt sein, die Kennwörter enthalten. Wenn ein Bearbeitungssteuerelement Kennwortinhalte enthält, kann diese Eigenschaft von einer Sprachausgabe verwendet werden, um zu bestimmen, ob Tastaturanschläge gelesen werden sollen, während der Benutzer sie eingibt.
UIA_LabeledByPropertyId Siehe Hinweise. Wenn dem Steuerelement eine statische Textbeschriftung zugeordnet ist, muss diese Eigenschaft einen Verweis auf dieses Steuerelement verfügbar machen. Wenn das Textsteuerelement ein Unterkomponente eines anderen Steuerelements ist, verfügt es nicht über einen LabeledBy-Eigenschaftssatz.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem Steuerelementtyp Bearbeiten entspricht. Der Standardwert ist "edit" für en-US oder Englisch (USA).
UIA_NamePropertyId Siehe Hinweise. Der Name des Bearbeitungssteuerelements wird in der Regel aus einer statischen Textbeschriftung generiert. Wenn keine statische Textbeschriftung vorhanden ist, muss dem Anwendungsentwickler ein Eigenschaftswert für Name zugewiesen werden. Die eigenschaft Name sollte niemals den Textinhalt des Bearbeitungssteuerelements enthalten.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von Bearbeitungssteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.

Control Pattern/Pattern-Eigenschaft Support/Wert Notizen
IRangeValueProvider- Hängt Alle Bearbeitungssteuerelemente, die einen numerischen Bereich übernehmen, müssen das RangeValue- Steuerelementmuster verfügbar machen.
Mindest- Siehe Hinweise. Diese Eigenschaft muss der kleinste Wert sein, auf den der Inhalt des Bearbeitungssteuerelements festgelegt werden kann.
Maximale 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, auf die der Wert festgelegt werden kann. Wenn das Bearbeitungssteuerelement nur ganze Zahlen verwendet, muss der SmallChange Eigenschaftswert 1 sein. Wenn das Bearbeitungssteuerelement einen Bereich von 1,0 bis 2,0 akzeptiert, muss der wert der SmallChange-Eigenschaftswert 0,1 sein. Wenn das Bearbeitungssteuerelement einen Bereich von 1,00 bis 2,00 akzeptiert, muss der wert der SmallChange Eigenschaftswert 0,001 sein.
LargeChange- NULL- Diese Eigenschaft muss für ein Bearbeitungssteuerelement nicht verfügbar gemacht werden.
Wert Siehe Hinweise. Diese Eigenschaft gibt den numerischen Inhalt des Bearbeitungssteuerelements an. Wenn ein präziserer Wert von einem Benutzeroberflächenautomatisierungs-Client innerhalb der bereiche festgelegt wird, die im Minimum und Maximum Eigenschaften angegeben sind, wird die eigenschaft Value automatisch auf den nächstgelegenen akzeptierten Wert gerundet.
ITextProvider- Erforderlich Alle Bearbeitungssteuerelemente müssen das Text Steuerelementmusters unterstützen, da detaillierte Informationen immer für Hilfstechnologieclients verfügbar sein müssen.
IValueProvider- Hängt Alle Bearbeitungssteuerelemente, die eine Zeichenfolge übernehmen, müssen das Wert- Steuerelementmuster verfügbar machen.
IsReadOnly- Siehe Hinweise. Diese Eigenschaft muss festgelegt werden, um anzugeben, ob das Steuerelement programmgesteuert einen Wert festlegen kann oder die vom Benutzer bearbeitet werden kann.
Wert Siehe Hinweise. Diese Eigenschaft enthält den Textinhalt des Bearbeitungssteuerelements. Wenn die UIA_IsPasswordPropertyId-Eigenschaft auf TRUEfestgelegt ist, muss beim Abfragen der Value-Eigenschaft ein Fehler zurückgegeben werden.

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die Steuerelemente bearbeiten müssen, um sie zu unterstützen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.

Benutzeroberflächenautomatisierungs-Ereignis Notizen
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis.
UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled--Eigenschaft unterstützt, muss dieses Ereignis unterstützt werden.
UIA_IsOffscreenPropertyId Ereignis mit Eigenschaftsänderung. Wenn das Steuerelement die IsOffscreen--Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_NamePropertyId Eigenschaftsänderungsereignis.
UIA_RangeValueValuePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das RangeValue- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontallyScrollablePropertyId Eigenschaftsänderungsereignis. Ein Bearbeitungssteuerelement unterstützt nie das Bildlauf- Steuerelementmusters.
UIA_ScrollHorizontalScrollPercentPropertyId Eigenschaftsänderungsereignis. Ein Bearbeitungssteuerelement unterstützt nie das Bildlauf- Steuerelementmusters.
UIA_ScrollHorizontalViewSizePropertyId Eigenschaftsänderungsereignis. Ein Bearbeitungssteuerelement unterstützt nie das Bildlauf- Steuerelementmusters.
UIA_ScrollVerticallyScrollablePropertyId Eigenschaftsänderungsereignis. Ein Bearbeitungssteuerelement unterstützt nie das Bildlauf- Steuerelementmusters.
UIA_ScrollVerticalScrollPercentPropertyId Eigenschaftsänderungsereignis. Ein Bearbeitungssteuerelement unterstützt nie das Bildlauf- Steuerelementmusters.
UIA_ScrollVerticalViewSizePropertyId Eigenschaftsänderungsereignis. Ein Bearbeitungssteuerelement unterstützt nie das Bildlauf- Steuerelementmusters.
UIA_StructureChangedEventId
UIA_Text_TextChangedEventId Wenn das Steuerelement das Text- Steuerelementmusters unterstützt, muss es dieses Ereignis unterstützen.
UIA_Text_TextSelectionChangedEventId Wenn das Steuerelement das Text- Steuerelementmusters unterstützt, muss es dieses Ereignis unterstützen.
UIA_ValueValuePropertyId Eigenschaftsänderungsereignis . Wenn das Steuerelement das Wert- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

 

Bemerkungen

Ein Bearbeitungssteuerelement kann als schreibgeschütztes Textfeld verwendet werden, das die Auswahl oder Bearbeitung von Text nicht unterstützt. Ein solches Bearbeitungssteuerelement verhält sich als Feldobjekt mit einem bestimmten Namen und Wert.

Wenn ein Bearbeitungssteuerelement Platzhaltertext enthält (z. B. ein Hinweisbanner), sollte der Text als HelpText- Eigenschaft verwendet werden, es sei denn, der Text kann vom Benutzer bearbeitet und dann als Platzhaltertext wiederverwendet werden. Die Adressleiste von Windows Internet Explorer enthält beispielsweise den Text "about:Tabs", wenn eine neue Registerkarte geöffnet wird. Dies ist nicht HelpText-, da es sich um eine programmgesteuerte Adresse handelt, die vom Benutzer verwendet oder bearbeitet werden kann.

Konzeptionelle

Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung