Finestra di dialogo (riferimento all'elemento DELL'interfaccia utente MSAA)
Nota
In questo argomento vengono descritti gli oggetti Dialog Box ai fini del riferimento agli elementi dell'interfaccia utente MSAA. Come creare oggetti Finestra di dialogo in vari framework dell'interfaccia utente non è descritto qui. Vedere la documentazione di riferimento sulle API per il framework dell'interfaccia utente in uso.
Una finestra di dialogo è una finestra temporanea creata da un'applicazione per recuperare l'input dell'utente. Un'applicazione usa le finestre di dialogo per richiedere all'utente ulteriori informazioni sui comandi scelti dall'utente da un menu. Una finestra di dialogo contiene uno o più controlli (finestre figlio) con cui l'utente immette testo, sceglie opzioni o indirizza l'azione del comando.
Il nome della classe della finestra per le finestre di dialogo è "#32770".
Metodi IAccessible
Una finestra di dialogo supporta i metodi IAccessible seguenti:
| metodo | Commenti |
|---|---|
| accDoDefaultAction | Se la finestra di dialogo contiene un pulsante di scelta rapida predefinito, il metodo accDoDefaultAction chiama PostMessage con il messaggio del pulsante BM_CLICK per fare clic sul pulsante di scelta rapida predefinito. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
Proprietà IAccessible
Una finestra di dialogo supporta le proprietà IAccessible seguenti:
| Proprietà | Commenti |
|---|---|
| get_accChildCount | La proprietà ChildCount è uguale al numero di controlli finestra figlio nella finestra di dialogo. |
| get_accDefaultAction | Se la finestra di dialogo contiene un pulsante di pressione predefinito, la proprietà DefaultAction è "Press". |
| get_accFocus | |
| get_accKeyboardShortcut | In genere, le finestre di dialogo non dispongono di tasti di scelta rapida. Se il testo della finestra per la finestra di dialogo contiene un carattere di e commerciale (&), Microsoft Active Accessibility restituisce una stringa non Null come proprietà KeyboardShortcut . |
| get_accName | La proprietà Name è il testo della finestra o didascalia visualizzato nella barra del titolo della finestra di dialogo. |
| get_accParent | La proprietà Parent è una finestra ( ROLE_SYSTEM_WINDOW ) che circonda la finestra di dialogo e ha lo stesso nome della proprietà Name e della classe della finestra di dialogo. |
| get_accRole | La proprietà Role è ROLE_SYSTEM_DIALOG o ROLE_SYSTEM_PROPERTYPAGE. |
| get_accState | La proprietà State è una combinazione di uno o più dei valori seguenti: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUedizione Standard D STATE_SYSTEM_FOCUSABLE | |
Osservazioni:
L'oggetto dialog non supporta il metodo get_accChild. Per ottenere un puntatore all'interfaccia IAccessible a un controllo in una finestra di dialogo, i client devono ottenere l'handle della finestra del controllo e quindi chiamare AccessibleObjectFromWindow.