Función CreateToolbarEx (commctrl.h)

Crea una ventana de barra de herramientas y agrega los botones especificados a la barra de herramientas.

Nota Esta función está en desuso, ya que no admite todas las características de las barras de herramientas. En su lugar, use CreateWindowEx . Para obtener ejemplos, consulte Uso de controles de barra de herramientas.

 

Sintaxis

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

Identificador de la ventana primaria de la barra de herramientas.

ws

Tipo: DWORD

Estilos de ventana para la barra de herramientas. El estilo WS_CHILD se incluye de forma predeterminada. Este parámetro también puede incluir una combinación de estilos como se describe en Control de barra de herramientas y Estilos de botón.

wID

Tipo: UINT

Identificador de control de la barra de herramientas.

nBitmaps

Tipo: int

Número de imágenes de botón contenidas en el mapa de bits especificado por hBMInst y wBMID.

hBMInst

Tipo: HINSTANCE

Instancia del módulo con el archivo ejecutable que contiene el recurso de mapa de bits.

wBMID

Tipo: UINT_PTR

Identificador de recurso del recurso de mapa de bits. Si hBMInst es NULL, este parámetro debe ser un identificador de mapa de bits válido.

lpButtons

Tipo: LPCTBBUTTON

Puntero a una matriz de estructuras TBBUTTON que contienen información sobre los botones que se van a agregar a la barra de herramientas.

iNumButtons

Tipo: int

Número de botones que se van a agregar a la barra de herramientas.

dxButton

Tipo: int

Ancho, en píxeles, de los botones que se van a agregar a la barra de herramientas.

dyButton

Tipo: int

Alto, en píxeles, de los botones que se van a agregar a la barra de herramientas.

dxBitmap

Tipo: int

Ancho, en píxeles, de las imágenes de botón que se van a agregar a los botones de la barra de herramientas.

dyBitmap

Tipo: int

Alto, en píxeles, de las imágenes de botón que se van a agregar a los botones de la barra de herramientas.

uStructSize

Tipo: UINT

Tamaño de una estructura TBBUTTON .

Valor devuelto

Tipo: HWND

Devuelve el identificador de la ventana a la barra de herramientas si se ejecuta correctamente o NULL de lo contrario. Para recuperar información de error extendida, llame a GetLastError.

Comentarios

Windows 95: el sistema puede admitir un máximo de 16 364 identificadores de ventana.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	commctrl.h
Library	Comctl32.lib
Archivo DLL	Comctl32.dll
Conjunto de API	ext-ms-win-shell-comctl32-window-l1-1-0 (introducido en Windows 10, versión 10.0.14393)