CToolBarCtrl::AddButtons

Artigo
08/25/2010

Adiciona um ou mais botões a um controle de barra de ferramentas.

BOOL AddButtons(
   int nNumButtons,
   LPTBBUTTON lpButtons 
);

Parâmetros

nNumButtons
Número de botões para adicionar.
lpButtons
Endereço de uma matriz de TBBUTTON estruturas contendo informações sobre os botões para adicionar. Deve haver o mesmo número de elementos na matriz sistema autônomo botões especificado por nNumButtons.

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário, nenhum.

Comentários

The lpButtons ponteiro aponta para uma matriz de TBBUTTON estruturas. Cada TBBUTTON estrutura associa o botão que está sendo adicionado com o estilo do botão, estado de imagem e/ou seqüência de caracteres, ID de comando e dados definidos pelo usuário:

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;

sistema autônomo membros são:

iBitmap
Índice baseado em zero da imagem de botão, -1 se nenhuma imagem deste botão.
idCommand
Identificador de comando associado ao botão.Esse identificador é enviado em um WM_COMMAND mensagem quando o botão é selecionado.Se o fsStyle membro tem o TBSTYLE_SEP valor, esse membro deve ser zero.
fsState
Botão de sinalizadores de estado.Ele pode ser uma combinação dos valores listados abaixo:
- TBSTATE_CHECKED O botão tiver o TBSTYLE_CHECKED estilo e está sendo pressionado.
- TBSTATE_ENABLED O botão aceita a entrada do usuário. Um botão que não tenha este estado não aceita entrada do usuário e fica cinza.
- TBSTATE_HIDDEN O botão não estiver visível e não pode receber a entrada do usuário.
- TBSTATE_INDETERMINATE O botão fica cinza.
- TBSTATE_PRESSED O botão está sendo pressionado.
- TBSTATE_WRAP Uma quebra de linha segue o botão. O botão também deve ter o TBSTATE_ENABLED estado.
fsStyle
Estilo de botão.Ele pode ser uma combinação dos valores listados abaixo:
- TBSTYLE_BUTTON Cria um botão de ação padrão.
- TBSTYLE_CHECK Cria um botão que alterna entre os estados pressionados e unpressed cada vez que o usuário clica-lo. O botão tem uma cor do plano de fundo quando estiver em estado pressionado.
- TBSTYLE_CHECKGROUP Cria um botão de seleção permanece pressionado até que outro botão no agrupar é pressionado.
- TBSTYLE_GROUP Cria um botão que permanece pressionado até que outro botão no agrupar é pressionado.
- TBSTYLE_SEP Cria um separador, fornecendo um intervalo pequeno entre grupos de botão. Um botão que tiver esse estilo não recebe entradas de usuário.
dwData
Dados definidos pelo usuário.
iString
Índice baseado em zero da seqüência de caracteres a ser usado sistema autônomo o botão do rótulo, -1 se não houver nenhuma seqüência de caracteres para este botão.

A imagem e/ou seqüência de caracteres cujo índice você fornecer deverá ter anteriormente sido adicionada à lista do controle de barra de ferramentas usando AddBitmap, AddString, and/or AddStrings.