Classe CMFCCaptionBar

Articolo
06/10/2015

Un oggetto di CMFCCaptionBar è una barra di controllo da visualizzare tre elementi: un pulsante, un'etichetta di testo e una bitmap. È possibile visualizzare solo un elemento di ogni tipo per volta. È possibile allineare ogni elemento a sinistra o al bordo destro del controllo o al centro. È inoltre possibile applicare un piano o uno stile tridimensionale ai bordi superiore e inferiore dell'elevato della barra del titolo.

class CMFCCaptionBar : public CPane

Membri

Metodi pubblici

Nome	Descrizione
CMFCCaptionBar::Create	Crea il controllo barra del titolo e lo aggiunge all'oggetto di CMFCCaptionBar.
CMFCCaptionBar::DoesAllowDynInsertBefore	Indica se un altro riquadro può essere inserito dinamicamente dalla barra del titolo e il relativo frame padre. (Override CBasePane::DoesAllowDynInsertBefore).
CMFCCaptionBar::EnableButton	Abilita o disabilita il pulsante sulla barra del titolo.
CMFCCaptionBar::GetAlignment	Restituisce l'allineamento dell'elemento specificato.
CMFCCaptionBar::GetBorderSize	Restituisce la dimensione del bordo della barra del titolo.
CMFCCaptionBar::GetButtonRect	Recupera il rettangolo di delimitazione del pulsante sulla barra del titolo.
CMFCCaptionBar::GetMargin	Restituisce la distanza tra il bordo degli elementi della barra del titolo e il bordo del controllo barra del titolo.
CMFCCaptionBar::IsMessageBarMode	Specifica se la barra del titolo è in modalità barra dei messaggi.
CMFCCaptionBar::RemoveBitmap	Rimuove l'immagine bitmap dalla barra del titolo.
CMFCCaptionBar::RemoveButton	Rimuove il pulsante della barra del titolo.
CMFCCaptionBar::RemoveIcon	Rimuove l'icona dalla barra del titolo.
CMFCCaptionBar::RemoveText	Rimuove l'etichetta di testo dalla barra del titolo.
CMFCCaptionBar::SetBitmap	L'immagine bitmap per la didascalia.
CMFCCaptionBar::SetBorderSize	Imposta la dimensione del bordo della barra del titolo.
CMFCCaptionBar::SetButton	Imposta il pulsante per la barra del titolo.
CMFCCaptionBar::SetButtonPressed	Specifica se la coerenza del pulsante hanno raggiunto.
CMFCCaptionBar::SetButtonToolTip	Imposta la descrizione comando per il pulsante.
CMFCCaptionBar::SetFlatBorder	Imposta lo stile del bordo della barra del titolo.
CMFCCaptionBar::SetIcon	Imposta l'icona per una didascalia.
CMFCCaptionBar::SetImageToolTip	Imposta la descrizione comando per l'immagine alla barra del titolo.
CMFCCaptionBar::SetMargin	Imposta la distanza tra il bordo dell'elemento barra del titolo e il bordo del controllo barra del titolo.
CMFCCaptionBar::SetText	Impostare l'etichetta di testo della didascalia.

Metodi protetti

Nome	Descrizione
CMFCCaptionBar::OnDrawBackground	Chiamato dal framework per riempire lo sfondo della didascalia.
CMFCCaptionBar::OnDrawBorder	Chiamato dal framework per disegnare il bordo della barra del titolo.
CMFCCaptionBar::OnDrawButton	Chiamato dal framework per disegnare il pulsante della barra del titolo.
CMFCCaptionBar::OnDrawImage	Chiamato dal framework per disegnare l'immagine della barra del titolo.
CMFCCaptionBar::OnDrawText	Chiamato dal framework per creare il testo della didascalia.

Membri di dati

Nome	Descrizione
CMFCCaptionBar::m_clrBarBackground	Il colore di sfondo della didascalia.
CMFCCaptionBar::m_clrBarBorder	Il colore del bordo della barra del titolo.
CMFCCaptionBar::m_clrBarText	Il colore del testo della didascalia.

Note

Per creare una barra del titolo, seguire questi passaggi:

Creare l'oggetto di CMFCCaptionBar. In genere, è necessario aggiungere la barra del titolo a una classe della finestra cornice.
Chiamare il metodo di CMFCCaptionBar::Create per creare il controllo barra del titolo e per associarlo all'oggetto di CMFCCaptionBar.
Chiamare CMFCCaptionBar::SetButton, CMFCCaptionBar::SetText, CMFCCaptionBar::SetIcone CMFCCaptionBar::SetBitmap per impostare gli elementi della barra del titolo.

Quando si imposta l'elemento pulsante, è necessario assegnare un ID di comando sul pulsante. Quando l'utente fa clic sul pulsante, la didascalia di destinazione dei messaggi di WM_COMMAND con questo ID alla finestra cornice padre.

La barra del titolo può anche essere utilizzata in modalità barra dei messaggi, che consente la barra dei messaggi che viene visualizzato nelle applicazioni Microsoft Office 2007. In modalità barra dei messaggi, la barra del titolo visualizzare una bitmap, un messaggio e un pulsante (in genere visualizzata una finestra di dialogo.) È possibile assegnare una descrizione comandi la bitmap.

Per abilitare la modalità della barra dei messaggi, chiamare CMFCCaptionBar::Create e il quarto parametro (bIsMessageBarMode) a TRUE.

Esempio

Nell'esempio seguente viene illustrato come utilizzare i vari metodi della classe di CMFCCaptionBar. L'esempio mostra come creare il controllo barra del titolo, impostare un bordo tridimensionale barra del titolo, impostare la distanza, in pixel, tra il bordo degli elementi della barra del titolo e il bordo del controllo barra del titolo, impostare il pulsante per la barra del titolo, impostare la descrizione comando per il pulsante, impostare l'etichetta di testo alla barra del titolo, impostare l'immagine bitmap alla barra del titolo e impostare la descrizione comando per l'immagine nella barra del titolo. Questo frammento di codice fa parte di Esempio 2007 demo di MS Office.

  CMFCCaptionBar m_wndMessageBar;


...


BOOL CMainFrame::CreateMessageBar()
{
    // The this pointer points to a CMainFrame class which extends the CFrameWndEx class. 
    if (!m_wndMessageBar.Create(WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS, this, ID_VIEW_MESSAGEBAR, -1, TRUE))
    {
        TRACE0("Failed to create caption bar\n");
        return FALSE;
    }

    m_wndMessageBar.SetFlatBorder( FALSE );
    m_wndMessageBar.SetMargin(10);
    m_wndMessageBar.SetButton(_T("Options..."), ID_TOOLS_OPTIONS, CMFCCaptionBar::ALIGN_LEFT, FALSE);
    m_wndMessageBar.SetButtonToolTip(_T("Click here to see more options"));

    m_wndMessageBar.SetText(_T("Welcome to the MFC MSOffice2007 demonstration!"), CMFCCaptionBar::ALIGN_LEFT);

    m_wndMessageBar.SetBitmap(IDB_INFO, RGB(255, 255, 255), FALSE, CMFCCaptionBar::ALIGN_LEFT);
    m_wndMessageBar.SetImageToolTip(_T("Important"), _T("Please take a look at MSOffice2007Demo source code to learn how to create advanced user interface in minutes."));

    return TRUE;
}