Třída CMFCCaptionBar

Článek
03/04/2013

A CMFCCaptionBar objekt je ovládací panel, který můžete zobrazit tři prvky: tlačítko textový popisek a rastrový obrázek.To může být zobrazit pouze jeden prvek každého typu.Můžete zarovnat každý prvek do levého nebo pravého okraje ovládacího prvku nebo na střed.Můžete také použít styl ploché nebo 3D na horní a dolní ohraničení záhlaví.

class CMFCCaptionBar : public CPane

Členy

Veřejné metody

Název	Description
CMFCCaptionBar::Create	Vytvoří ovládací prvek panel titulek a připojí jej CMFCCaptionBar objektu.
CMFCCaptionBar::DoesAllowDynInsertBefore	Označuje, zda jiného podokna můžete dynamicky vkládá mezi titulek a jeho nadřazený rámec.(Přepíše CBasePane::DoesAllowDynInsertBefore.)
CMFCCaptionBar::EnableButton	Povolí nebo zakáže tlačítko na panelu titulek.
CMFCCaptionBar::GetAlignment	Vrátí zarovnání daného elementu.
CMFCCaptionBar::GetBorderSize	Vrátí velikost ohraničení záhlaví.
CMFCCaptionBar::GetButtonRect	Načte ohraničovacího rámečku tlačítka v záhlaví.
CMFCCaptionBar::GetMargin	Vrátí vzdálenost mezi okrajem prvky panel titulek a okraj ovládací panel titulek.
CMFCCaptionBar::IsMessageBarMode	Určuje, zda je panel titulek v režimu panelu zpráva.
CMFCCaptionBar::RemoveBitmap	Rastrový obrázek odebere z panelu titulek.
CMFCCaptionBar::RemoveButton	Odebere tlačítko z panelu titulek.
CMFCCaptionBar::RemoveIcon	Odebere ikonu z panelu titulek.
CMFCCaptionBar::RemoveText	Textový popisek odebere z panelu titulek.
CMFCCaptionBar::SetBitmap	Nastaví rastrový obrázek pro záhlaví.
CMFCCaptionBar::SetBorderSize	Nastaví velikost ohraničení záhlaví.
CMFCCaptionBar::SetButton	Nastaví na tlačítko záhlaví.
CMFCCaptionBar::SetButtonPressed	Určuje, zda zůstane tlačítko stisknuté.
CMFCCaptionBar::SetButtonToolTip	Nastaví popisek tlačítka.
CMFCCaptionBar::SetFlatBorder	Nastaví styl ohraničení záhlaví.
CMFCCaptionBar::SetIcon	Určuje ikonu pro záhlaví.
CMFCCaptionBar::SetImageToolTip	Nastaví popis obrázku pro záhlaví.
CMFCCaptionBar::SetMargin	Nastaví vzdálenost mezi okrajem prvku panel titulek a okraj ovládací panel titulek.
CMFCCaptionBar::SetText	Nastaví popisek záhlaví.

Chráněné metody

Název	Description
CMFCCaptionBar::OnDrawBackground	Volat rozhraní výplně pozadí záhlaví.
CMFCCaptionBar::OnDrawBorder	Volat rozhraní Nakreslit ohraničení záhlaví.
CMFCCaptionBar::OnDrawButton	Volat rozhraní nakreslete tlačítko panel titulek.
CMFCCaptionBar::OnDrawImage	Volat rozhraní k nakreslení obrázku panelu titulek.
CMFCCaptionBar::OnDrawText	Volat rozhraní nakreslete text řádku titulku.

Datové členy

Název	Description
CMFCCaptionBar::m_clrBarBackground	Barva pozadí záhlaví.
CMFCCaptionBar::m_clrBarBorder	Barva ohraničení záhlaví.
CMFCCaptionBar::m_clrBarText	Barva pruhu text titulku.

Poznámky

Chcete-li vytvořit záhlaví, postupujte takto:

Konstrukce CMFCCaptionBar objektu.Obvykle by přidáte záhlaví pro třídu okna rámečku.
Volání CMFCCaptionBar::Create metoda vytvořit ovládací panel titulek a připojit ji k CMFCCaptionBar objektu.
Volání CMFCCaptionBar::SetButton, CMFCCaptionBar::SetText, CMFCCaptionBar::SetIcon, a CMFCCaptionBar::SetBitmap Chcete-li nastavit titulek panelu prvky.

Nastavíte-li prvek tlačítko, musíte přiřadit ID příkazu tlačítka.Když uživatel klepne na tlačítko panel trasy titulek WM_COMMAND zprávy, které je nutné toto ID nadřazeného okna rámce.

Záhlaví lze také pracovat v režimu panel zpráv, který emuluje panel zpráv, který se zobrazuje v aplikacích sady Microsoft Office 2007.V režimu panel zpráv záhlaví zobrazí rastr, zprávy a tlačítko (která se obvykle otevře dialogové okno.) Přiřadíte-li popis rastrového obrázku.

Chcete-li povolit režim panel zpráv, zavolejte CMFCCaptionBar::Create a čtvrtý parametr (bIsMessageBarMode) TRUE.

Příklad

Následující příklad ukazuje, jak používat různé metody v CMFCCaptionBar třídy.Příklad ukazuje, jak vytvořit ovládací prvek panel titulek, nastavení 3D ohraničení záhlaví, nastavte vzdálenost v obrazových bodech mezi okrajem titulek pruhu prvky a okraj ovládací panel titulek, nastavení tlačítka pro záhlaví, nastavit popis tlačítka, nastavit popisek záhlaví, nastavte rastrový obrázek pro záhlavía nastavit popis obrázku v záhlaví.Tento fragment kódu je součástí MS Office 2007 Demo ukázka.

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