Classe CMFCReBar

Um objeto é uma barra de controlo que fornece informações de CMFCReBar layout, persistência e estado para os controlos de vergalhões. Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

Sintaxe

class CMFCReBar : public CPane

Membros

Métodos Públicos

Observações

Um CMFCReBar objeto pode conter uma variedade de janelas filhas. Isto inclui caixas de edição, barras de ferramentas e caixas de lista. Pode redimensionar a barra de ferro programaticamente, ou o utilizador pode redimensioná-la manualmente arrastando a barra de agarre. Também podes definir o fundo de um objeto de barra de ferro para um bitmap à tua escolha.

Um objeto de barra de ferro comporta-se de forma semelhante a um objeto de barra de ferramentas. Um controlo de barra pode conter uma ou mais bandas, e cada banda pode conter uma barra de pinça, um bitmap, uma etiqueta de texto e uma janela filha.

Example

O exemplo seguinte demonstra como usar vários métodos na CMFCReBar aula. O exemplo mostra como criar um controlo de vergalhão e adicionar uma banda a ele. A banda funciona como uma barra de ferramentas interna. Este excerto de código faz parte do exemplo do Rebar Test.

CMFCReBar m_wndReBar;

// Each rebar pane will occupy 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

Requerimentos

Cabeçalho: afxRebar.h

CMFCReBar::AddBar

Adiciona uma faixa a um vergalhão.

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
[inspira, expira] Um apontador para a janela filho que deve ser inserida no vergalhão. O objeto referenciado deve ter o estilo WS_CHILD janela.

pszText
[dentro] Especifica o texto a aparecer no vergalhão. O texto não faz parte da janela filha. Em vez disso, é exibido no próprio vergalhão.

PBMP
[inspira, expira] Especifica o bitmap a ser exibido no fundo do vergalhão.

dwStyle
[dentro] Contém o estilo a aplicar à banda. Para uma lista completa de estilos de bandas, consulte a descrição de fStyle na estrutura REBARBANDINFO na documentação do SDK do Windows.

clrFore
[dentro] Representa a cor em primeiro plano do vergalhão.

clrBack
[dentro] Representa a cor de fundo do vergalhão.

Valor de retorno

TRUE se a banda fosse adicionada com sucesso ao vergalhão; caso contrário, FALSO.

CMFCReBar::Create

Cria o controlo de barra e liga-o 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
[inspira, expira] Um apontador para a janela principal deste controlo de vergalhões.

dwCtrlStyle
[dentro] Especifica o estilo para o controlo do vergalhão. O valor padrão do estilo é RBS_BANDBORDERS, que mostra linhas estreitas para separar as bandas adjacentes no controlo do vergalhão. Para uma lista de estilos válidos, consulte Estilos de Controlo de Vergalhão na documentação do SDK do Windows.

dwStyle
[dentro] O estilo de janela do controlo de vergalhões. Para uma lista de estilos válidos, veja Estilos de Janela.

nID
[dentro] O ID da janela infantil do vergalhão.

Valor de retorno

VERDADE se o vergalhão tiver sido criado com sucesso; caso contrário, FALSO.

Observações

CMFCReBar::GetReBarCtrl

Fornece acesso direto ao CReBarCtrl controlo comum subjacente para CMFCReBar objetos.

CReBarCtrl& GetReBarCtrl() const;

Valor de retorno

Uma referência ao objeto subjacente CReBarCtrl .

Observações

Chame este método para tirar partido da funcionalidade comum de controlo do ferro de ferro do Windows ao personalizar o seu vergalhão.

CMFCReBar::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parâmetros

[dentro] bStretch
[dentro] bHorz

Valor de retorno

Observações

CMFCReBar::CanFloat

virtual BOOL CanFloat() const;

Valor de retorno

Observações

CMFCReBar::EnableDocking

void EnableDocking(DWORD dwDockStyle);

Parâmetros

[dentro] dwDockStyle

Observações

CMFCReBar::GetReBarBandInfoSize

UINT GetReBarBandInfoSize() const;

Valor de retorno

Observações

CMFCReBar::OnShowControlBarMenu

virtual BOOL OnShowControlBarMenu(CPoint);

Parâmetros

[dentro] CPoint

Valor de retorno

Observações

CMFCReBar::OnToolHitTest

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

Parâmetros

[dentro] ponto
[dentro] pTI

Valor de retorno

Observações

CMFCReBar::OnUpdateCmdUI

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

Parâmetros

[dentro] pTarget
[dentro] bDisableSeNoHndler

Observações

CMFCReBar::SetPaneAlignment

virtual void SetPaneAlignment(DWORD dwAlignment);

Parâmetros

[dentro] dwAlignment

Observações

Consulte também

Gráfico de Hierarquia
Classes
Classe CReBarCtrl
Classe CPane