Benutzeroberflächenautomatisierungs-Unterstützung für den Edit-Steuerelementtyp
.gif "Hinweis") Hinweis |
|---|
Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation. |
Dieses Thema enthält Informationen zur UI Automation-Unterstützung für den Edit-Steuerelementtyp. In UI Automation umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen schließen bestimmte Richtlinien für UI Automation-Struktur, UI Automation-Eigenschaftswerte und Steuerelementmuster ein.
Mit Bearbeitungssteuerelementen kann ein Benutzer einfache Textzeilen ohne umfangreiche Formatierungsunterstützung anzeigen und bearbeiten.
In den folgenden Abschnitten werden die UI Automation-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Bearbeitungssteuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle Bearbeitungssteuerelemente aus Windows Presentation Foundation (WPF), Win32 oder Windows Forms.
Dieses Thema enthält folgende Abschnitte.
- Erforderliche Benutzeroberflächenautomatisierungs-Struktur
- Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
- Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster und Eigenschaften
- Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
- Verwandte Abschnitte
Erforderliche Benutzeroberflächenautomatisierungs-Struktur
In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur für Bearbeitungssteuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.
Steuerelementansicht |
Inhaltsansicht |
|---|---|
Edit |
Edit |
Die Steuerelemente, von denen der Bearbeitungssteuerelementtyp implementiert wird, enthalten keine Bildlaufleiste in der Steuerelementansicht der UI Automation-Struktur, da es sich um einzeilige Steuerelemente handelt. Die einzelne Textzeile wird in einigen Layoutszenarien möglicherweise umgebrochen. Der Bearbeitungssteuerelementtyp ist am besten für kleine Mengen von bearbeitbarem oder auswählbarem Text geeignet.
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle werden die UI Automation-Eigenschaften aufgelistet, deren Werte oder Definitionen für Bearbeitungssteuerelemente besonders wichtig sind. Weitere Informationen über UI Automation-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.
UI Automation-Eigenschaft |
Wert |
Hinweise |
|---|---|---|
Siehe Hinweise. |
Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein. |
|
Siehe Hinweise. |
Das äußere, das gesamte Steuerelement umfassende Rechteck. |
|
Siehe Hinweise. |
Bearbeitungssteuerelemente müssen einen durch Klicken aktivierbaren Punkt enthalten, der den Eingabefokus auf den Bearbeitungsbereich festlegt, wenn auf ihn geklickt wird. |
|
Siehe Hinweise. |
Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
|
Siehe Hinweise. |
Der Name des Bearbeitungssteuerelements wird i. d. R. aus einer statischen Textbezeichnung generiert. Ist keine statische Textbezeichnung vorhanden, muss der Anwendungsentwickler Name einen Eigenschaftswert zuweisen. Die Name-Eigenschaft darf niemals den Textinhalt des Bearbeitungssteuerelements enthalten. |
|
Siehe Hinweise. |
Wenn mit dem Steuerelement eine statische Textbezeichnung verknüpft ist, muss diese Eigenschaft einen Verweis auf dieses Steuerelement verfügbar machen. Wenn das Text-Steuerelement eine Unterkomponente eines anderen Steuerelements ist, wird für das Steuerelement keine LabeledBy-Eigenschaft festgelegt. |
|
Edit |
Dieser Wert ist für alle UI-Frameworks identisch. |
|
"bearbeiten" |
Lokalisierte Zeichenfolge, die dem Bearbeitungssteuerelementtyp entspricht. |
|
True |
Das Bearbeitungssteuerelement ist in der Inhaltsansicht der UI Automation-Struktur immer enthalten. |
|
True |
Das Bearbeitungssteuerelement ist stets in der Steuerelementansicht der UI Automation-Struktur enthalten. |
|
Siehe Hinweise. |
Muss in Bearbeitungssteuerelementen, die Kennwörter enthalten, auf "true" festgelegt werden. Wenn ein Bearbeitungssteuerelement Kennwörter enthält, kann diese Eigenschaft von einer Bildschirmsprachausgabe zum Bestimmen verwendet werden, ob Tastaturanschläge bei der Eingabe gelesen werden sollen. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster und Eigenschaften
In der folgenden Tabelle sind die Steuerelementmuster aufgelistet, die von allen Bearbeitungssteuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.
Steuerelementmuster/Steuerelementmuster-Eigenschaft |
Unterstützung/Wert |
Hinweise |
|---|---|---|
Variabel |
Text-Steuerelementmuster müssen von Bearbeitungssteuerelementen unterstützt werden, da für Clients immer ausführliche Textinformationen verfügbar sein müssen. |
|
Variabel |
Von allen Bearbeitungssteuerelementen, die eine Zeichenfolge annehmen, muss das Value-Muster verfügbar gemacht werden. |
|
Siehe Hinweise. |
Diese Eigenschaft muss festgelegt werden, um anzuzeigen, ob ein Wert für das Steuerelement programmgesteuert festgelegt oder vom Benutzer bearbeitet werden kann. |
|
Siehe Hinweise. |
Diese Eigenschaft gibt den Textinhalt des Bearbeitungssteuerelements zurück. Wenn die IsPasswordProperty auf true festgelegt wird, muss von dieser Eigenschaft auf Anforderung eine InvalidOpertaionException ausgelöst werden. |
|
Variabel |
Von allen Bearbeitungssteuerelementen, die einen numerischen Bereich annehmen, muss das RangeValue-Steuerelementmuster verfügbar gemacht werden. |
|
Siehe Hinweise. |
Diese Eigenschaft muss auf den kleinsten Wert festgelegt werden, den der Inhalt des Bearbeitungssteuerelements annehmen kann. |
|
Siehe Hinweise. |
Diese Eigenschaft muss auf den größten Wert festgelegt werden, den der Inhalt des Bearbeitungssteuerelements annehmen kann. |
|
Siehe Hinweise. |
Diese Eigenschaft muss die Anzahl an Dezimalstellen angeben, die für den Wert festgelegt werden können. Wenn nur ganze Zahlen zulässig sind, muss die SmallChangeProperty auf 1 festgelegt werden. Wenn ein Bereich von 1,0 bis 2,0 verwendet werden kann, muss SmallChangeProperty auf 0,1 festgelegt werden. wenn für das Bearbeitungssteuerelement ein Bereich von 1,00 bis 2,00 zulässig ist, muss die SmallChangeProperty auf 0,001 festgelegt werden. |
|
Null |
Diese Eigenschaft muss für ein Bearbeitungssteuerelement nicht verfügbar gemacht werden. |
|
Siehe Hinweise. |
Diese Eigenschaft gibt den numerischen Inhalt des Bearbeitungssteuerelements an. Wenn von einem UI Automation-Client innerhalb des durch die Eigenschaften Minimum und Maximum angegebenen Bereichs ein präziserer Wert festgelegt ist, wird die Value-Eigenschaft automatisch auf den nächsten zulässigen Wert gerundet. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle werden die UI Automation-Ereignisse aufgelistet, die von allen Bearbeitungssteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.
UI Automation-Ereignis |
Unterstützung |
Hinweise |
|---|---|---|
Erforderlich |
Keine |
|
Erforderlich |
Keine |
|
Erforderlich |
Keine |
|
Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis |
Erforderlich |
Keine |
Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis |
Erforderlich |
Keine |
Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis |
Erforderlich |
Keine |
Durch geänderte NameProperty-Eigenschaft ausgelöstes Ereignis |
Erforderlich |
Keine |
Durch geänderte ValueProperty-Eigenschaft ausgelöstes Ereignis |
Variabel |
Keine |
Durch geänderte HorizontallyScrollableProperty-Eigenschaft ausgelöstes Ereignis |
Nie |
Keine |
Durch geänderte HorizontalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis |
Nie |
Keine |
Durch geänderte HorizontalViewSizeProperty-Eigenschaft ausgelöstes Ereignis |
Nie |
Keine |
Durch geänderte VerticalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis |
Nie |
Keine |
Durch geänderte VerticallyScrollableProperty-Eigenschaft ausgelöstes Ereignis |
Nie |
Keine |
Durch geänderte VerticalViewSizeProperty-Eigenschaft ausgelöstes Ereignis |
Nie |
Keine |
Durch geänderte ValueProperty-Eigenschaft ausgelöstes Ereignis |
Variabel |
Wenn vom Steuerelement das RangeValue-Steuerelementmuster unterstützt wird, muss dieses Ereignis unterstützt werden. |
Erforderlich |
Keine |
|
Erforderlich |
Keine |
Siehe auch
Referenz
Konzepte
Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung