CMFCCaptionButton-Klasse

Die CMFCCaptionButton Klasse implementiert eine Schaltfläche, die auf der Beschriftungsleiste für einen Andockbereich oder ein Miniframefenster angezeigt wird. In der Regel erstellt das Framework Beschriftungsschaltflächen automatisch.

Syntax

class CMFCCaptionButton : public CObject

Member

Konstruktoren

Name Beschreibung
CMFCCaptionButton::CMFCCaptionButton Erstellt ein CMFCCaptionButton -Objekt.

Öffentliche Methoden

Name Beschreibung
CMFCCaptionButton::GetHit Gibt den Befehl zurück, der durch die Schaltfläche dargestellt wird.
CMFCCaptionButton::GetIconID Gibt die Bild-ID zurück, die der Schaltfläche zugeordnet ist.
CMFCCaptionButton::GetRect Gibt das Rechteck zurück, das von der Schaltfläche belegt ist.
CMFCCaptionButton::GetSize Gibt die Breite und Höhe der Schaltfläche zurück.
CMFCCaptionButton::IsMiniFrameButton Gibt an, ob die Höhe der Titelleiste auf Minigröße festgelegt ist.
CMFCCaptionButton::Move Legt den Zustand der Schaltfläche zum Zeichnen und Anzeigen des Fensters fest.
CMFCCaptionButton::OnDraw Zeichnet die Beschriftungsschaltfläche.
CMFCCaptionButton::SetMiniFrameButton Legt die Minigröße der Titelleiste fest.

Hinweise

Sie können eine Klasse von der CPaneFrameWnd-Klasse ableiten und die geschützte Methode verwenden, AddButtonum Beschriftungsschaltflächen zu einem Miniframefenster hinzuzufügen.

CPaneFrameWnd.h definiert Befehls-IDs für zwei Arten von Beschriftungsschaltflächen:

  • AFX_CAPTION_BTN_PIN, die eine Pin-Schaltfläche anzeigt, wenn der Andockbereich den Modus "Automatisches Ausblenden" unterstützt.

  • AFX_CAPTION_BTN_CLOSE, die eine Schaltfläche "Schließen " anzeigt, wenn der Bereich geschlossen oder ausgeblendet werden kann.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie ein CMFCCaptionButton Objekt erstellt und die Minigröße der Titelleiste festgelegt wird.

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

Vererbungshierarchie

CObject

CMFCCaptionButton

Anforderungen

Kopfzeile: afxcaptionbutton.h

CMFCCaptionButton::CMFCCaptionButton

Erstellt ein CMFCCaptionButton-Objekt.

CMFCCaptionButton();

CMFCCaptionButton(
    UINT nHit,
    BOOL bLeftAlign = FALSE);

Parameter

nHit
[in] Der Befehl, der der Schaltfläche zugeordnet ist.

bLeftAlign
[in] Gibt an, ob die Schaltfläche links ausgerichtet ist.

In der folgenden Tabelle sind mögliche Werte für den nHit-Parameter aufgeführt.

Wert Get-Help
AFX_HTCLOSE Schaltfläche "Schließen".
HTMINBUTTON Schaltfläche "Minimieren".
HTMAXBUTTON Schaltfläche "Maximieren".
AFX_HTLEFTBUTTON Nach-Links-Pfeil.
AFX_HTRIGHTBUTTON Nach-Rechts-Pfeil.
AFX_HTMENU Schaltfläche des Nach-unten-Menüs.
HTNOWHERE Der Standardwert; stellt keinen Befehl dar.

Hinweise

Standardmäßig sind Beschriftungsschaltflächen keinem Befehl zugeordnet.

Beschriftungsschaltflächen werden rechts oder links ausgerichtet.

CMFCCaptionButton::GetHit

Gibt den Befehl zurück, der durch die Schaltfläche dargestellt wird.

UINT GetHit() const;

Rückgabewert

Der Befehl, der durch die Schaltfläche dargestellt wird.

In der folgenden Tabelle sind mögliche Rückgabewerte aufgeführt.

Wert Get-Help
AFX_HTCLOSE Schaltfläche "Schließen".
HTMINBUTTON Schaltfläche "Minimieren".
HTMAXBUTTON Schaltfläche "Maximieren".
AFX_HTLEFTBUTTON Nach-Links-Pfeil.
AFX_HTRIGHTBUTTON Nach-Rechts-Pfeil.
AFX_HTMENU Schaltfläche des Nach-unten-Menüs.
HTNOWHERE Der Standardwert; stellt keinen Befehl dar.

CMFCCaptionButton::GetIconID

Gibt die Bild-ID zurück, die der Schaltfläche zugeordnet ist.

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

Parameter

bHorz
[in] TRUE für Bild-IDs nach links oder rechts; FALSE für Bild-IDs nach oben oder unten.

bMaximized
[in] TRUE für eine maximierte Bild-ID; FALSE für eine minimierte Bild-ID.

Rückgabewert

Die Bild-ID.

Hinweise

Die Parameter geben Bild-IDs zum Minimieren oder Maximieren von Beschriftungsschaltflächen an.

CMFCCaptionButton::GetRect

Gibt das Rechteck zurück, das von der Schaltfläche belegt ist.

virtual CRect GetRect() const;

Rückgabewert

Das Rechteck, das die Position der Schaltfläche darstellt.

Hinweise

Wenn die Schaltfläche nicht angezeigt wird, ist die zurückgegebene Größe 0.

CMFCCaptionButton::GetSize

Gibt die Breite und Höhe der Schaltfläche zurück.

static CSize GetSize();

Rückgabewert

Die äußeren Abmessungen der Schaltfläche.

Hinweise

Die zurückgegebene Größe enthält den Schaltflächenrand und den Rahmen.

CMFCCaptionButton::IsMiniFrameButton

Gibt an, ob die Höhe der Titelleiste auf Minigröße festgelegt ist.

BOOL IsMiniFrameButton() const;

Rückgabewert

TRUE, wenn die Beschriftung auf Minigröße festgelegt ist; andernfalls FALSE.

Hinweise

CMFCCaptionButton::Move

Legt den Zustand der Schaltfläche zum Zeichnen und Anzeigen des Fensters fest.

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

Parameter

ptTo
[in] Der neue Speicherort.

bHide
[in] Gibt an, ob die Schaltfläche angezeigt werden soll.

CMFCCaptionButton::OnDraw

Zeichnet die Beschriftungsschaltfläche.

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

Parameter

pDC
[in] Zeigen Sie auf einen Gerätekontext für die Schaltfläche.

bActive
[in] Gibt an, ob ein aktives Schaltflächenbild gezeichnet werden soll.

bHorz
[in] Reserviert für die Verwendung in einer abgeleiteten Klasse.

bMaximized
[in] Gibt an, ob ein maximiertes Schaltflächenbild gezeichnet werden soll.

bDisabled
[in] Gibt an, ob ein aktiviertes Schaltflächenbild gezeichnet werden soll.

Hinweise

Der bMaximized-Parameter wird verwendet, wenn die Schaltfläche eine Maximierungs- oder Minimierungsschaltfläche ist.

CMFCCaptionButton::SetMiniFrameButton

Legt die Minigröße der Titelleiste fest.

void SetMiniFramebutton(BOOL bSet = TRUE);

Parameter

bSet
[in] TRUE für die Höhe der Minititelleiste; FALSE für die Standardhöhe der Titelleiste.

Siehe auch

Hierarchiediagramm
Klassen
CPaneFrameWnd-Klasse
CDockablePane-Klasse