CToolBarCtrl:: AddButtons

BOOL AddButtons ( int nNumButtons, LPTBBUTTON lpButtons );

Valor de retorno

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

Parâmetros

nNumButtons

Número de botões para adicionar.

lpButtons

Endereço de uma matriz de TBBUTTON estruturas que contém informações sobre os botões para adicionar. Deve haver o mesmo número de elementos na matriz como botões especificado por nNumButtons.

Observações

Chame essa função para adicionar um ou mais botões a um Controlarar de barra de ferramentas.

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

typedef struct _TBBUTTO&N {
int iBitmap; / / baseada em zero índice de imagem do botão
int idCommand; nbsp; / / comando a ser enviado ao botão pressionado
BYTE fsState;   / / botão Estado-- ver abaixo
BYTE fsStyle;   / / botão estilo - ver abaixo
DWORD dwData;   / / aplicativo-definidos valor
int iString; / / índice baseado em zero do botão etiqueta Cadeia de caracteres
} TBBUTTON

Os membros são os seguintes:

iBitmap

Índice baseado em zero da imagem do botão. NULL se nenhuma imagem para este botão.

idCommand

Identificador de comando associado ao botão. Esse identificador é enviado em uma mensagem WM_COMMAND quando o botão é escolhido. Se o membro de fsStyle tem o valor TBSTYLE_SEP , esse membro deve ser zero.

fsState

Sinalizadores de estado do botão. Ele pode ser uma combinação dos valores listados abaixo:

TBSTATE_CHECKED O botão tem o estilo TBSTYLE_CHECKED e está sendo pressionado.
TBSTATE_E&NABLEDnbsp; O botão aceita entrada do usuário. Um botão que não tem esse Estado não aceita entrada do usuário e é cinza.
TBSTATE_HIDDE&Nnbsp; O botão não é visível e não pode receber entrada do usuário.
TBSTATE_I&NDETERMINATEnbsp; O botão é cinza.
TBSTATE_PRESSED O botão é pressionado.
TBSTATE_WRAPnbsp; Uma quebra de linha segue o botão. O botão também deve ter o TBSTATE_E&NABLED Estado.

fsStyle

Estilo do botão. Ele pode ser uma combinação dos valores listados abaixo:

TBSTYLE_BUTTO&Nnbsp; Cria um botão de envio padrão.
TBSTYLE_CHECKnbsp; Cria um botão que alterna entre os Estados pressionados e dos cada vez que o usuário clica nele. O botão tem uma cor de plano de fundo diferente quando ele está no estado pressionado. & nbsp;
TBSTYLE_CHECKGROUP Cria um botão de seleção que permanece pressionado até que outro botão no AAgruparar é pressionado.
TBSTYLE_GROUP Cria um botão que permanece pressionado até que outro botão no AAgruparar é pressionado.
TBSTYLE_SEP Cria um separador, fornecendo um pequeno intervalo entre grupos botão. Um botão que tem esse estilo não recebe entrada do usuário.

dwData

Dados definidos pelo usuário.

iString

Índice baseado em zero da Cadeia de caracteres para usar como o rótulo do botão. NULL 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 deve anteriormente foram adicionada à lista do Controlarar da barra de ferramentas usando AddBitmap, AddStringe/ou AddStrings.

Visão geral de CToolBarCtrl | Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CToolBarCtrl::InsertButton, CToolBarCtrl::DeleteButton, CToolBarCtrl::AddBitmap, CToolBarCtrl::AddString, CToolBarCtrl::AddStrings

Index