Steuerelement bearbeiten (MSAA UI-Elementreferenz)
Hinweis
In diesem Thema wird das Bearbeiten von Steuerelementobjekten für Zwecke der MSAA-Benutzeroberflächenelementreferenz beschrieben. Wie Sie Steuerelementobjekte bearbeiten in verschiedenen Benutzeroberflächenframeworks erstellen, wird hier nicht beschrieben. Weitere Informationen finden Sie in der API-Referenzdokumentation für das von Ihnen verwendete Benutzeroberflächenframework.
Bearbeiten von Steuerelementen ermöglicht es einem Benutzer, Text anzuzeigen und zu bearbeiten. Bearbeitungssteuerelemente werden mit vielen verschiedenen Stilen erstellt, z. B. ES_MULTILINE. Dieser Stil erstellt ein mehrlineiges Bearbeitungssteuerelement, z. B. den Clientbereich von Editor und ES_READONLY, wodurch ein schreibgeschütztes Bearbeitungssteuerelement erstellt wird.
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
Edit-Steuerelemente unterstützen die folgenden IAccessible-Methoden :
IAccessible-Eigenschaften
Edit-Steuerelemente unterstützen die folgenden IAccessible-Eigenschaften :
| Eigenschaft | Kommentare |
|---|---|
| get_accChild | |
| get_accChildCount | |
| get_accDescription | |
| get_accFocus | |
| get_accKeyboardShortcut | Die KeyboardShortcut-Eigenschaft ist die Zugriffstaste des Bearbeitungssteuerelements, die ein unterstrichenes Zeichen im Text der Bezeichnung des Bearbeitungssteuerelements ist. Beispielsweise ist in einem Standarddialogfeld Datei öffnen, z. B. in WordPad, der KeyboardShortcut für das Bearbeitungssteuerelement mit der Bezeichnung "Dateiname:" "Alt+n". |
| get_accName | Die Name-Eigenschaft ist der Text aus einem statischen Textsteuerelement, das das Bearbeitungssteuerelement beschriftt. In einem Standarddialogfeld Datei öffnen, z. B. in WordPad, lautet die Name-Eigenschaft für das Bearbeitungssteuerelement "Dateiname:". |
| get_accParent | Die Parent-Eigenschaft ist ein Fenster ( ROLE_SYSTEM_WINDOW ), das das Steuerelement umgibt und denselben Name-Eigenschafts - und Fensterklassennamen wie das Steuerelement aufweist. |
| 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 Bearbeitungssteuerelement enthält. Wenn das Steuerelement jedoch kennwortgeschützter ist, gibt die Value-Eigenschaft E_ACCESSDENIED zurück. Bei Steuerelementen für mehrzeilige Bearbeitung enthält die Zeichenfolge eine Wagenrückgabe und ein Zeilenumbruchzeichen am Ende jeder Zeile. |
Hinweise
Microsoft Active Accessibility unterstützt die Auswahl des Texts, der in Steuerelementen für die Bearbeitung und Rich-Bearbeitung enthalten ist, nicht, da der Text als Zeichenfolge in der Value-Eigenschaft des Objekts verfügbar gemacht wird.
Das rich-Edit-Steuerelement, das von Riched20.dll bereitgestellt wird (das in Text-Editoren wie WordPad in Windows 98 verwendet wird) sendet keine WinEvents, wenn die Caret-Position während der Textauswahl geändert wird. Wenn Benutzer UMSCHALT- und PFEILTASTEn drücken, um Text auszuwählen, löst das Caret-Objekt die EVENT_OBJECT_LOCATIONCHANGE WinEvent nicht aus. Wenn die Auswahl programmgesteuert über Rich-Edit-Meldungen festgelegt wird, sendet das Caret-Objekt keine Ereignisse, um seine neue Position anzugeben.
Alle Anwendungen, die Riched20.dll verwenden, weisen dieses Problem auf. Anwendungen, die frühere Versionen des Rich-Edit-Steuerelements verwenden, senden Ereignisse basierend auf der Auswahl ordnungsgemäß.
Der State-Wert für Kennwortbearbeitungssteuerelemente enthält immer das Bitflag STATE_SYSTEM_PROTECTED.