Share via


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.

IAccessible (Interfaz)