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