Classe CMFCReBar

Un CMFCReBar oggetto è una barra di controllo che fornisce informazioni sul layout, la persistenza e sullo stato per i controlli rebar. Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.

Sintassi

class CMFCReBar : public CPane

Membri

Metodi pubblici

Nome	Descrizione
CMFCReBar::AddBar	Aggiunge una banda a una barra di ripetizione.
CMFCReBar::CalcFixedLayout	(sostituzioni )CBasePane::CalcFixedLayout.
CMFCReBar::CanFloat	(sostituzioni )CBasePane::CanFloat.
CMFCReBar::Create	Crea il controllo rebar e lo collega all'oggetto CMFCReBar .
CMFCReBar::EnableDocking	(sostituzioni )CBasePane::EnableDocking.
CMFCReBar::GetReBarBandInfoSize
CMFCReBar::GetReBarCtrl	Fornisce l'accesso diretto al controllo comune CReBarCtrl sottostante.
CMFCReBar::OnShowControlBarMenu	(sostituzioni )CPane::OnShowControlBarMenu.
CMFCReBar::OnToolHitTest	(sostituzioni )CWnd::OnToolHitTest.
CMFCReBar::OnUpdateCmdUI	(sostituzioni )CBasePane::OnUpdateCmdUI.
CMFCReBar::SetPaneAlignment	(sostituzioni )CBasePane::SetPaneAlignment.

Osservazioni:

Un CMFCReBar oggetto può contenere un'ampia gamma di finestre figlio. Sono incluse caselle di modifica, barre degli strumenti e caselle di riepilogo. È possibile ridimensionare la barra di ridimensionamento a livello di codice oppure l'utente può ridimensionare manualmente la barra di ridimensionamento trascinando la barra di controllo. È anche possibile impostare lo sfondo di un oggetto rebar su una bitmap di propria scelta.

Un oggetto rebar si comporta in modo analogo a un oggetto barra degli strumenti. Un controllo rebar può contenere una o più bande e ogni banda può contenere una barra gripper, una bitmap, un'etichetta di testo e una finestra figlio.

Esempio

L'esempio seguente illustra come usare i vari metodi nella classe CMFCReBar . Nell'esempio viene illustrato come creare un controllo rebar e aggiungervi una banda. La banda funge da barra degli strumenti interna. Questo frammento di codice fa parte dell'esempio di test 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
}

Gerarchia di ereditarietà

CObject
└ CCmdTarget
 └ CWnd
  └ CBasePane
   └ CPane
    └ CMFCReBar

Requisiti

Intestazione: afxRebar.h

CMFCReBar::AddBar

Aggiunge una banda a una barra di ripetizione.

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);

Parametri

pBar
[in, out] Puntatore alla finestra figlio da inserire nella barra di ripristino. L'oggetto a cui si fa riferimento deve avere lo stile della finestra WS_CHILD .

pszText
[in] Specifica il testo da visualizzare sulla barra di ripristino. Il testo non fa parte della finestra figlio. Piuttosto, viene visualizzato sulla barra di rebar stessa.

pbmp
[in, out] Specifica la bitmap da visualizzare sullo sfondo della barra di ripristino.

dwStyle
[in] Contiene lo stile da applicare alla banda. Per un elenco completo degli stili di banda, vedere la descrizione per fStyle nella struttura REBARBANDINFO nella documentazione di Windows SDK.

clrFore
[in] Rappresenta il colore di primo piano della barra di ripristino.

clrBack
[in] Rappresenta il colore di sfondo della barra di ripristino.

Valore restituito

TRUE se la banda è stata aggiunta correttamente alla barra di ripristino; in caso contrario, FALSE.

CMFCReBar::Create

Crea il controllo rebar e lo collega all'oggetto 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);

Parametri

pParentWnd
[in, out] Puntatore alla finestra padre di questo controllo rebar.

dwCtrlStyle
[in] Specifica lo stile per il controllo rebar. Il valore di stile predefinito è RBS_BANDBORDERS, che visualizza linee strette per separare le bande adiacenti sul controllo rebar. Per un elenco di stili validi, vedi Stili di controllo della barra di ripristino nella documentazione di Windows SDK.

dwStyle
[in] Stile della finestra del controllo rebar. Per un elenco di stili validi, vedere Stili finestra.

nID
[in] ID finestra figlio della barra di ripristino.

Valore restituito

TRUE se la barra di ripristino è stata creata correttamente; in caso contrario, FALSE.

Osservazioni:

CMFCReBar::GetReBarCtrl

Fornisce l'accesso diretto al CReBarCtrl controllo comune sottostante per CMFCReBar gli oggetti .

CReBarCtrl& GetReBarCtrl() const;

Valore restituito

Riferimento all'oggetto sottostante CReBarCtrl .

Osservazioni:

Chiamare questo metodo per sfruttare le funzionalità di controllo comuni della barra di ripristino di Windows durante la personalizzazione della barra di ripristino.

CMFCReBar::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parametri

[in] bStretch
[in] bHorz

Valore restituito

Osservazioni:

CMFCReBar::CanFloat

virtual BOOL CanFloat() const;

Valore restituito

Osservazioni:

CMFCReBar::EnableDocking

void EnableDocking(DWORD dwDockStyle);

Parametri

[in] dwDockStyle

Osservazioni:

CMFCReBar::GetReBarBandInfoSize

UINT GetReBarBandInfoSize() const;

Valore restituito

Osservazioni:

CMFCReBar::OnShowControlBarMenu

virtual BOOL OnShowControlBarMenu(CPoint);

Parametri

[in] CPoint

Valore restituito

Osservazioni:

CMFCReBar::OnToolHitTest

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

Parametri

[in] punto
[in] Pti

Valore restituito

Osservazioni:

CMFCReBar::OnUpdateCmdUI

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

Parametri

[in] pTarget
[in] bDisableIfNoHndler

Osservazioni:

CMFCReBar::SetPaneAlignment

virtual void SetPaneAlignment(DWORD dwAlignment);

Parametri

[in] dwAlignment

Osservazioni:

Vedi anche

Grafico della gerarchia
Classi
Classe CReBarCtrl
Classe CPane