Compartilhar via


CToolBar::SetButtons

Essa função de membro define a identificação do comando de cada botão da barra de ferramentas para o valor especificado pelo elemento correspondente da matriz lpIDArray.

BOOL SetButtons( 
   const UINT* lpIDArray, 
   int nIDCount  
);

Parâmetros

  • lpIDArray
    Ponteiro para uma matriz de Ids de comando. Pode ser NULO para atribuir os botões vazios.

  • nIDCount
    O número de elementos da matriz apontado por lpIDArray.

Valor de retorno

Diferente de zero se com êxito; se não 0.

Comentários

Se um elemento de matriz tem o valor ID_SEPARATOR, um separador é criado na posição correspondente da barra de ferramentas. Essa função também define o estilo de cada botão para TBBS_BUTTON e estilo de cada separador a TBBS_SEPARATOR, e atribui um índice da imagem para cada botão. O índice da imagem especifica a posição de imagem do botão dentro de bitmap.

Você não precisa considerar do bitmap como essa função não aloca índices de imagem para separadores. Se a barra de ferramentas tem botões em posições 0, 1 e 3, e um separador na posição 2, as imagens nas posições 0, 1, 2 e no bitmap são atribuídas aos botões as posições 0, 1, e 3, respectivamente.

Se lpIDArray é NULO, essa função atribui o espaço para o número de itens especificados por nIDCount. Use SetButtonInfo para definir os atributos de cada item.

Requisitos

Cabeçalho: afxext.h

Consulte também

Referência

Classe CToolBar

Gráfico da hierarquia

CToolBar::Create

CToolBar::SetButtonInfo

CToolBar::SetButtonStyle

CToolBar::LoadToolBar