Steuerelementtyp bearbeiten

Dieses Thema enthält Informationen zu Microsoft Benutzeroberflächenautomatisierung Unterstützung für den Steuerelementtyp Bearbeiten.

Mit einem Bearbeitungssteuerelement kann ein Benutzer eine einfache Textzeile ohne umfangreiche Formatierungsunterstützung anzeigen und bearbeiten

In den folgenden Abschnitten werden die Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp "Bearbeiten" definiert. Die Benutzeroberflächenautomatisierung gelten für alle Bearbeitungssteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Strukturstruktur

Die folgende Tabelle zeigt ein typisches Steuerelement und eine Inhaltsansicht der Benutzeroberflächenautomatisierung struktur, die sich auf Bearbeitungssteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Struktur Benutzeroberflächenautomatisierung Struktur finden Sie unter Benutzeroberflächenautomatisierung Strukturübersicht.

Steuerelementansicht Inhaltsansicht
  • Bearbeiten
  • Bearbeiten

Die Steuerelemente, die den Steuerelementtyp Bearbeiten implementieren, verfügen in der Steuerelementansicht der Benutzeroberflächenautomatisierung immer über keine Bildlaufleisten, da es sich um ein einzeilenbasiertes Steuerelement handelt. Die einzelne Textzeile wird in einigen Layoutszenarien möglicherweise umgebrochen. Der Steuerelementtyp Bearbeiten ist nur für kleine Textmengen gedacht.

Relevante Eigenschaften

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

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA _ AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der rohen Ansicht der Benutzeroberflächenautomatisierung sein.
UIA _ BoundingRectanglePropertyId Siehe Hinweise. Das äußere Rechteck, das das gesamte Steuerelement enthält.
UIA _ ClickablePointPropertyId 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.
UIA _ ControlTypePropertyId Bearbeiten
UIA _ IsContentElementPropertyId TRUE Das Bearbeitungssteuer steuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung enthalten.
UIA _ IsControlElementPropertyId TRUE Das Bearbeitungssteuer steuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung enthalten.
UIA _ IsKeyboardFocusablePropertyId Siehe Hinweise. Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
UIA _ IsPasswordPropertyId Siehe Hinweise. Muss für Bearbeitungssteuerelemente, die Kennwörter enthalten, auf TRUE festgelegt werden. 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.
UIA _ LabeledByPropertyId Siehe Hinweise. Wenn dem Steuerelement eine statische Textbezeichnung zugeordnet ist, muss diese Eigenschaft einen Verweis auf dieses Steuerelement verfügbar machen. Wenn das Textsteuerfeld eine Unterkomponenten eines anderen Steuerelements ist, ist keine LabeledBy-Eigenschaft festgelegt.
UIA _ LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem Steuerelementtyp Bearbeiten entspricht. Der Standardwert ist "bearbeiten" für en-US oder Englisch (USA).
UIA _ NamePropertyId Siehe Hinweise. Der Name des Bearbeitungssteuerelements wird üblicherweise aus einer statischen Textbezeichnung generiert. Wenn es keine statische Textbezeichnung gibt, muss der Anwendungsentwickler einen Eigenschaftswert für Name zuweisen. Die Name-Eigenschaft sollte nie den Textinhalt des Bearbeitungssteuerfelds enthalten.

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung aufgeführt, die von Bearbeitungssteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Steuerelementmuster/Mustereigenschaft Unterstützung/Wert Notizen
IRangeValueProvider Depends (Abhängig) Alle Bearbeitungssteuerelemente, die einen numerischen Bereich verwenden, müssen das RangeValue-Steuerelementmuster verfügbar machen.
Minimum Siehe Hinweise. Diese Eigenschaft muss der kleinste Wert sein, auf den der Inhalt des Bearbeitungssteuer steuerelements festgelegt werden kann.
Maximum Siehe Hinweise. Diese Eigenschaft muss der größte Wert sein, auf den der Inhalt des Bearbeitungssteuer steuerelements festgelegt werden kann.
Smallchange Siehe Hinweise. Diese Eigenschaft muss die Anzahl der Dezimalstellen angeben, die für den Wert festgelegt werden kann. Wenn das Bearbeitungssteuerzeichen nur ganze Zahlen angibt, muss der SmallChange-Eigenschaftswert 1 sein. Wenn das Bearbeitungssteuerprogramm einen Bereich von 1,0 bis 2,0 an nimmt, muss der SmallChange-Eigenschaftswert 0,1 sein. Wenn das Bearbeitungssteuerprogramm einen Bereich von 1,00 bis 2,00 an nimmt, muss der SmallChange-Eigenschaftswert 0,001 sein.
Largechange NULL Diese Eigenschaft muss auf einem Bearbeitungssteuerelement nicht verfügbar gemacht werden.
Wert Siehe Hinweise. Diese Eigenschaft gibt den numerischen Inhalt des Bearbeitungssteuer steuerelements an. Wenn ein genauerer Wert von einem Benutzeroberflächenautomatisierung-Client innerhalb der in den Eigenschaften Minimum und Maximum angegebenen Bereiche festgelegt wird, wird die Value-Eigenschaft automatisch auf den nächstgelegenen akzeptierten Wert gerundet.
ITextProvider Erforderlich Alle Bearbeitungssteuerelemente müssen das Text-Steuerelementmuster unterstützen, da ausführliche Informationen immer für Hilfstechnologieclients verfügbar sein müssen.
IValueProvider Depends (Abhängig) Alle Bearbeitungssteuerelemente, die eine Zeichenfolge verwenden, müssen das Value-Steuerelementmuster verfügbar machen.
IsReadOnly Siehe Hinweise. Diese Eigenschaft muss festgelegt werden, um anzugeben, ob für das Steuerelement programmgesteuert ein Wert festgelegt werden kann oder ob er vom Benutzer bearbeitet werden kann.
Wert Siehe Hinweise. Diese Eigenschaft enthält den Textinhalt des Bearbeitungssteuerfelds. Wenn die _ UIA-Eigenschaft IsPasswordPropertyId auf TRUE festgelegt ist, muss beim Abfragen der Value-Eigenschaft ein Fehler zurückgegeben werden.

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung aufgeführt, die von Bearbeitungssteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Benutzeroberflächenautomatisierung-Ereignis Notizen
UIA _ AutomationFocusChangedEventId
UIA _ BoundingRectanglePropertyId-Eigenschaftsänderungsereignis.
UIA _ IsEnabledPropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA _ IsOffscreenPropertyId-Eigenschaftsänderungsereignis. 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 Bearbeitungssteuerfeld unterstützt nie das Bildlauf-Steuerelementmuster.
UIA _ ScrollHorizontalScrollPercentPropertyId-Eigenschaftsänderungsereignis. Ein Bearbeitungssteuerfeld unterstützt nie das Bildlauf-Steuerelementmuster.
UIA _ ScrollHorizontalViewSizePropertyId-Eigenschaftsänderungsereignis. Ein Bearbeitungssteuerfeld unterstützt nie das Bildlauf-Steuerelementmuster.
UIA _ ScrollVerticallyScrollablePropertyId-Eigenschaftsänderungsereignis. Ein Bearbeitungssteuerfeld unterstützt nie das Bildlauf-Steuerelementmuster.
UIA _ ScrollVerticalScrollPercentPropertyId-Eigenschaftsänderungsereignis. Ein Bearbeitungssteuerfeld unterstützt nie das Bildlauf-Steuerelementmuster.
UIA _ ScrollVerticalViewSizePropertyId-Eigenschaftsänderungsereignis. Ein Bearbeitungssteuerfeld unterstützt nie das Bildlauf-Steuerelementmuster.
UIA _ StructureChangedEventId
UIA _ Text _ TextChangedEventId Wenn das Steuerelement das Text-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ Text _ TextSelectionChangedEventId Wenn das Steuerelement das Text-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ Das Durch die ValueValuePropertyId-Eigenschaft geänderte Ereignis . Wenn das Steuerelement das Value-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

Bemerkungen

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

Wenn ein Bearbeitungssteuerfeld Platzhaltertext enthält (z. B. ein Cue-Banner), 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 Windows Internet Explorer enthält z. B. 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.

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung