Función SHAppBarMessage (shellapi.h)
Envía un mensaje de la barra de aplicaciones al sistema.
Sintaxis
UINT_PTR SHAppBarMessage(
[in] DWORD dwMessage,
[in, out] PAPPBARDATA pData
);
Parámetros
[in] dwMessage
Tipo: DWORD
Valor del mensaje de la barra de aplicaciones que se va a enviar. Este parámetro puede ser uno de los valores siguientes.
ABM_NEW (0x00000000)
Registra una nueva barra de aplicaciones y especifica el identificador de mensaje que el sistema debe usar para enviar mensajes de notificación a la barra de aplicaciones.
ABM_REMOVE (0x00000001)
Anula el registro de una barra de aplicaciones, quitando la barra de la lista interna del sistema.
ABM_QUERYPOS (0x00000002)
Solicita un tamaño y una posición de pantalla para una barra de aplicaciones.
ABM_SETPOS (0x00000003)
Establece el tamaño y la posición de pantalla de una barra de aplicaciones.
ABM_GETSTATE (0x00000004)
Recupera los estados de autohide y always-on-top de la barra de tareas de Windows.
ABM_GETTASKBARPOS (0x00000005)
Recupera el rectángulo delimitador de la barra de tareas de Windows. Tenga en cuenta que esto solo se aplica a la barra de tareas del sistema. Otros objetos, especialmente las barras de herramientas proporcionadas con software de terceros, también pueden estar presentes. Como resultado, es posible que parte del área de pantalla no cubierta por la barra de tareas de Windows no sea visible para el usuario. Para recuperar el área de la pantalla no cubierta por la barra de tareas y otras barras de la aplicación (el área de trabajo disponible para la aplicación), use la función GetMonitorInfo .
ABM_ACTIVATE (0x00000006)
Notifica al sistema que active o desactive una barra de aplicaciones. El miembro lParam del APPBARDATA al que apunta pData se establece en TRUE para activar o FALSE para desactivar.
ABM_GETAUTOHIDEBAR (0x00000007)
Recupera el identificador de la barra de aplicaciones de autohide asociada a un borde determinado de la pantalla.
ABM_SETAUTOHIDEBAR (0x00000008)
Registra o anula el registro de una barra de aplicaciones de autohide para un borde de la pantalla.
ABM_WINDOWPOSCHANGED (0x00000009)
Notifica al sistema cuando ha cambiado la posición de una barra de aplicaciones.
ABM_SETSTATE (0x0000000A)
Windows XP y versiones posteriores: Establece el estado de los atributos autohide y always-on-top de la barra de aplicaciones.
ABM_GETAUTOHIDEBAREX (0x0000000B)
Windows XP y versiones posteriores: Recupera el identificador de la barra de aplicaciones de autohide asociada a un borde determinado de un monitor determinado.
ABM_SETAUTOHIDEBAREX (0x0000000C)
Windows XP y versiones posteriores: Registra o anula el registro de una barra de aplicaciones de autohide para un borde de un monitor determinado.
[in, out] pData
Tipo: PAPPBARDATA
Puntero a una estructura APPBARDATA . El contenido de la estructura en la entrada y la salida depende del valor establecido en el parámetro dwMessage . Consulte las páginas de mensajes individuales para obtener información específica.
Valor devuelto
Tipo: UINT_PTR
Esta función devuelve un valor dependiente del mensaje. Para obtener más información, consulte la documentación de Windows SDK del mensaje específico de la barra de aplicaciones enviada. Los vínculos a esos documentos se proporcionan en la sección Vea también.
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 | shellapi.h |
| Library | Shell32.lib |
| Archivo DLL | Shell32.dll (versión 4.0 o posterior) |
| Conjunto de API | ext-ms-win-shell-shell32-l1-2-1 (introducido en Windows 10, versión 10.0.10240) |