Classe CMFCReBar

Um objeto CMFCReBar é uma barra de controle que fornece informações de layout, persistência e estado para controles rebar. Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

Sintaxe

class CMFCReBar : public CPane

Membros

Métodos públicos

Comentários

Um objeto CMFCReBar pode conter uma variedade de janelas filho. Isso inclui caixas de edição, barras de ferramentas e caixas de listagem. Você pode redimensionar o controle rebar novamente de modo programático ou o usuário pode redimensionar o controle rebar de modo manual arrastando sua barra de garra. Você também pode definir a tela de fundo de um objeto de controle rebar como um bitmap de sua escolha.

Um objeto rebar se comporta de maneira semelhante a um objeto de barra de ferramentas. Um controle rebar pode conter uma ou mais bandas, e cada banda pode conter uma barra de garra, um bitmap, um rótulo de texto e uma janela filho.

Exemplo

O exemplo a seguir demonstra como usar vários métodos na classe CMFCReBar. O exemplo mostra como criar um controle rebar e adicionar uma banda a ele. A banda funciona como uma barra de ferramentas interna. Esse snippet de código faz parte do exemplo de Teste de Controle Rebar.

CMFCReBar m_wndReBar;

// Each rebar pane will ocupy its own row:
DWORD dwStyle = RBBS_GRIPPERALWAYS | RBBS_FIXEDBMP | RBBS_BREAK;
// CMFCMenuBar m_wndMenuBar
// CMFCToolBar m_wndToolBar
if (!m_wndReBar.Create(this) ||
    !m_wndReBar.AddBar(&m_wndMenuBar) ||
    !m_wndReBar.AddBar(&m_wndToolBar, NULL, NULL, dwStyle))
{
   TRACE0("Failed to create rebar\n");
   return -1; // fail to create
}

Hierarquia de herança

CObject
└ CCmdTarget
 └ CWnd
  └ CBasePane
   └ CPane
    └ CMFCReBar

Requisitos

Cabeçalho: afxRebar.h

CMFCReBar::AddBar

Adiciona uma banda a um rebar.

BOOL AddBar(
    CWnd* pBar,
    LPCTSTR pszText = NULL,
    CBitmap* pbmp = NULL,
    DWORD dwStyle = RBBS_GRIPPERALWAYS | RBBS_FIXEDBMP);

BOOL AddBar(
    CWnd* pBar,
    COLORREF clrFore,
    COLORREF clrBack,
    LPCTSTR pszText = NULL,
    DWORD dwStyle = RBBS_GRIPPERALWAYS);

Parâmetros

pBar
[in, out] Um ponteiro para a janela filho que deve ser inserida no controle rebar. O objeto referenciado deve ter o estilo de janela WS_CHILD.

pszText
[in] Especifica o texto a ser exibido no controle rebar. O texto não faz parte da janela filho. Em vez disso, ele é exibido no controle rebar em si.

pbmp
[in, out] Especifica o bitmap a ser exibido na tela de fundo do controle rebar.

dwStyle
[in] Contém o estilo a ser aplicado à banda. Para obter uma lista completa de estilos de banda, confira a descrição de fStyle na estrutura REBARBANDINFO na documentação do SDK do Windows.

clrFore
[in] Representa a cor de primeiro plano do controle rebar.

clrBack
[in] Representa a cor da tela de fundo do controle rebar.

Valor de retorno

TRUE se a banda foi adicionada com êxito ao controle rebar; caso contrário, FALSE.

CMFCReBar::Create

Cria o controle rebar e o anexa ao objeto CMFCReBar.

BOOL Create(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle = RBS_BANDBORDERS,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN | CBRS_TOP,
    UINT nID = AFX_IDW_REBAR);

Parâmetros

pParentWnd
[in, out] Um ponteiro para a janela pai deste controle rebar.

dwCtrlStyle
[in] Especifica o estilo do controle rebar. O valor de estilo padrão é RBS_BANDBORDERS, que exibe linhas estreitas para separar bandas adjacentes no controle rebar. Para uma lista de estilos válidos, confira Estilos de controle rebar na documentação do SDK do Windows.

dwStyle
[in] O estilo da janela do controle rebar. Para uma lista de estilos válidos, confira Estilos de Janela.

Nid
[in] A ID da janela filho do controle rebar.

Valor de retorno

TRUE se o controle rebar tiver sido criado com êxito; caso contrário, FALSE.

Comentários

CMFCReBar::GetReBarCtrl

Dá acesso direto ao controle comum subjacente CReBarCtrl para objetos CMFCReBar.

CReBarCtrl& GetReBarCtrl() const;

Valor de retorno

Uma referência ao objeto subjacente CReBarCtrl.

Comentários

Chame esse método para aproveitar a funcionalidade de controle comum rebar do Windows ao personalizar seu controle rebar.

CMFCReBar::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parâmetros

[in] bStretch
[in] bHorz

Valor de retorno

Comentários

CMFCReBar::CanFloat

virtual BOOL CanFloat() const;

Valor de retorno

Comentários

CMFCReBar::EnableDocking

void EnableDocking(DWORD dwDockStyle);

Parâmetros

[in] dwDockStyle

Comentários

CMFCReBar::GetReBarBandInfoSize

UINT GetReBarBandInfoSize() const;

Valor de retorno

Comentários

CMFCReBar::OnShowControlBarMenu

virtual BOOL OnShowControlBarMenu(CPoint);

Parâmetros

[in] CPoint

Valor de retorno

Comentários

CMFCReBar::OnToolHitTest

virtual INT_PTR OnToolHitTest(
    CPoint point,
    TOOLINFO* pTI) const;

Parâmetros

[in] point
[in] pTI

Valor de retorno

Comentários

CMFCReBar::OnUpdateCmdUI

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

Parâmetros

[in] pTarget
[in] bDisableIfNoHndler

Comentários

CMFCReBar::SetPaneAlignment

virtual void SetPaneAlignment(DWORD dwAlignment);

Parâmetros

[in] dwAlignment

Comentários

Confira também

Gráfico da hierarquia
Classes
Classe CReBarCtrl
Classe CPane