Cuadro de diálogo (Referencia de elementos de interfaz de usuario de MSAA)
Nota:
En este tema se describen los objetos Dialog Box con fines de referencia de elementos de interfaz de usuario de MSAA. Aquí no se describe cómo crear objetos Dialog Box en varios marcos de interfaz de usuario. Consulte la documentación de referencia de API para el marco de interfaz de usuario que usa.
Un cuadro de diálogo es una ventana temporal que crea una aplicación para recuperar la entrada del usuario. Una aplicación usa cuadros de diálogo para solicitar al usuario información adicional sobre los comandos que el usuario ha elegido en un menú. Un cuadro de diálogo contiene uno o varios controles (ventanas secundarias) con los que el usuario escribe texto, elige opciones o dirige la acción del comando.
El nombre de clase de ventana para los cuadros de diálogo es "#32770".
Métodos IAccessible
Un cuadro de diálogo admite los siguientes métodos IAccessible :
| Método | Comentarios |
|---|---|
| accDoDefaultAction | Si el cuadro de diálogo contiene un botón de inserción predeterminado, el método accDoDefaultAction llama a PostMessage con el mensaje de botón BM_CLICK para hacer clic en el botón de inserción predeterminado. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
Propiedades IAccessible
Un cuadro de diálogo admite las siguientes propiedades IAccessible :
| Propiedad | Comentarios |
|---|---|
| get_accChildCount | La propiedad ChildCount es igual al número de controles de ventana secundarios en el cuadro de diálogo. |
| get_accDefaultAction | Si el cuadro de diálogo contiene un botón de inserción predeterminado, la propiedad DefaultAction es "Press". |
| get_accFocus | |
| get_accKeyboardShortcut | Normalmente, los cuadros de diálogo no tienen métodos abreviados de teclado. Si el texto de la ventana del cuadro de diálogo contiene un carácter de y comercial (&), La accesibilidad activa de Microsoft devuelve una cadena que no es Null como la propiedad KeyboardShortcut . |
| get_accName | La propiedad Name es el texto de la ventana, o subtítulo, que se muestra en la barra de título del cuadro de diálogo. |
| get_accParent | La propiedad Parent es una ventana ( ROLE_SYSTEM_WINDOW ) que rodea el cuadro de diálogo y tiene la misma propiedad Name y el mismo nombre de clase de ventana que el cuadro de diálogo. |
| get_accRole | La propiedad Role es ROLE_SYSTEM_DIALOG o ROLE_SYSTEM_PROPERTYPAGE. |
| get_accState | La propiedad State es una combinación de uno o varios de los siguientes valores: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE |
Comentarios
El objeto dialog no admite el método get_accChild . Para obtener un puntero de interfaz IAccessible a un control en un cuadro de diálogo, los clientes deben obtener el identificador de ventana del control y, a continuación, llamar a AccessibleObjectFromWindow.