Klasa CMFCCaptionBar

Artykuł
02/27/2013

A CMFCCaptionBar obiekt jest pasek sterowania, który może wyświetlać trzy elementy: przycisk, etykietę tekstową i mapy bitowej.Umożliwia wyświetlanie tylko jeden element każdego typu na raz.Można dopasować każdy element, do lewej lub prawej krawędzi formantu lub na środku.Do górnej lub dolnej krawędzi paska podpisu, można również zastosować styl płaskim lub 3D.

class CMFCCaptionBar : public CPane

Elementy członkowskie

Metody publiczne

Nazwa	Opis
CMFCCaptionBar::Create	Tworzy formant paska podpisu i dołącza go do CMFCCaptionBar obiektu.
CMFCCaptionBar::DoesAllowDynInsertBefore	Wskazuje, czy innego okienka można dynamicznie wstawić między pasek podpisu i jego ramką nadrzędnej.(Zastępuje CBasePane::DoesAllowDynInsertBefore.)
CMFCCaptionBar::EnableButton	Włącza lub wyłącza przycisk na pasku podpisu.
CMFCCaptionBar::GetAlignment	Zwraca wyrównanie określonego elementu.
CMFCCaptionBar::GetBorderSize	Zwraca rozmiar obramowania pasek podpisu.
CMFCCaptionBar::GetButtonRect	Pobiera prostokąta otaczającego przycisk na pasku podpisu.
CMFCCaptionBar::GetMargin	Zwraca odległość między krawędzią elementów paska podpisu i krawędzią formantu paska podpisu.
CMFCCaptionBar::IsMessageBarMode	Określa, czy pasek podpisu jest w trybie pasek wiadomości.
CMFCCaptionBar::RemoveBitmap	Usuwa obraz bitmapowy z paska podpisu.
CMFCCaptionBar::RemoveButton	Usuwa przycisk z paska podpisu.
CMFCCaptionBar::RemoveIcon	Usuwa ikonę z paska podpisu.
CMFCCaptionBar::RemoveText	Usuwa tekst etykiety z paska podpisu.
CMFCCaptionBar::SetBitmap	Ustawia obraz mapy bitowej na pasku podpisu.
CMFCCaptionBar::SetBorderSize	Ustawia rozmiar obramowania pasek podpisu.
CMFCCaptionBar::SetButton	Ustawia przycisk na pasku podpisu.
CMFCCaptionBar::SetButtonPressed	Określa, czy przycisk pozostaje wciśnięty.
CMFCCaptionBar::SetButtonToolTip	Ustawia etykietki narzędzia dla przycisku.
CMFCCaptionBar::SetFlatBorder	Ustawia styl obramowania pasek podpisu.
CMFCCaptionBar::SetIcon	Ustawia ikonę paska podpisu.
CMFCCaptionBar::SetImageToolTip	Ustawia etykietki narzędzia obrazu na pasku podpisu.
CMFCCaptionBar::SetMargin	Ustawia odległość między krawędzią caption element paska i krawędzią formantu paska podpisu.
CMFCCaptionBar::SetText	Ustawia tekst etykiety dla paska podpisu.

Metody chronione

Nazwa	Opis
CMFCCaptionBar::OnDrawBackground	Wywołana przez narzędzia AIF, aby wypełnić tło paska podpisu.
CMFCCaptionBar::OnDrawBorder	Wywołana przez narzędzia AIF, aby narysować obramowanie paska podpisu.
CMFCCaptionBar::OnDrawButton	Wywoływana przez framework rysować przycisku paska paska tytułowego.
CMFCCaptionBar::OnDrawImage	Wywoływana przez framework narysować obraz paska podpisu.
CMFCCaptionBar::OnDrawText	Wywoływana przez framework rysować tekst paska podpisu.

Elementy członkowskie danych

Nazwa	Opis
CMFCCaptionBar::m_clrBarBackground	Kolor tła paska podpisu.
CMFCCaptionBar::m_clrBarBorder	Kolor obramowania pasek podpisu.
CMFCCaptionBar::m_clrBarText	Kolor tekstu paska podpisu.

Uwagi

Aby utworzyć pasek podpisu, wykonaj następujące kroki:

Budowy CMFCCaptionBar obiektu.Zazwyczaj należy dodać pasek podpisu do klasy okna ramki.
Call CMFCCaptionBar::Create do tworzenia formantu paska podpisu i dołączyć go do CMFCCaptionBar obiektu.
Call CMFCCaptionBar::SetButton, CMFCCaptionBar::SetText, CMFCCaptionBar::SetIcon, i CMFCCaptionBar::SetBitmap do ustawiania elementów paska podpisu.

Po ustawieniu element przycisku, należy przypisać identyfikator polecenia do przycisku.Kiedy użytkownik kliknie przycisk, podpis trasy pasek WM_COMMAND wiadomości, które mają ten identyfikator do okna ramki nadrzędnej.

Pasek podpisu można pracować w trybie pasek wiadomości, który emuluje pasek komunikatów, który pojawia się w aplikacjach pakietu Microsoft Office 2007.W trybie pasek wiadomości pasek podpisu Wyświetla mapy bitowej, wiadomości i przycisk (zwykle otwierający okno dialogowe.) Etykietka narzędzia można przypisać do bitmapy.

Aby włączyć tryb pasek wiadomości, wywołać CMFCCaptionBar::Create i ustawić czwarty parametr (bIsMessageBarMode) na TRUE.

Przykład

Poniższy przykład ilustruje sposób użycia różnych metod w CMFCCaptionBar klasy.W przykładzie pokazano, jak tworzyć formantu paska podpisu, ustaw 3D obramowanie paska podpisu, ustawić odległość w pikselach, między krawędziami caption bar elementów a krawędzią formantu paska podpisu, Ustaw przycisk na pasku podpisu, Ustawianie etykietki narzędzia dla przycisku, etykieta tekstowa dla paska podpisu, Ustaw obraz mapy bitowej dla paska podpisui ustaw etykietki narzędzia dla obrazu w pasku podpisu.Ten fragment kodu jest częścią próbki MS Office 2007 Demo.

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