CMFCCaptionButton – třída

Poznámka:

Knihovna MFC (Microsoft Foundation Classes) se nadále podporuje. Už ale nepřidáme funkce ani aktualizujeme dokumentaci.

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