CMFCCaptionButton osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Az CMFCCaptionButton osztály megvalósít egy gombot, amely megjelenik a feliratsávon egy dokkolópanelhez vagy egy minikeretablakhoz. A keretrendszer általában automatikusan létrehozza a feliratgombokat.

Szemantika

class CMFCCaptionButton : public CObject

Tagok

Konstruktorok

Név	Description
CMFCCaptionButton::CMFCCaptionButton	CMFCCaptionButton objektumot hoz létre.

Nyilvános metódusok

Név	Description
CMFCCaptionButton::GetHit	A gomb által képviselt parancsot adja vissza.
CMFCCaptionButton::GetIconID	A gombhoz társított képazonosítót adja vissza.
CMFCCaptionButton::GetRect	A gomb által elfoglalt téglalapot adja vissza.
CMFCCaptionButton::GetSize	A gomb szélességét és magasságát adja vissza.
CMFCCaptionButton::IsMiniFrameButton	Azt jelzi, hogy a címsor magassága mini méretre van-e állítva.
CMFCCaptionButton::Áthelyezés	Beállítja a gombrajz helyét és az ablak megjelenítési állapotát.
CMFCCaptionButton::OnDraw	Megrajzolja a felirat gombot.
CMFCCaptionButton::SetMiniFrameButton	Beállítja a címsor miniméretét.

Megjegyzések

Az osztályt a CPaneFrameWnd osztályból származtathatja, AddButtonés a védett metódussal feliratgombokat adhat hozzá egy minikeretablakhoz.

A CPaneFrameWnd.h parancsazonosítókat határoz meg a feliratgombok két típusához:

• AFX_CAPTION_BTN_PIN, amely egy rögzítési gombot jelenít meg, amikor a dokkolópanel támogatja az automatikus elrejtési módot.

• AFX_CAPTION_BTN_CLOSE, amely egy Bezárás gombot jelenít meg, amikor az ablaktábla bezárható vagy elrejthető.

Example

Az alábbi példa bemutatja, hogyan hozhat létre objektumot CMFCCaptionButton , és hogyan állíthatja be a címsor miniméretét.

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

Öröklési hierarchia

CObject

CMFCCaptionButton

Requirements

Fejléc: afxcaptionbutton.h

CMFCCaptionButton::CMFCCaptionButton

Egy CMFCCaptionButton objektumot hoz létre.

CMFCCaptionButton();

CMFCCaptionButton(
    UINT nHit,
    BOOL bLeftAlign = FALSE);

Paraméterek

nHit
[in] A gombhoz társított parancs.

bLeftAlign
[in] Megadja, hogy a gomb balra van-e igazítva.

Az alábbi táblázat az nHit paraméter lehetséges értékeit sorolja fel.

Érték	Parancs
AFX_HTCLOSE	Bezárás gomb.
HTMINBUTTON	Kis méret gomb.
HTMAXBUTTON	Teljes méret gomb.
AFX_HTLEFTBUTTON	Balra nyílgomb.
AFX_HTRIGHTBUTTON	Jobbra nyílgomb.
AFX_HTMENU	Le nyíl menügomb.
HTNOWHERE	Az alapértelmezett érték; nem jelöl parancsot.

Megjegyzések

Alapértelmezés szerint a feliratgombok nincsenek parancshoz rendelve.

A feliratgombok jobbra vagy balra vannak igazítva.

CMFCCaptionButton::GetHit

A gomb által képviselt parancsot adja vissza.

UINT GetHit() const;

Visszaadott érték

A gomb által képviselt parancs.

Az alábbi táblázat a lehetséges visszatérési értékeket sorolja fel.

Érték	Parancs
AFX_HTCLOSE	Bezárás gomb.
HTMINBUTTON	Kis méret gomb.
HTMAXBUTTON	Teljes méret gomb.
AFX_HTLEFTBUTTON	Balra nyílgomb.
AFX_HTRIGHTBUTTON	Jobbra nyílgomb.
AFX_HTMENU	Le nyíl menügomb.
HTNOWHERE	Az alapértelmezett érték; nem jelöl parancsot.

CMFCCaptionButton::GetIconID

A gombhoz társított képazonosítót adja vissza.

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

Paraméterek

bHorz
[in] IGAZ a balra vagy jobbra mutató nyíl képazonosítóihoz; HAMIS a felfelé vagy lefelé mutató nyíl képazonosítóihoz.

bMaximized
[in] IGAZ a teljes képazonosítóhoz; HAMIS a kis méretű képazonosítóhoz.

Visszaadott érték

A kép azonosítója.

Megjegyzések

A paraméterek képazonosítókat adnak meg a képaláírási gombok minimalizálásához vagy maximalizálásához.

CMFCCaptionButton::GetRect

A gomb által elfoglalt téglalapot adja vissza.

virtual CRect GetRect() const;

Visszaadott érték

A gomb helyét jelképező téglalap.

Megjegyzések

Ha nem látja a gombot, a visszaadott méret 0.

CMFCCaptionButton::GetSize

A gomb szélességét és magasságát adja vissza.

static CSize GetSize();

Visszaadott érték

A gomb külső méretei.

Megjegyzések

A visszaadott méret tartalmazza a gombmargót és a szegélyt.

CMFCCaptionButton::IsMiniFrameButton

Azt jelzi, hogy a címsor magassága mini méretre van-e állítva.

BOOL IsMiniFrameButton() const;

Visszaadott érték

IGAZ, ha a felirat mini méretre van állítva; egyéb esetben HAMIS.

Megjegyzések

CMFCCaptionButton::Áthelyezés

Beállítja a gombrajz helyét és az ablak megjelenítési állapotát.

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

Paraméterek

ptTo
[in] Az új hely.

bHide
[in] A gomb megjelenítése.

CMFCCaptionButton::OnDraw

Megrajzolja a felirat gombot.

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

Paraméterek

Pdc
[in] Mutasson a gomb eszközkörnyezetére.

bActive
[in] Aktív gomb képének rajzolása.

bHorz
[in] Származtatott osztályban való használatra fenntartva.

bMaximized
[in] Teljes méretű gomb képének rajzolása.

bDisabled
[in] Egy engedélyezett gomb képének rajzolása.

Megjegyzések

A bMaximized paramétert akkor használja a rendszer, ha a gomb egy teljes vagy kis méretű gomb.

CMFCCaptionButton::SetMiniFrameButton

Beállítja a címsor miniméretét.

void SetMiniFramebutton(BOOL bSet = TRUE);

Paraméterek

bSet
[in] IGAZ a mini címsor magasságához; HAMIS a címsor alapértelmezett magasságához.

Lásd még

hierarchiadiagram
osztályok
CPaneFrameWnd osztály
CDockablePane osztály