Steuerelement bearbeiten (Referenz zum MSAA-UI-Element)
Hinweis
In diesem Thema wird edit Control objects for purposes of MSAA UI Element Reference (Bearbeiten von Steuerelementobjekten für die MSAA-Benutzeroberflächenelementreferenz) beschrieben. Das Erstellen von Steuerelementobjekten bearbeiten in verschiedenen Benutzeroberflächenframeworks wird hier nicht beschrieben. Weitere Informationen finden Sie in der API-Referenzdokumentation für das benutzeroberflächenframework, das Sie verwenden.
Mit Steuerelementen bearbeiten kann ein Benutzer Text anzeigen und bearbeiten. Bearbeitungssteuerelemente werden mit vielen verschiedenen Stilen wie ES _ MULTILINE erstellt. Dieser Stil erstellt ein mehrlinebasiertes Bearbeitungssteuer steuerelement, z. B. den Clientbereich von Editor, und ES READONLY, das ein _ schreibgeschütztes Bearbeitungssteuer steuerelement erstellt.
Microsoft Active Accessibility unterscheidet nicht zwischen Bearbeitungssteuerelementen, die mit dem Fensterklassennamen "EDIT" erstellt wurden, und rich edit-Steuerelementen, die mit dem Fensterklassennamen "RichEdit" oder "RichEdit20A" erstellt wurden.
IAccessible-Methoden
Bearbeitungssteuerelemente unterstützen die folgenden IAccessible-Methoden:
IAccessible-Eigenschaften
Bearbeitungssteuerelemente unterstützen die folgenden IAccessible-Eigenschaften:
| Eigenschaft | Kommentare |
|---|---|
| get _ accChild | |
| get _ accChildCount | |
| get _ accDescription | |
| get _ accFocus | |
| get _ accKeyboardShortcut | Die KeyboardShortcut-Eigenschaft ist die Zugriffsschlüssel des Bearbeitungssteuerfelds, bei dem es sich um ein unterstrichenes Zeichen im Text der Bezeichnung des Bearbeitungssteuerfelds handelt. In einem Standarddialogfeld zum Öffnen von Dateien, z. B. in WordPad, ist "KeyboardShortcut" für das Bearbeitungssteuerfeld mit der Bezeichnung "Dateiname:" "Alt+n". |
| get _ accName | Die Name-Eigenschaft ist der Text aus einem statischen Textsteuerfeld, das das Bearbeitungssteuerfeld bezeichnet. In einem Standarddialogfeld zum Öffnen von Dateien, z. B. in WordPad, ist die Name-Eigenschaft für das Bearbeitungssteuerfeld beispielsweise "Dateiname:". |
| get _ accParent | Die Parent-Eigenschaft ist ein Fenster ( ROLE SYSTEM _ _ WINDOW ), das das Steuerelement umschließt und über die gleiche Name-Eigenschaft und den gleichen Fensterklassennamen wie das -Steuerelement verfügt. |
| get _ accRole | Die Role-Eigenschaft ist ROLE SYSTEM _ _ TEXT. |
| get _ accSelection | |
| get _ accState | Die State-Eigenschaft ist eine Kombination aus mindestens einem der folgenden Werte:STATE SYSTEM _ _ INVISIBLE | STATE SYSTEM _ _ FOCUSABLE | STATE SYSTEM _ _ FOCUSED | STATE SYSTEM _ _ READONLY | STATE _ SYSTEM _ PROTECTED | STATE _ SYSTEM _ NORMAL |
| get _ accValue | Die Value-Eigenschaft ist eine einzelne Zeichenfolge, die den Text im Bearbeitungssteuerfeld enthält. Wenn das Steuerelement jedoch kennwortgeschützt ist, gibt die Value-Eigenschaft E _ ACCESSDENIED zurück. Bei Mehrzeilen-Bearbeitungssteuerelementen enthält die Zeichenfolge einen Wagenrücklauf und ein Zeilenumstrich am Ende jeder Zeile. |
Hinweise
Microsoft Active Accessibility unterstützt nicht die Auswahl des Texts, der in Bearbeitungs- und Rich Edit-Steuerelementen enthalten ist, da der Text als Zeichenfolge in der Value-Eigenschaft des Objekts verfügbar gemacht wird.
Das von Riched20.dll bereitgestellte Rich-Edit-Steuerelement (das in Text-Editoren wie WordPad in Windows 98 verwendet wird) sendet keine WinEvents, wenn die Position des Caretworts während der Textauswahl geändert wird. Wenn Benutzer die UMSCHALTTASTE und die Pfeiltasten drücken, um Text auszuwählen, löst das Caretobjekt das Event _ Object _ LOCATIONCHANGE WinEvent nicht aus. Wenn die Auswahl programmgesteuert über umfangreiche Bearbeitungsmeldungen festgelegt wird, sendet das Caretobjekt keine Ereignisse, um seine neue Position anzugeben.
Alle Anwendungen, die Riched20.dll, weisen dieses Problem auf. Anwendungen, die frühere Versionen des Rich-Edit-Steuerelements verwenden, senden Ereignisse basierend auf der Auswahl ordnungsgemäß.
Der Statuswert für Steuerelemente zur Kennwortbearbeitung enthält immer das Bitflag STATE SYSTEM _ _ PROTECTED.