Compartilhar via

Estrutura THUMBBUTTON (shobjidl_core.h)

  • Artigo

Usado por métodos da interface ITaskbarList3 para definir botões usados em uma barra de ferramentas inserida na representação em miniatura de uma janela.

Sintaxe

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

Membros

dwMask

Tipo: THUMBBUTTONMASK

Uma combinação de valores THUMBBUTTONMASK que especificam quais membros dessa estrutura contêm dados válidos; outros membros são ignorados, com exceção de iId, o que é sempre necessário.

iId

Tipo: UINT

O identificador definido pelo aplicativo do botão, exclusivo na barra de ferramentas.

iBitmap

Tipo: UINT

O índice baseado em zero da imagem do botão dentro da lista de imagens definida por meio de ITaskbarList3::ThumbBarSetImageList.

hIcon

Tipo: HICON

O identificador de um ícone a ser usado como a imagem do botão.

szTip[260]

Tipo: WCHAR[260]

Uma matriz de caracteres largos que contém o texto da dica de ferramenta do botão, exibida quando o ponteiro do mouse passa o mouse sobre o botão.

dwFlags

Tipo: THUMBBUTTONFLAGS

Uma combinação de valores THUMBBUTTONFLAGS que controlam estados e comportamentos específicos do botão.

Comentários

Quando um botão é clicado, uma mensagem WM_COMMAND que contém a ID do botão é enviada para a janela do aplicativo associada. O aplicativo manipula qualquer ação atribuída ao botão.

Imagens de botão

Ao usar um ícone, especificado por meio do membro hIcon , a barra de tarefas faz sua própria cópia do ícone. É responsabilidade do chamador liberar o identificador passado no hIcon quando ele não for mais necessário.

Se um ícone e uma lista de imagens forem especificados para a imagem de um botão, o ícone será usado, se possível. Se, por algum motivo, a tentativa de recuperar o ícone falhar, a imagem da lista de imagens será usada.

Os aplicativos devem fornecer estas imagens de botão:

  • O botão em seu estado ativo padrão.
  • Imagens adequadas para uso com exibições de alto dpi (pontos por polegada).

As imagens devem ser de 32 bits e das dimensões GetSystemMetrics(SM_CXICON) x GetSystemMetrics(SM_CYICON). A própria barra de ferramentas fornece visuais para os estados clicados, desabilitados e focalizados de um botão.

Requisitos

   
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)

Confira também

ITaskbarList3::ThumbBarAddButtons

ITaskbarList3::ThumbBarUpdateButtons

Extensões da barra de tarefas

Exemplo da barra de ferramentas em miniatura da barra de tarefas