Condividi tramite


Classe di CMFCCaptionBar

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

Bb983960.collapse_all(it-it,VS.110).gifMetodi 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.

Bb983960.collapse_all(it-it,VS.110).gifMetodi 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.

Bb983960.collapse_all(it-it,VS.110).gifMembri 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:

  1. Creare l'oggetto di CMFCCaptionBar.In genere, è necessario aggiungere la barra del titolo a una classe della finestra cornice.

  2. Chiamare il metodo di CMFCCaptionBar::Create per creare il controllo barra del titolo e per associarlo all'oggetto di CMFCCaptionBar.

  3. 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;
}

Gerarchia di ereditarietà

CObject

   CCmdTarget

      CWnd

         CBasePane

            CPane

               CMFCCaptionBar

Requisiti

Intestazione: afxcaptionbar.h

Vedere anche

Riferimenti

Grafico della gerarchia

Altre risorse

Classi MFC