Classe CReBar

Uma barra de controlo que fornece informações de layout, persistência e estado para os controlos de vergalhões.

Sintaxe

class CReBar : public CControlBar

Membros

Métodos Públicos

Observações

Um objeto de barra de reforço pode conter uma variedade de subjanelas, geralmente outros controles, incluindo caixas de edição, barras de ferramentas e caixas de listagem. Um objeto de barra de ferramentas pode exibir suas janelas filhas em um bitmap especificado. A sua aplicação pode redimensionar automaticamente a barra de ferro, ou o utilizador pode redimensioná-la manualmente clicando ou arrastando a barra de agarre.

Controlo de Vergalhões

Um objeto de barra de ferro comporta-se de forma semelhante a um objeto de barra de ferramentas. Uma barra de ferro utiliza o mecanismo de clique e arrastar para redimensionar as suas bandas. Um controlo de barra pode conter uma ou mais bandas, sendo que cada banda tem qualquer combinação de uma barra de agarre, um bitmap, uma etiqueta de texto e uma janela filha. No entanto, as bandas não podem conter mais do que uma janela filha.

CReBar utiliza a classe CReBarCtrl para fornecer a sua implementação. Pode aceder ao controlo do ferro através do GetReBarCtrl para tirar partido das opções de personalização do controlo. Para mais informações sobre controlos de vergalhões, veja CReBarCtrl. Para mais informações sobre o uso de controlos de vergalhões, veja Utilização de CReBarCtrl.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CControlBar

CReBar

Requerimentos

Cabeçalho: afxext.h

CReBar::AddBar

Chame esta função de membro para adicionar uma faixa ao 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
Um apontador para um CWnd objeto que é a janela filha a ser inserido no vergalhão. O objeto referenciado deve ter uma WS_CHILD.

lpszText
Um apontador para uma string contendo o texto a aparecer no vergalhão. NULL por defeito. O texto contido em lpszText não faz parte da janela filho; Está no próprio vergalhão.

PBMP
Um apontador para um CBitmap objeto a ser exibido no fundo do vergalhão. NULL por defeito.

dwStyle
Um DWORD contendo o estilo a aplicar no vergalhão. Consulte a fStyle descrição da função na estrutura Win32 REBARBANDINFO para uma lista completa de estilos de banda.

clrFore
Um valor COLORREF que representa a cor em primeiro plano do vergalhão.

clrBack
Um valor COLORREF que representa a cor de fundo do vergalhão.

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

Example

// Define a CRebar in your class definition,
// such as: CReBar m_wndReBar;
m_wndReBar.Create(this);
m_wndDlgBar.Create(this, IDD_DIALOGBAR, CBRS_ALIGN_TOP,
                   IDD_DIALOGBAR);
m_wndReBar.AddBar(&m_wndDlgBar);

CReBar::Create

Chame esta função de elemento para criar uma barra de armadura.

virtual 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
Apontador para o CWnd objeto cuja janela do Windows é o pai da barra de estado. Normalmente, a janela da moldura.

dwCtrlStyle
O estilo de controlo do vergalhão. Por defeito, RBS_BANDBORDERS, que apresenta linhas estreitas para separar as bandas adjacentes dentro do controlo do vergalhão. Consulte Estilos de Controlo de Vergalhão no SDK do Windows para uma lista de estilos.

dwStyle
Os estilos de vergalhões de vergalhão.

nID
O ID da janela infantil do vergalhão.

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

Example

Veja o exemplo do CReBar::AddBar.

CReBar::GetReBarCtrl

Esta função membro permite o acesso direto ao controlo comum subjacente.

CReBarCtrl& GetReBarCtrl() const;

Valor de retorno

Uma referência a um objeto CReBarCtrl .

Observações

Chame esta função de membro para tirar partido da funcionalidade do controlo comum do ferro de ferro do Windows na personalização do seu vergalhão. Quando chamas GetReBarCtrl, devolve um objeto de referência ao CReBarCtrl objeto para que possas usar qualquer conjunto de funções membros.

Para mais informações sobre como personalizar CReBarCtrl o seu vergalhão, veja Usar CReBarCtrl.

Example

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();

UINT nBandCount = refReBarCtrl.GetBandCount();
CString msg;
msg.Format(_T("Band Count is: %u"), nBandCount);
AfxMessageBox(msg);

Consulte também

MFCIE de Exemplo MFC
Classe CControlBar
Gráfico de Hierarquia