Steuerelementtyp bearbeiten
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
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Anmerkungen
- Zugehörige Themen
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 |
|---|---|
|
|
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.
Zugehörige Themen