Dialogruta (MSAA UI-elementreferens)
Not
I det här avsnittet beskrivs dialogruta objekt för MSAA UI-elementreferens. Hur du skapar dialogruta objekt i olika gränssnittsramverk beskrivs inte här. Se API-referensdokumentationen för det användargränssnittsramverk som du använder.
En dialogruta är ett tillfälligt fönster som ett program skapar för att hämta användarindata. Ett program använder dialogrutor för att be användaren om ytterligare information om kommandon som användaren har valt från en meny. En dialogruta innehåller en eller flera kontroller (underordnade fönster) med vilka användaren anger text, väljer alternativ eller dirigerar kommandots åtgärd.
Fönstrets klassnamn för dialogrutor är "#32770".
IAccessible-metoder
En dialogruta stöder följande IAccessible- metoder:
| Metod | Kommentarer |
|---|---|
| accDoDefaultAction | Om dialogrutan innehåller en standardknapp anropar metoden accDoDefaultActionPostMessage med BM_CLICK-knappmeddelandet för att klicka på standardknappen. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
IAccessible-egenskaper
En dialogruta stöder följande egenskaper för IAccessible:
| Egenskap | Kommentarer |
|---|---|
| get_accChildCount | Egenskapen ChildCount är lika med antalet underordnade fönsterkontroller i dialogrutan. |
| get_accDefaultAction | Om dialogrutan innehåller en standardknapp är egenskapen DefaultAction "Tryck". |
| get_accFocus | |
| get_accKeyboardShortcut | Dialogrutor har vanligtvis inte kortkommandon. Om fönstertexten för dialogrutan innehåller tecknet et och (&) returnerar Microsoft Active Accessibility en sträng som inte är null som egenskapen KeyboardShortcut. |
| get_accName | Egenskapen Name är fönstertexten eller bildtexten som visas i namnlisten i dialogrutan. |
| get_accParent | Egenskapen Parent är ett fönster ( ROLE_SYSTEM_WINDOW ) som omger dialogrutan och har samma Namn egenskap och fönsterklassnamn som dialogrutan. |
| get_accRole | Egenskapen Role är ROLE_SYSTEM_DIALOG eller ROLE_SYSTEM_PROPERTYPAGE. |
| get_accState | Egenskapen State är en kombination av ett eller flera av följande värden:STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE |
Anmärkningar
Dialogobjektet stöder inte metoden get_accChild. För att hämta en IAccessible--gränssnittspekare till en kontroll i en dialogruta måste klienterna hämta kontrollens fönsterhandtag och sedan anropa AccessibleObjectFromWindow.