Share via

CMFCCaptionButton-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

De CMFCCaptionButton klasse implementeert een knop die wordt weergegeven op de bijschriftbalk voor een dockingvenster of een miniframevenster. Normaal gesproken worden in het framework automatisch bijschriftknoppen gemaakt.

Syntaxis

class CMFCCaptionButton : public CObject

Leden

Constructeurs

Naam Description
CMFCCaptionButton::CMFCCaptionButton Maakt een CMFCCaptionButton-object.

Openbare methoden

Naam Description
CMFCCaptionButton::GetHit Retourneert de opdracht die wordt vertegenwoordigd door de knop.
CMFCCaptionButton::GetIconID Retourneert de afbeeldings-id die is gekoppeld aan de knop.
CMFCCaptionButton::GetRect Retourneert de rechthoek die door de knop wordt bezet.
CMFCCaptionButton::GetSize Retourneert de breedte en hoogte van de knop.
CMFCCaptionButton::IsMiniFrameButton Geeft aan of de hoogte van de titelbalk is ingesteld op minigrootte.
CMFCCaptionButton::Move Hiermee stelt u de locatie en de status van het venster tekenen in.
CMFCCaptionButton::OnDraw Hiermee tekent u de knop Bijschrift.
CMFCCaptionButton::SetMiniFrameButton Hiermee stelt u de minigrootte van de titelbalk in.

Opmerkingen

U kunt een klasse afleiden uit CPaneFrameWnd Class en de beveiligde methode AddButtongebruiken om bijschriftknoppen toe te voegen aan een miniframevenster.

CPaneFrameWnd.h definieert opdracht-id's voor twee typen bijschriftknoppen:

  • AFX_CAPTION_BTN_PIN, waarmee een speldknop wordt weergegeven wanneer het dockingvenster de modus automatisch verbergen ondersteunt.

  • AFX_CAPTION_BTN_CLOSE, waarin een knop Sluiten wordt weergegeven wanneer het deelvenster kan worden gesloten of verborgen.

Example

In het volgende voorbeeld ziet u hoe u een CMFCCaptionButton object maakt en de minigrootte van de titelbalk instelt.

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

Overnamehiërarchie

CObject

CMFCCaptionButton

Requirements

Koptekst: afxcaptionbutton.h

CMFCCaptionButton::CMFCCaptionButton

Maakt een CMFCCaptionButton object.

CMFCCaptionButton();

CMFCCaptionButton(
    UINT nHit,
    BOOL bLeftAlign = FALSE);

Parameterwaarden

nHit
[in] De opdracht die aan de knop is gekoppeld.

bLeftAlign
[in] Hiermee geeft u op of de knop links is uitgelijnd.

De volgende tabel bevat mogelijke waarden voor de parameter nHit .

Waarde Command
AFX_HTCLOSE Knop Sluiten.
HTMINBUTTON De knop Minimaliseren.
HTMAXBUTTON Knop Maximaliseren.
AFX_HTLEFTBUTTON Pijl-links.
AFX_HTRIGHTBUTTON Pijl-rechts.
AFX_HTMENU Knop Pijl-omlaag.
HTNOWHERE De standaardwaarde; staat voor geen opdracht.

Opmerkingen

Standaard zijn bijschriftknoppen niet gekoppeld aan een opdracht.

Bijschriftknoppen worden uitgelijnd aan de rechterkant of links.

CMFCCaptionButton::GetHit

Retourneert de opdracht die wordt vertegenwoordigd door de knop.

UINT GetHit() const;

Retourwaarde

De opdracht die wordt vertegenwoordigd door de knop.

De volgende tabel bevat mogelijke retourwaarden.

Waarde Command
AFX_HTCLOSE Knop Sluiten.
HTMINBUTTON De knop Minimaliseren.
HTMAXBUTTON Knop Maximaliseren.
AFX_HTLEFTBUTTON Pijl-links.
AFX_HTRIGHTBUTTON Pijl-rechts.
AFX_HTMENU Knop Pijl-omlaag.
HTNOWHERE De standaardwaarde; staat voor geen opdracht.

CMFCCaptionButton::GetIconID

Retourneert de afbeeldings-id die is gekoppeld aan de knop.

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

Parameterwaarden

bHorz
[in] WAAR voor afbeeldings-id's van linker- of pijl-rechts; ONWAAR voor afbeeldings-id's met pijl-omhoog of pijl-omlaag.

gemaximiseerd
[in] WAAR voor een maximale afbeeldings-id; ONWAAR voor een geminimaliseerde afbeeldings-id.

Retourwaarde

De afbeeldings-id.

Opmerkingen

De parameters geven afbeeldings-id's op voor het minimaliseren of maximaliseren van bijschriftknoppen.

CMFCCaptionButton::GetRect

Retourneert de rechthoek die door de knop wordt bezet.

virtual CRect GetRect() const;

Retourwaarde

De rechthoek die de locatie van de knop aangeeft.

Opmerkingen

Als u de knop niet ziet, is de geretourneerde grootte 0.

CMFCCaptionButton::GetSize

Retourneert de breedte en hoogte van de knop.

static CSize GetSize();

Retourwaarde

De buitendimensies van de knop.

Opmerkingen

De geretourneerde grootte bevat knopmarge en rand.

CMFCCaptionButton::IsMiniFrameButton

Geeft aan of de hoogte van de titelbalk is ingesteld op minigrootte.

BOOL IsMiniFrameButton() const;

Retourwaarde

WAAR als het bijschrift is ingesteld op minigrootte; anders ONWAAR.

Opmerkingen

CMFCCaptionButton::Move

Hiermee stelt u de locatie en de status van het venster tekenen in.

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

Parameterwaarden

ptTo
[in] De nieuwe locatie.

bHide
[in] Of de knop moet worden weergegeven.

CMFCCaptionButton::OnDraw

Hiermee tekent u de knop Bijschrift.

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

Parameterwaarden

Pdc
[in] Aanwijzer naar een apparaatcontext voor de knop.

bActive
[in] Hiermee geeft u aan of u een actieve knopafbeelding wilt tekenen.

bHorz
[in] Gereserveerd voor gebruik in een afgeleide klasse.

gemaximiseerd
[in] Of u een gemaximaliseerde knopafbeelding wilt tekenen.

bDisabled
[in] Hiermee wordt aangegeven of u een afbeelding van een ingeschakelde knop wilt tekenen.

Opmerkingen

De parameter bMaximized wordt gebruikt wanneer de knop een knop maximaliseren of minimaliseren is.

CMFCCaptionButton::SetMiniFrameButton

Hiermee stelt u de minigrootte van de titelbalk in.

void SetMiniFramebutton(BOOL bSet = TRUE);

Parameterwaarden

bSet
[in] TRUE voor hoogte van minititelbalk; ONWAAR voor de standaardhoogte van de titelbalk.

Zie ook

Hiërarchiegrafiek
Klassen
CPaneFrameWnd-klasse
CDockablePane-klasse

  • Last updated on