Compartilhar via


Função CreateToolbarEx (commctrl.h)

Cria uma janela da barra de ferramentas e adiciona os botões especificados à barra de ferramentas.

Nota Essa função foi preterida, pois não dá suporte a todos os recursos de barras de ferramentas. Em vez disso, use CreateWindowEx . Para obter exemplos, consulte Usando controles da barra de ferramentas.
 

Sintaxe

HWND CreateToolbarEx(
  HWND        hwnd,
  DWORD       ws,
  UINT        wID,
  int         nBitmaps,
  HINSTANCE   hBMInst,
  UINT_PTR    wBMID,
  LPCTBBUTTON lpButtons,
  int         iNumButtons,
  int         dxButton,
  int         dyButton,
  int         dxBitmap,
  int         dyBitmap,
  UINT        uStructSize
);

Parâmetros

hwnd

Tipo: HWND

Manipule para a janela pai da barra de ferramentas.

ws

Tipo: DWORD

Estilos de janela para a barra de ferramentas. O estilo WS_CHILD é incluído por padrão. Esse parâmetro também pode incluir uma combinação de estilos, conforme discutido em Controle da Barra de Ferramentas e Estilos de Botão.

wID

Tipo: UINT

Identificador de controle para a barra de ferramentas.

nBitmaps

Tipo: int

Número de imagens de botão contidas no bitmap especificado por hBMInst e wBMID.

hBMInst

Tipo: HINSTANCE

Instância do módulo com o arquivo executável que contém o recurso bitmap.

wBMID

Tipo: UINT_PTR

Identificador de recurso para o recurso bitmap. Se hBMInst for NULL, esse parâmetro deverá ser um identificador de bitmap válido.

lpButtons

Tipo: LPCTBBUTTON

Ponteiro para uma matriz de estruturas TBBUTTON que contêm informações sobre os botões a serem adicionados à barra de ferramentas.

iNumButtons

Tipo: int

Número de botões a serem adicionados à barra de ferramentas.

dxButton

Tipo: int

Largura, em pixels, dos botões a serem adicionados à barra de ferramentas.

dyButton

Tipo: int

Altura, em pixels, dos botões a serem adicionados à barra de ferramentas.

dxBitmap

Tipo: int

Largura, em pixels, das imagens de botão a serem adicionadas aos botões na barra de ferramentas.

dyBitmap

Tipo: int

Altura, em pixels, das imagens de botão a serem adicionadas aos botões na barra de ferramentas.

uStructSize

Tipo: UINT

Tamanho de uma estrutura TBBUTTON .

Retornar valor

Tipo: HWND

Retorna o identificador de janela para a barra de ferramentas se tiver êxito ou NULL caso contrário. Para recuperar informações de erro estendidas, chame GetLastError.

Comentários

Windows 95: o sistema pode dar suporte a no máximo 16.364 identificadores de janela.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho commctrl.h
Biblioteca Comctl32.lib
DLL Comctl32.dll
Conjunto de APIs ext-ms-win-shell-comctl32-window-l1-1-0 (introduzido no Windows 10, versão 10.0.14393)