CToolBarCtrl::AddButtons
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 um vetor de estruturas de TBBUTTON que contém informações sobre os botões para adicionar.Deve haver o mesmo número de elementos da matriz como botões especificados por nNumButtons.
Valor de retorno
Diferente de zero se com êxito; se não zero.
Comentários
Os pontos do ponteiro de lpButtons a um vetor de estruturas de TBBUTTON .Cada estrutura de TBBUTTON associa o botão sendo adicionado com o estilo de botão, a imagem e/ou a cadeia de caracteres, a identificação do comando, o estado, e os 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;
Os membros são:
iBitmap
Índice com base zero de imagem do botão, -1 se nenhuma imagem para este botão.idCommand
Identificador de comando associado com o botão.Este identificador é enviado em uma mensagem de WM_COMMAND quando o botão é escolhida.Se o membro de fsStyle tem o valor de TBSTYLE_SEP , esse membro deve ser zero.fsState
Sinalizadores de estado do botão.Pode ser uma combinação de valores listados abaixo:TBSTATE_CHECKED o botão tem o estilo de TBSTYLE_CHECKED e está sendo pressionado.
TBSTATE_ENABLED o botão aceita entrada do usuário.Um botão que não têm esse estado não aceita entrada do usuário e é esmaecida.
TBSTATE_HIDDEN o botão não é visível e não pode receber entrada do usuário.
TBSTATE_INDETERMINATE o botão é esmaecida.
TBSTATE_PRESSED o botão está sendo pressionado.
a quebra deTBSTATE_WRAP A seguir o botão.O botão também deve ter o estado de TBSTATE_ENABLED .
fsStyle
Estilo do botão.Pode ser uma combinação de valores listados abaixo:TBSTYLE_BUTTON cria um botão de ação padrão.
TBSTYLE_CHECK cria um botão que alterna entre /desativar pressionado e estados folgados cada vez que o usuário clique em.O botão tem uma cor de plano de fundo diferente quando está no estado pressionado.
TBSTYLE_CHECKGROUP cria um botão de verificação que fique pressionado até que outro botão no grupo está pressionada.
TBSTYLE_GROUP cria um botão que fique pressionado até que outro botão no grupo está pressionada.
TBSTYLE_SEP cria um separador, fornecendo um pequeno intervalo entre grupos de botões.Um botão que possui esse estilo não recebe entrada do usuário.
dwData
Dados definidos pelo usuário.iString
Índice com base zero de cadeia de caracteres para usar como o rótulo do botão, -1 se não houver nenhuma cadeia de caracteres para este botão.
A imagem e/ou a cadeia de caracteres cujo índice que você fornece anteriormente deve ter sido adicionado à lista de controle de barra de ferramentas usando AddBitmap, AddString, e/ou AddStrings.
Requisitos
Cabeçalho: afxcmn.h