Freigeben über

Steuerelementtyp bearbeiten

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung des Steuerelementtyps Bearbeiten von Microsoft Benutzeroberflächenautomatisierung.

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

In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Bearbeitungssteuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen 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 Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf das Bearbeiten von Steuerelementen bezieht, und beschreibt, was in den einzelnen Ansichten enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.

Steuerelementansicht Inhaltsansicht
  • Bearbeiten
  • Bearbeiten

 

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

Relevante Eigenschaften

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

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der Rohansicht der Benutzeroberflächenautomatisierung Struktur eindeutig 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 Bearbeitungssteuerelement ist in der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung immer enthalten.
UIA_IsControlElementPropertyId TRUE Das Bearbeitungssteuerelement ist in der Steuerelementansicht der Struktur der Benutzeroberflächenautomatisierung immer 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 Textsteuerelement eine Unterkomponente 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 English (USA).
UIA_NamePropertyId Siehe Hinweise. Der Name des Bearbeitungssteuerelements wird üblicherweise aus einer statischen Textbezeichnung generiert. Wenn keine statische Textbeschriftung vorhanden ist, muss vom Anwendungsentwickler ein Eigenschaftswert für Name zugewiesen werden. Die Name-Eigenschaft sollte niemals den Textinhalt des Bearbeitungssteuerelements enthalten.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von Steuerelementen 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 annehmen, müssen das RangeValue-Steuerelementmuster 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 akzeptiert, muss der SmallChange-Eigenschaftswert 1 sein. Wenn das Bearbeitungssteuerelement einen Bereich von 1.0 bis 2.0 einnimmt, muss der SmallChange-Eigenschaftswert 0.1 sein. Wenn das Bearbeitungssteuerelement einen Bereich von 1,00 bis 2,00 aufweist, 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 Bearbeitungssteuerelements an. Wenn ein Benutzeroberflächenautomatisierung Client innerhalb der in den Eigenschaften Minimum und Maximum angegebenen Bereiche einen präziseren Wert festlegt, wird die Value-Eigenschaft automatisch auf den nächstgelegenen akzeptierten Wert gerundet.
ITextProvider Erforderlich Alle Bearbeitungssteuerelemente müssen das Text-Steuerelementmuster unterstützen, da detaillierte Informationen für Hilfstechnologieclients immer verfügbar sein müssen.
IValueProvider Depends (Abhängig) Alle Bearbeitungssteuerelemente, die eine Zeichenfolge annehmen, müssen das Wert-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 der vom Benutzer bearbeitet werden kann.
Wert Siehe Hinweise. Diese Eigenschaft enthält den Textinhalt des Bearbeitungssteuerelements. Wenn die UIA_IsPasswordPropertyId-Eigenschaft 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 Ereignisse aufgeführt, die Bearbeitungssteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Ereignis der Benutzeroberflächenautomatisierung Notizen
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaft geändertes Ereignis.
UIA_IsEnabledPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsOffscreenPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_NamePropertyId Eigenschaft geändertes Ereignis.
UIA_RangeValueValuePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das RangeValue-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontallyScrollablePropertyId Eigenschaft geändertes Ereignis. Ein Bearbeitungssteuerelement unterstützt nie das Scroll-Steuerelementmuster.
UIA_ScrollHorizontalScrollPercentPropertyId Eigenschaft geändertes Ereignis. Ein Bearbeitungssteuerelement unterstützt nie das Scroll-Steuerelementmuster.
UIA_ScrollHorizontalViewSizePropertyId Eigenschaft geändertes Ereignis. Ein Bearbeitungssteuerelement unterstützt nie das Scroll-Steuerelementmuster.
UIA_ScrollVerticallyScrollablePropertyId Eigenschaft geändertes Ereignis. Ein Bearbeitungssteuerelement unterstützt nie das Scroll-Steuerelementmuster.
UIA_ScrollVerticalScrollPercentPropertyId Eigenschaft geändertes Ereignis. Ein Bearbeitungssteuerelement unterstützt nie das Scroll-Steuerelementmuster.
UIA_ScrollVerticalViewSizePropertyId Eigenschaft geändertes Ereignis. Ein Bearbeitungssteuerelement unterstützt nie das Scroll-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_ValueValuePropertyId Eigenschaft geändertes Ereignis . Wenn das Steuerelement das Value-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 wie ein Feldobjekt, das über einen bestimmten Namen und einen bestimmten Wert verfügt.

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. Beispielsweise enthält die Windows Internet Explorer-Adressleiste 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