CToolBarCtrl::AddButtons

BOOL AddButtons ( int nNumButtons, LPTBBUTTON lpButtons );

Valor devuelto

Distinto de cero si es correcto; caso contrario cero.

Parámetros

nNumButtons

Número de botones para agregar.

lpButtons

Dirección de una matriz de estructuras TBBUTTON que contiene información acerca de los botones para agregar. Debe haber el mismo número de elementos de la matriz como botones especificado por nNumButtons.

Observaciones

Llame a esta función para agregar uno o varios botones a un control de barra de herramientas.

El puntero lpButtons apunta a una matriz de estructuras TBBUTTON . Cada estructura TBBUTTON associates el botón que se agregan con el botón estilo, imagen o cadena, comando ID, Estado y datos definidos por el usuario:

typedef struct _TBBUTTO&N {}
int iBitmap; / / cero índice de imagen de botón
int idCommand; nbsp; / / comando para enviarse cuando presiona el botón
BYTE fsState;   / / botón Estado--ver más abajo
BYTE fsStyle;   / / botón estilo--ver más abajo
DWORD dwData;   / / aplicación definido valor
int iString; / / índice basado en cero del botón de etiqueta cadena
} TBBUTTON

Los miembros son los siguientes:

iBitmap

Índice de base cero de la imagen del botón. NULL si no hay ninguna imagen para este botón.

idCommand

Identificador de comando asociado al botón. Este identificador se envía un mensaje WM_COMMAND cuando el botón está seleccionado. Si el miembro de fsStyle tiene el valor TBSTYLE_SEP , este miembro debe ser cero.

fsState

Indicadores de estado de botón. Puede ser una combinación de los valores enumerados a continuación:

• TBSTATE_CHECKED   Tiene el estilo TBSTYLE_CHECKED y se está presionando el botón.
  
  
• TBSTATE_E&NABLEDnbsp;  El botón acepta datos del usuario. Un botón que no tiene este Estado no acepta entrada de usuario y está desactivado.
  
  
• TBSTATE_HIDDE&Nnbsp;  El botón no está visible y no puede recibir entradas del usuario.
  
  
• TBSTATE_I&NDETERMINATEnbsp;  El botón está atenuado.
  
  
• TBSTATE_PRESSED   Se está presionando el botón.
  
  
• TBSTATE_WRAPnbsp;  Un salto de línea sigue el botón. El botón también debe tener el estado TBSTATE_E&NABLED.

fsStyle

Estilo de botón. Puede ser una combinación de los valores enumerados a continuación:

• TBSTYLE_BUTTO&Nnbsp;  Crea un botón de comando estándar.
  
  
• TBSTYLE_CHECKnbsp;  Crea un botón que permite alternar entre los Estados presionados y los cada vez que el usuario hace clic en él. El botón tiene un color de fondo diferente cuando está en estado presionado. & nbsp;
  
  
• TBSTYLE_CHECKGROUP   Crea un botón de comprobar que se mantiene presionado hasta que se pulsa otro botón en el grupo.
  
  
• TBSTYLE_GROUP   Crea un botón que permanece presionado hasta que se pulsa otro botón en el grupo.
  
  
• TBSTYLE_SEP   Crea un separador, proporcionando un pequeño hueco entre grupos de botones. Un botón que tiene este estilo no recibir entradas del usuario.

dwData

Datos definidos por el usuario.

iString

Índice de base cero de la cadena que se va a utilizar como etiqueta del botón. NULL si no hay ninguna cadena para este botón.

La imagen o la cadena cuyo índice que proporcione debe previamente se agregaron a la barra de herramientas lista del control mediante AddBitmap, AddStringy AddStrings.

Visió&n General de CToolBarCtrl |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;CToolBarCtrl::InsertButton, CToolBarCtrl::DeleteButton, CToolBarCtrl::AddBitmap, CToolBarCtrl::AddString, CToolBarCtrl::AddStrings