Método IShellView::UIActivate (shobjidl_core.h)
Se llama cuando el estado de activación de la ventana de vista cambia por un evento que no está causado por la propia vista shell. Por ejemplo, si se presiona la tecla TAB cuando el árbol tiene el foco, la vista debe tener el foco.
Sintaxis
HRESULT UIActivate(
UINT uState
);
Parámetros
uState
Tipo: UINT
Marca que especifica el estado de activación de la ventana. Este parámetro puede ser uno de los valores siguientes.
SVUIA_ACTIVATE_FOCUS
El Explorador de Windows acaba de crear la ventana de vista con el foco de entrada. Esto significa que la vista Shell debe ser capaz de establecer elementos de menú adecuados para el estado centrado.
SVUIA_ACTIVATE_NOFOCUS
La vista Shell pierde el foco de entrada o se acaba de crear sin el foco de entrada. La vista Shell debe ser capaz de establecer los elementos de menú adecuados para el estado no centrado. Esto significa que no se deben agregar elementos específicos de la selección.
SVUIA_DEACTIVATE
El Explorador de Windows está a punto de destruir la ventana de vista shell. La vista Shell debe quitar todas las interfaces de usuario extendidas. Normalmente, estos son menús combinados y ventanas emergentes de modelos combinados.
SVUIA_INPLACEACTIVATE
La vista Shell está activa sin foco. Esta marca solo se usa cuando UIActivate se expone a través de la interfaz IShellView2 .
Valor devuelto
Tipo: HRESULT
Devuelve S_OK si se ejecuta correctamente o un valor de error definido por COM de otro modo.
Comentarios
Antes de volver a combinar elementos de menú, la vista Shell normalmente enlaza el mensaje WM_SETFOCUS y llama al método OnViewWindowActive . La vista Shell no debe enlazar el mensaje de NM_KILLFOCUS para volver a remerge los elementos de menú.
Notas a las aplicaciones de llamada
Llame a este método para informar a la vista de un cambio de estado de activación.Notas para los implementadores
Use este método para realizar un seguimiento del estado de activación y cambiar cualquier comportamiento, según corresponda.Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl_core.h (incluya Shobjidl.h) |
| Archivo DLL | Shell32.dll (versión 4.0 o posterior) |