Cuadro de diálogo (Referencia de elementos de interfaz de usuario de MSAA)
Nota
En este tema se describen objetos Dialog Box con fines de referencia de elementos de interfaz de usuario de MSAA. No se describe cómo crear cuadro de diálogo objetos 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 una aplicación crea 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 la clase de ventana para los cuadros de diálogo es "#32770".
Métodos IAccessible
Un cuadro de diálogo admite los siguientes métodos deIAccessible:
| Método | Comentarios |
|---|---|
| accDoDefaultAction | Si el cuadro de diálogo contiene un botón de inserción predeterminado, la accDoDefaultAction llama al método PostMessage con el mensaje del botón BM_CLICK para hacer clic en el botón de inserción predeterminado. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
Propiedades de IAccessible
Un cuadro de diálogo admite las siguientes propiedades deIAccessible:
| Propiedad | Comentarios |
|---|---|
| get_accChildCount | La propiedad ChildCount es igual al número de controles de ventana secundarios del 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 ampersand (&), Microsoft Active Accessibility devuelve una cadena que no es Null como la propiedad KeyboardShortcut de. |
| get_accName | La propiedad Name es el texto de la ventana o el título que se muestra en la barra de título del cuadro de diálogo. |
| get_accParent | La propiedad primario de es una ventana ( ROLE_SYSTEM_WINDOW ) que rodea el cuadro de diálogo y tiene el mismo Nombre propiedad y nombre de clase de ventana que el cuadro de diálogo. |
| get_accRole | La propiedad Role de 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 de :STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE |
Observaciones
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.