Classe CReBar

Barra di controllo che fornisce le informazioni su layout, persistenza e stato per i controlli Rebar.

Sintassi

class CReBar : public CControlBar

Membri

Metodi pubblici

Nome	Descrizione
CReBar::AddBar	Aggiunge una banda a una barra di ripetizione.
CReBar::Create	Crea il controllo rebar e lo collega all'oggetto CReBar .
CReBar::GetReBarCtrl	Consente l'accesso diretto al controllo comune sottostante.

Osservazioni:

Un oggetto rebar può contenere diverse finestre figlio, in genere altri controlli, incluse le caselle di modifica, le barre degli strumenti e le caselle di riepilogo. Un oggetto rebar può visualizzare le finestre figlio proprie su una bitmap specificata. L'applicazione può ridimensionare automaticamente la barra di ripristino oppure l'utente può ridimensionare manualmente la barra di ridimensionamento facendo clic o trascinando la barra del gripper.

Controllo Rebar

Un oggetto rebar si comporta in modo analogo a un oggetto barra degli strumenti. Una barra di ripetizione usa il meccanismo click-and-drag per ridimensionare le relative bande. Un controllo Rebar può contenere una o più bande, con ciascuna banda che contiene una combinazione qualsiasi di una barra verticale di ridimensionamento, una bitmap, un'etichetta di testo e una finestra figlio. Tuttavia, le bande non possono contenere più di una finestra figlio.

CReBar usa la classe CReBarCtrl per fornire la relativa implementazione. È possibile accedere al controllo rebar tramite GetReBarCtrl per sfruttare le opzioni di personalizzazione del controllo. Per altre informazioni sui controlli rebar, vedere CReBarCtrl. Per altre informazioni sull'uso dei controlli rebar, vedere Uso di CReBarCtrl.

Attenzione

Gli oggetti controllo Rebar e rebar non supportano l'ancoraggio della barra di controllo MFC. Se CRebar::EnableDocking viene chiamato, l'applicazione asserisce.

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

Ccontrolbar

CReBar

Requisiti

Intestazione: afxext.h

CReBar::AddBar

Chiamare questa funzione membro per aggiungere una banda alla barra di ripristino.

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
Puntatore a un CWnd oggetto che rappresenta la finestra figlio da inserire nella barra di ripristino. L'oggetto a cui si fa riferimento deve avere un WS_CHILD.

lpszText
Puntatore a una stringa contenente il testo da visualizzare sulla barra di ripristino. NULL per impostazione predefinita. Il testo contenuto in lpszText non fa parte della finestra figlio, ma si trova sulla barra di ripristino stessa.

pbmp
Puntatore a un CBitmap oggetto da visualizzare sullo sfondo della barra di ripristino. NULL per impostazione predefinita.

dwStyle
DWORD contenente lo stile da applicare alla barra di ripristino. Per un elenco completo degli stili di banda, vedi la descrizione della fStyle funzione nella struttura Win32 REBARBANDINFO .

clrFore
Valore COLORREF che rappresenta il colore di primo piano della barra di ripristino.

clrBack
Valore COLORREF che rappresenta il colore di sfondo della barra di ripristino.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Esempio

// 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

Chiamare questa funzione membro per creare una barra di ripristino.

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

Parametri

pParentWnd
Puntatore all'oggetto CWnd la cui finestra di Windows è l'elemento padre della barra di stato. Normalmente la finestra cornice.

dwCtrlStyle
Stile del controllo rebar. Per impostazione predefinita, RBS_BANDBORDERS, che visualizza linee strette per separare le bande adiacenti all'interno del controllo rebar. Per un elenco di stili, vedi Stili di controllo della barra di ripristino in Windows SDK.

dwStyle
Stili della finestra della barra di riesezione.

nID
ID finestra figlio della barra di ripristino.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Esempio

Vedere l'esempio per CReBar::AddBar.

CReBar::GetReBarCtrl

Questa funzione membro consente l'accesso diretto al controllo comune sottostante.

CReBarCtrl& GetReBarCtrl() const;

Valore restituito

Riferimento a un oggetto CReBarCtrl .

Osservazioni:

Chiamare questa funzione membro per sfruttare le funzionalità del controllo comune della barra di ripristino di Windows nella personalizzazione della barra di ripristino. Quando si chiama GetReBarCtrl, restituisce un oggetto riferimento all'oggetto CReBarCtrl in modo da poter usare uno dei set di funzioni membro.

Per altre informazioni sull'uso CReBarCtrl di per personalizzare la barra di ripristino, vedere Uso di CReBarCtrl.

Esempio

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();

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

Vedi anche

Esempio MFCIE di MFC
CControlBar Class
Grafico della gerarchia