Función SHAppBarMessage (shellapi.h)

Artículo
03/15/2023

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)