Dialogfeld (MSAA-UI-Elementreferenz)
Hinweis
In diesem Thema werden Dialogfeldobjekte für die MSAA-Benutzeroberflächenelementreferenz beschrieben. Das Erstellen von Dialogfeldobjekten in verschiedenen Ui-Frameworks ist hier nicht beschrieben. Weitere Informationen finden Sie in der API-Referenzdokumentation für das von Ihnen verwendete Benutzeroberflächenframework.
Ein Dialogfeld ist ein temporäres Fenster, das eine Anwendung zum Abrufen von Benutzereingaben erstellt. Eine Anwendung verwendet Dialogfelder, um den Benutzer zur Eingabe zusätzlicher Informationen zu Befehlen aufzufordern, die der Benutzer aus einem Menü ausgewählt hat. Ein Dialogfeld enthält mindestens ein Steuerelement (untergeordnete Fenster), mit dem der Benutzer Text eingibt, Optionen wählt oder die Aktion des Befehls leitet.
Der Fensterklassenname für Dialogfelder lautet "#32770".
IAccessible-Methoden
Ein Dialogfeld unterstützt die folgenden IAccessible-Methoden :
| Methode | Kommentare |
|---|---|
| accDoDefaultAction | Wenn das Dialogfeld eine Standard-Druckschaltfläche enthält, ruft die accDoDefaultAction-MethodePostMessage mit der BM_CLICK-Schaltflächenmeldung auf, um auf die Standard-Pushschaltfläche zu klicken. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
IAccessible-Eigenschaften
Ein Dialogfeld unterstützt die folgenden IAccessible-Eigenschaften :
| Eigenschaft | Kommentare |
|---|---|
| get_accChildCount | Die ChildCount-Eigenschaft entspricht der Anzahl der untergeordneten Fenstersteuerelemente im Dialogfeld. |
| get_accDefaultAction | Wenn das Dialogfeld eine Standard-Druckschaltfläche enthält, lautet die DefaultAction-Eigenschaft "Press". |
| get_accFocus | |
| get_accKeyboardShortcut | In der Regel verfügen Dialogfelder über keine Tastenkombinationen. Wenn der Fenstertext für das Dialogfeld ein Zeichen amper und (&) enthält, gibt Microsoft Active Accessibility als KeyboardShortcut-Eigenschaft eine Nicht-Null-Zeichenfolge zurück. |
| get_accName | Die Name-Eigenschaft ist der Fenstertext oder Untertitel, der in der Titelleiste des Dialogfelds angezeigt wird. |
| get_accParent | Die Parent-Eigenschaft ist ein Fenster ( ROLE_SYSTEM_WINDOW ), das das Dialogfeld umgibt und denselben Name-Eigenschafts - und Fensterklassennamen wie das Dialogfeld aufweist. |
| get_accRole | Die Role-Eigenschaft ist ROLE_SYSTEM_DIALOG oder ROLE_SYSTEM_PROPERTYPAGE. |
| get_accState | Die State-Eigenschaft ist eine Kombination aus mindestens einem der folgenden Werte:STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE |
Bemerkungen
Das Dialogobjekt unterstützt die get_accChild-Methode nicht. Um einen IAccessible-Schnittstellenzeiger auf ein Steuerelement in einem Dialogfeld abzurufen, müssen Clients das Fensterhandle des Steuerelements abrufen und dann AccessibleObjectFromWindow aufrufen.