Partilhar via


Controles rebar e bandas

A principal finalidade de um controle de rebar é atuar como um contêiner para janelas filho, controla comuns da caixa de diálogo, menus, barras de ferramentas, e assim por diante. Essa retenção é suportada pelo conceito de uma faixa “.” Cada a faixa de rebar pode conter qualquer combinação de uma barra de tipo, um bitmap, de um rótulo de texto, e uma janela filho.

A classe CReBarCtrl tem muitas funções de membro que você pode usar para recuperar e manipular informações, para uma faixa específica de rebar:

  • GetBandCount recupera o número de linhas atuais no controle de rebar.

  • inicializaGetBandInfo uma estrutura de REBARBANDINFO com informações da faixa especificada. Há uma função de membro correspondente de SetBandInfo .

  • GetRect recupera o retângulo delimitador de uma faixa especificada.

  • GetRowCount recupera o número de linhas de faixa em um controle de rebar.

  • IDToIndex recupera o índice de uma faixa especificada.

  • GetBandBorders recupera as bordas de uma faixa.

Além da manipulação, várias funções de membro são contanto que permite funcionam em linhas específicas de rebar.

InsertBand e DeleteBand adicionar e remover faixas de rebar. MinimizeBand e MaximizeBand afetam o tamanho atual de uma faixa específica de rebar. MoveBand altera o índice de uma faixa específica de rebar. ShowBand mostra ou oculta uma faixa de rebar do usuário.

O exemplo a seguir demonstra como adicionar uma faixa da barra de ferramentas (m_wndToolBar) a um controle existente de rebar (m_wndReBar). A faixa é descrita inicializando a estrutura de rbi e chamando a função de membro de InsertBand :

//load bitmap for toolbar background
m_RebarBitmap.LoadBitmap(IDB_BITMAP1);

//create a toolbar band
m_Toolbar1.Create(this, TBSTYLE_TRANSPARENT | TBSTYLE_FLAT);
m_Toolbar1.LoadToolBar(IDR_MAINFRAME);

REBARBANDINFO rbi = {0};
rbi.cbSize = sizeof(REBARBANDINFO);
rbi.fMask = RBBIM_BACKGROUND | RBBIM_CHILD | RBBIM_CHILDSIZE | 
   RBBIM_STYLE | RBBIM_TEXT;
rbi.fStyle = RBBS_GRIPPERALWAYS;
rbi.cxMinChild = 300;
rbi.cyMinChild = 50;
rbi.lpText = _T("Band #1");
rbi.cch = 7;
rbi.cx = 300;
rbi.hbmBack = (HBITMAP)m_RebarBitmap;
rbi.hwndChild = (HWND)m_Toolbar1;
m_Rebar.GetReBarCtrl().InsertBand(0, &rbi);

Consulte também

Referência

Usando CReBarCtrl

Conceitos

Controles (MFC)