CMFCCaptionButton – třída

Třída CMFCCaptionButton implementuje tlačítko, které se zobrazí na panelu titulků pro ukotvení podokna nebo minirámeček okna. Rozhraní obvykle automaticky vytváří tlačítka titulků.

Syntaxe

class CMFCCaptionButton : public CObject

Členové

Konstruktory

Název	Popis
CMFCCaptionButton::CMFCCaptionButton	Vytvoří CMFCCaptionButton objektu.

Veřejné metody

Název	Popis
CMFCCaptionButton::GetHit	Vrátí příkaz reprezentovaný tlačítkem.
CMFCCaptionButton::GetIconID	Vrátí ID obrázku přidružené k tlačítku.
CMFCCaptionButton::GetRect	Vrátí obdélník obsazený tlačítkem.
CMFCCaptionButton::GetSize	Vrátí šířku a výšku tlačítka.
CMFCCaptionButton::IsMiniFrameButton	Určuje, jestli je výška záhlaví nastavená na minimální velikost.
CMFCCaptionButton::Move	Nastaví umístění kreslení tlačítka a stav zobrazení okna.
CMFCCaptionButton::OnDraw	Nakreslí tlačítko titulku.
CMFCCaptionButton::SetMiniFrameButton	Nastaví mini velikost záhlaví.

Poznámky

Můžete odvodit třídu z CPaneFrameWnd Class a použít chráněnou metodu , AddButtonpřidat tlačítka titulků do mini rámečku okna.

CPaneFrameWnd.h definuje ID příkazů pro dva typy tlačítek titulků:

• AFX_CAPTION_BTN_PIN, který při ukotvení podokna zobrazuje tlačítko připnutí, podporuje režim automatického skrytí.

• AFX_CAPTION_BTN_CLOSE, které zobrazuje tlačítko Zavřít , když je možné podokno zavřít nebo skrýt.

Příklad

Následující příklad ukazuje, jak vytvořit CMFCCaptionButton objekt a nastavit mini velikost záhlaví.

CMFCCaptionButton *captionButton = new CMFCCaptionButton(AFX_HTCLOSE);
captionButton->SetMiniFrameButton(true);

Hierarchie dědičnosti

Objekt CObject

CMFCCaptionButton

Požadavky

Hlavička: afxcaptionbutton.h

CMFCCaptionButton::CMFCCaptionButton

CMFCCaptionButton Vytvoří objekt.

CMFCCaptionButton();

CMFCCaptionButton(
    UINT nHit,
    BOOL bLeftAlign = FALSE);

Parametry

nHit
[v] Příkaz přidružený k tlačítku.

bLeftAlign
[v] Určuje, jestli je tlačítko zarovnané doleva.

Následující tabulka uvádí možné hodnoty parametru nHit .

Hodnota	Příkaz
AFX_HTCLOSE	Tlačítko Zavřít
HTMINBUTTON	Tlačítko Minimalizovat
HTMAXBUTTON	Tlačítko Maximalizovat
AFX_HTLEFTBUTTON	Tlačítko se šipkou vlevo.
AFX_HTRIGHTBUTTON	Tlačítko se šipkou vpravo.
AFX_HTMENU	Tlačítko nabídky se šipkou dolů
HTNOWHERE	Výchozí hodnota; představuje žádný příkaz.

Poznámky

Ve výchozím nastavení nejsou tlačítka titulků přidružená k příkazu.

Tlačítka titulků jsou zarovnaná buď doprava, nebo doleva.

CMFCCaptionButton::GetHit

Vrátí příkaz reprezentovaný tlačítkem.

UINT GetHit() const;

Návratová hodnota

Příkaz reprezentovaný tlačítkem

Následující tabulka uvádí možné návratové hodnoty.

Hodnota	Příkaz
AFX_HTCLOSE	Tlačítko Zavřít
HTMINBUTTON	Tlačítko Minimalizovat
HTMAXBUTTON	Tlačítko Maximalizovat
AFX_HTLEFTBUTTON	Tlačítko se šipkou vlevo.
AFX_HTRIGHTBUTTON	Tlačítko se šipkou vpravo.
AFX_HTMENU	Tlačítko nabídky se šipkou dolů
HTNOWHERE	Výchozí hodnota; představuje žádný příkaz.

CMFCCaptionButton::GetIconID

Vrátí ID obrázku přidružené k tlačítku.

virtual CMenuImages::IMAGES_IDS GetIconID(
    BOOL bHorz,
    BOOL bMaximized = FALSE) const;

Parametry

bHorz
[v] TRUE pro ID obrázků se šipkou vlevo nebo vpravo; FALSE pro ID obrázků se šipkou nahoru nebo dolů

bMaximized
[v] TRUE pro maximalizované ID image; NEPRAVDA pro minimalizované ID obrázku.

Návratová hodnota

ID obrázku.

Poznámky

Parametry určují ID obrázků pro minimalizaci nebo maximalizaci tlačítek titulků.

CMFCCaptionButton::GetRect

Vrátí obdélník obsazený tlačítkem.

virtual CRect GetRect() const;

Návratová hodnota

Obdélník, který představuje umístění tlačítka.

Poznámky

Pokud tlačítko nevidíte, vrácená velikost je 0.

CMFCCaptionButton::GetSize

Vrátí šířku a výšku tlačítka.

static CSize GetSize();

Návratová hodnota

Vnější rozměry tlačítka.

Poznámky

Vrácená velikost zahrnuje okraj tlačítka a ohraničení.

CMFCCaptionButton::IsMiniFrameButton

Určuje, jestli je výška záhlaví nastavená na minimální velikost.

BOOL IsMiniFrameButton() const;

Návratová hodnota

TRUE, pokud je titulek nastaven na mini velikost; jinak NEPRAVDA.

Poznámky

CMFCCaptionButton::Move

Nastaví umístění kreslení tlačítka a stav zobrazení okna.

void Move(
    const CPoint& ptTo,
    BOOL bHide = FALSE);

Parametry

ptTo
[v] Nové umístění.

bHide
[v] Zda se má tlačítko zobrazit.

CMFCCaptionButton::OnDraw

Nakreslí tlačítko titulku.

virtual void OnDraw(
    CDC* pDC,
    BOOL bActive,
    BOOL bHorz = TRUE,
    BOOL bMaximized = TRUE,
    BOOL bDisabled = FALSE);

Parametry

pDC
[v] Ukazatel na kontext zařízení pro tlačítko.

bActive
[v] Určuje, jestli chcete nakreslit obrázek aktivního tlačítka.

bHorz
[v] Vyhrazeno pro použití v odvozené třídě.

bMaximized
[v] Určuje, jestli chcete nakreslit obrázek maximalizovaného tlačítka.

bDisabled
[v] Určuje, jestli chcete nakreslit obrázek povoleného tlačítka.

Poznámky

Parametr bMaximized se používá, když je tlačítko maximalizovat nebo minimalizovat tlačítko.

CMFCCaptionButton::SetMiniFrameButton

Nastaví mini velikost záhlaví.

void SetMiniFramebutton(BOOL bSet = TRUE);

Parametry

bSet
[v] PRAVDA pro výšku mini záhlaví; NEPRAVDA pro výchozí výšku záhlaví.

Viz také

Graf hierarchie
Třídy
CPaneFrameWnd – třída
CDockablePane – třída