Partilhar 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 de CToolBar

Gráfico de hierarquia

CToolBar::Create

CToolBar::SetButtonInfo

CToolBar::SetButtonStyle

CToolBar::LoadToolBar