Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Aktualisiert: November 2007
Dieses Thema enthält Informationen zur UI-Automatisierung-Unterstützung für den Edit-Steuerelementtyp. In UI-Automatisierung 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-Automatisierung-Struktur, UI-Automatisierung-Eigenschaftenwerte und Steuerelementmuster ein.
Edit-Steuerelemente sind ein Beispiel für Steuerelemente, von denen der Edit-Steuerelementtyp implementiert wird. Mit Edit-Steuerelementen können einzelne Textzeilen angezeigt und bearbeitet werden.
In den folgenden Abschnitten werden die UI-Automatisierung-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Edit-Steuerelementtyp erforderlich sind. Die UI-Automatisierung-Anforderungen gelten für alle Edit-Steuerelemente aus Windows Presentation Foundation (WPF), Win32 oder Windows Forms.
Dieses Thema enthält folgende Abschnitte.
- Erforderliche Benutzeroberflächenautomatisierungs-Struktur
- Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
- Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
- Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
- Verwandte Abschnitte
Erforderliche Benutzeroberflächenautomatisierungs-Struktur
In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI-Automatisierung-Struktur für Edit-Steuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI-Automatisierung-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.
Steuerelementansicht |
Inhaltsansicht |
|---|---|
|
|
Die Steuerelemente, von denen der Edit-Steuerelementtyp implementiert wird, enthalten keine Bildlaufleiste in der Steuerelementansicht der UI-Automatisierung-Struktur, da es sich um einzeilige Steuerelemente handelt. Die einzelne Textzeile wird in einigen Layoutszenarien möglicherweise umgebrochen. Der Edit-Steuerelementtyp ist nur für kleine Mengen an bearbeitbarem Text vorgesehen.
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle werden die UI-Automatisierung-Eigenschaften aufgelistet, deren Werte oder Definitionen für Edit-Steuerelemente besonders wichtig sind. Weitere Informationen über die UI-Automatisierung-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.
UI-Automatisierung-Eigenschaft |
Wert |
Hinweise |
|---|---|---|
AutomationIdProperty() |
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. |
Edit-Steuerelemente 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 Edit-Steuerelements wird i. d. R. aus einer statischen Textbezeichnung generiert. Ist keine statische Textbezeichnung vorhanden, muss der Anwendungsentwickler Name einen Eigenschaftenwert zuweisen. Die Name-Eigenschaft darf niemals den Textinhalt des Edit-Steuerelements 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 Benutzeroberfläche-Frameworks identisch. |
|
"bearbeiten" |
Lokalisierte Zeichenfolge, die dem Edit-Steuerelementtyp entspricht. |
|
True |
Das Edit-Steuerelement ist in der Inhaltsansicht der UI-Automatisierung-Struktur immer enthalten. |
|
True |
Das Edit-Steuerelement ist stets in der Steuerelementansicht der UI-Automatisierung-Struktur enthalten. |
|
Siehe Hinweise. |
Muss in Edit-Steuerelementen, die Kennwörter enthalten, auf "true" festgelegt werden. Wenn ein Edit-Steuerelement Kennwörter enthält, kann diese Eigenschaft von einer Bildschirmsprachausgabe zum Bestimmen verwendet werden, ob Tastaturanschläge bei der Eingabe gelesen werden sollen. |
Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
In der folgenden Tabelle sind die Steuerelementmuster aufgelistet, die von allen Edit-Steuerelementen 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 |
|---|---|---|
Erforderlich |
Das Text-Steuerelementmuster muss von allen Edit-Steuerelementen unterstützt werden, da für Hilfstechnologieclients immer ausführliche Informationen verfügbar sein müssen. |
|
Variabel |
Von allen Edit-Steuerelementen, 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 werden kann. |
|
Siehe Hinweise. |
Diese Eigenschaft gibt den Textinhalt des Edit-Steuerelements zurück. Wenn die IsPasswordProperty auf true festgelegt wird, muss von dieser Eigenschaft auf Anforderung eine InvalidOpertaionException ausgelöst werden. |
|
Variabel |
Von allen Edit-Steuerelementen, 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 Edit-Steuerelements annehmen kann. |
|
Siehe Hinweise. |
Diese Eigenschaft muss auf den größten Wert festgelegt werden, den der Inhalt des Edit-Steuerelements 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, wenn ein Bereich von 1,0 bis 2,0 verwendet werden kann, muss SmallChangeProperty auf 0,1, und wenn für das Edit-Steuerelement 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 Edit-Steuerelement nicht verfügbar gemacht werden. |
|
Siehe Hinweise. |
Diese Eigenschaft gibt den numerischen Inhalt des Edit-Steuerelements an. Wenn von einem UI-Automatisierung-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-Automatisierung-Ereignisse aufgelistet, die von allen Edit-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.
UI-Automatisierung-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 "System.Windows.Automation.ScrollPatternIdentifiers.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
Konzepte
Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung
Übersicht über die Benutzeroberflächenautomatisierung