Estructura THUMBBUTTON (shobjidl_core.h)

Usado por métodos de la interfaz ITaskbarList3 para definir botones usados en una barra de herramientas incrustada en la representación en miniatura de una ventana.

Sintaxis

typedef struct THUMBBUTTON {
  THUMBBUTTONMASK  dwMask;
  UINT             iId;
  UINT             iBitmap;
  HICON            hIcon;
  WCHAR            szTip[260];
  THUMBBUTTONFLAGS dwFlags;
} THUMBBUTTON, *LPTHUMBBUTTON;

Miembros

dwMask

Tipo: THUMBBUTTONMASK

Combinación de valores THUMBBUTTONMASK que especifican qué miembros de esta estructura contienen datos válidos; se omiten otros miembros, con la excepción de iId, que siempre es necesario.

iId

Tipo: UINT

Identificador definido por la aplicación del botón, único dentro de la barra de herramientas.

iBitmap

Tipo: UINT

Índice de base cero de la imagen de botón dentro de la lista de imágenes establecida a través de ITaskbarList3::ThumbBarSetImageList.

hIcon

Tipo: HICON

Identificador de un icono que se va a usar como imagen de botón.

szTip[260]

Tipo: WCHAR[260]

Matriz de caracteres anchos que contiene el texto de la información sobre herramientas del botón, que se muestra cuando el puntero del mouse mantiene el puntero sobre el botón.

dwFlags

Tipo: THUMBBUTTONFLAGS

Combinación de valores THUMBBUTTONFLAGS que controlan estados y comportamientos específicos del botón.

Comentarios

Cuando se hace clic en un botón, se envía un mensaje de WM_COMMAND que contiene el identificador de botón a la ventana de la aplicación asociada. La aplicación controla cualquier acción que haya asignado al botón.

Imágenes de botón

Cuando se usa un icono, especificado a través del miembro hIcon , la barra de tareas realiza su propia copia del icono. Es responsabilidad del autor de la llamada liberar el identificador que pasó en hIcon cuando ya no es necesario.

Si se especifican tanto un icono como una lista de imágenes para la imagen de un botón, el icono se usa si es posible. Si por alguna razón se produce un error en el intento de recuperar el icono, se usa la imagen de la lista de imágenes.

Las aplicaciones deben proporcionar estas imágenes de botón:

• El botón en su estado activo predeterminado.
• Imágenes adecuadas para su uso con pantallas de valores altos de ppp (puntos por pulgada).

Las imágenes deben ser de 32 bits y de dimensiones GetSystemMetrics(SM_CXICON) x GetSystemMetrics(SM_CYICON). La propia barra de herramientas proporciona objetos visuales para los estados de clic, deshabilitado y mantener el puntero sobre un botón.

Requisitos

Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado	shobjidl_core.h (include Shobjidl.h)

Consulte también

ITaskbarList3::ThumbBarAddButtons

ITaskbarList3::ThumbBarUpdateButtons

Extensiones de la barra de tareas

Ejemplo de barra de herramientas de miniaturas de la barra de tareas