CToolBarCtrl::AddButtons
Agregue uno o varios botones a un control toolbar.
BOOL AddButtons(
int nNumButtons,
LPTBBUTTON lpButtons
);
Parámetros
nNumButtons
Número de botones a agregar.lpButtons
Dirección de una matriz de estructuras de TBBUTTON que contiene información sobre los botones para agregar. Debe haber el mismo número de elementos de la matriz como botones especificados por nNumButtons.
Valor devuelto
Distinto de cero si correctamente; si no cero.
Comentarios
Los puntos del puntero de lpButtons a una matriz de estructuras de TBBUTTON . Cada estructura de TBBUTTON asocia el botón que se agrega al estilo de botón, la imagen o la cadena, el id. de comando, estado, y los datos definidos por el usuario:
typedef struct _TBBUTTON {
int iBitmap;// zero-based index of button image
int idCommand; // command to be sent when button pressed
BYTE fsState; // button state--see below
BYTE fsStyle; // button style--see below
DWORD dwData; // application-defined value
int iString;// zero-based index of button label string
} TBBUTTON;
Los miembros son los siguientes:
iBitmap
Índice Cero- en función del botón, -1 si ninguna imagen de este botón.idCommand
Identificador de comandos asociado al botón. Este identificador se envía en un mensaje de WM_COMMAND cuando se elija el botón. Si el miembro de fsStyle tiene el valor de TBSTYLE_SEP , este miembro debe ser cero.fsState
Indicadores de estado del botón. Puede ser una combinación de los valores enumerados a continuación:El botón deTBSTATE_CHECKED The tiene el estilo de TBSTYLE_CHECKED y se presionando.
El botón deTBSTATE_ENABLED The acepta datos proporcionados por el usuario. Un botón que no tiene este estado no acepta datos proporcionados por el usuario y se atenúa.
El botón deTBSTATE_HIDDEN no está visible y no puede recibir los datos proporcionados por el usuario.
Se atenúa el botón deTBSTATE_INDETERMINATE The.
Se presione el botón deTBSTATE_PRESSED The.
El salto de línea deTBSTATE_WRAP A continuación el botón. El botón también debe tener el estado de TBSTATE_ENABLED .
fsStyle
Estilo de botón. Puede ser una combinación de los valores enumerados a continuación:TBSTYLE_BUTTON crea un botón de comando estándar.
TBSTYLE_CHECK crea un botón que alterna entre haber presionado y estados sin prensar el usuario hace clic en cada vez. El botón tiene un color de fondo diferente cuando está en el estado presionado.
TBSTYLE_CHECKGROUP crea un botón de comprobación que las estancias presionadas hasta otro botón en el grupo están presionadas.
TBSTYLE_GROUP crea un botón que mantenga presionado hasta que otro botón del grupo se presione.
TBSTYLE_SEP crea un separador, proporcionando un pequeño intervalo entre grupos de botones. Un botón que tiene este estilo no recibe los datos proporcionados por el usuario.
dwData
Datos definidos por el usuario.iString
Índice basado Cero- string a usar como etiqueta del botón, -1 si no hay ninguna cadena de este botón.
La imagen o la cadena cuyo índice proporcionado debe haberse agregado a la lista de control de barra de herramientas en AddBitmap, AddString, o AddStrings.
Requisitos
encabezado: afxcmn.h