Partilhar via


CReBarCtrl::InsertBand

Implementa o comportamento de mensagem RB_INSERTBANDWin32, como descrito em Windows SDK.

BOOL InsertBand(
   UINT uIndex,
   REBARBANDINFO* prbbi 
);

Parâmetros

  • uIndex
    Índice com base zero do local onde a faixa será inserida.Se você definir este parâmetro para -1, o controle irá adicionar o novo no local e o último.

  • prbbi
    Um ponteiro a estrutura de REBARBANDINFO que define a faixa a ser inserido.Você deve definir o membro de cbSize de essa estrutura para sizeof(REBARBANDINFO) antes de chamar a função.

Valor de retorno

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

Exemplo

REBARBANDINFO rbbi = {0};
rbbi.cbSize = sizeof(rbbi);

TCHAR szText[80];
rbbi.lpText = szText;
rbbi.cch = sizeof(szText) / sizeof(szText[0]);

rbbi.fMask = RBBIM_BACKGROUND | RBBIM_CHILD |
    RBBIM_CHILDSIZE | RBBIM_COLORS | RBBIM_HEADERSIZE |
    RBBIM_IDEALSIZE | RBBIM_ID | RBBIM_IMAGE |
    RBBIM_LPARAM | RBBIM_SIZE | RBBIM_STYLE | RBBIM_TEXT;

m_wndReBar.GetReBarCtrl().GetBandInfo(0, &rbbi);

m_wndReBar.GetReBarCtrl().InsertBand(1, &rbbi);      

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe de CReBarCtrl

Gráfico de hierarquia