Klasa CMFCCaptionButton

Klasa CMFCCaptionButton implementuje przycisk wyświetlany na pasku podpisów dla okienka dokowania lub mini-ramowego okna. Zazwyczaj platforma automatycznie tworzy przyciski podpisów.

Składnia

class CMFCCaptionButton : public CObject

Elementy członkowskie

Konstruktory

Nazwa/nazwisko	opis
CMFCCaptionButton::CMFCCaptionButton	Tworzy obiekt CMFCCaptionButton.

Metody publiczne

Nazwa/nazwisko	opis
CMFCCaptionButton::GetHit	Zwraca polecenie reprezentowane przez przycisk .
CMFCCaptionButton::GetIconID	Zwraca identyfikator obrazu skojarzony z przyciskiem .
CMFCCaptionButton::GetRect	Zwraca prostokąt zajmowany przez przycisk.
CMFCCaptionButton::GetSize	Zwraca szerokość i wysokość przycisku.
CMFCCaptionButton::IsMiniFrameButton	Wskazuje, czy wysokość paska tytułu jest ustawiona na rozmiar mini.
CMFCCaptionButton::Move	Ustawia lokalizację narysowania przycisku i stan wyświetlania okna.
CMFCCaptionButton::OnDraw	Rysuje przycisk podpisu.
CMFCCaptionButton::SetMiniFrameButton	Ustawia mini rozmiar paska tytułu.

Uwagi

Klasę można utworzyć na podstawie klasy CPaneFrameWnd i użyć chronionej metody , AddButtonaby dodać przyciski podpisów do mini okna ramek.

CPaneFrameWnd.h definiuje identyfikatory poleceń dla dwóch typów przycisków podpisów:

• AFX_CAPTION_BTN_PIN, który wyświetla przycisk pinezki, gdy okienko dockowania obsługuje tryb automatycznego ukrywania.

• AFX_CAPTION_BTN_CLOSE, który wyświetla przycisk Zamknij , gdy okienko można zamknąć lub ukryć.

Przykład

W poniższym przykładzie pokazano, jak skonstruować CMFCCaptionButton obiekt i ustawić mini rozmiar paska tytułu.

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

Hierarchia dziedziczenia

Obiekt CObject

CMFCCaptionButton

Wymagania

Nagłówek: afxcaptionbutton.h

CMFCCaptionButton::CMFCCaptionButton

CMFCCaptionButton Tworzy obiekt.

CMFCCaptionButton();

CMFCCaptionButton(
    UINT nHit,
    BOOL bLeftAlign = FALSE);

Parametry

nHit
[in] Polecenie skojarzone z przyciskiem .

bLeftAlign
[in] Określa, czy przycisk jest wyrównany do lewej.

W poniższej tabeli wymieniono możliwe wartości parametru nHit .

Wartość	Polecenie
AFX_HTCLOSE	Zamknij przycisk.
ELEMENT HTMLINBUTTON	Przycisk Minimalizuj.
HTMAXBUTTON	Przycisk Maksymalizuj.
AFX_HTLEFTBUTTON	Strzałka w lewo
AFX_HTRIGHTBUTTON	Strzałka w prawo.
AFX_HTMENU	Przycisk menu strzałki w dół.
HTNOWHERE	Wartość domyślna; nie reprezentuje polecenia.

Uwagi

Domyślnie przyciski podpisów nie są skojarzone z poleceniem.

Przyciski podpisów są wyrównane po prawej lub lewej stronie.

CMFCCaptionButton::GetHit

Zwraca polecenie reprezentowane przez przycisk .

UINT GetHit() const;

Wartość zwracana

Polecenie reprezentowane przez przycisk.

W poniższej tabeli wymieniono możliwe wartości zwracane.

Wartość	Polecenie
AFX_HTCLOSE	Zamknij przycisk.
ELEMENT HTMLINBUTTON	Przycisk Minimalizuj.
HTMAXBUTTON	Przycisk Maksymalizuj.
AFX_HTLEFTBUTTON	Strzałka w lewo
AFX_HTRIGHTBUTTON	Strzałka w prawo.
AFX_HTMENU	Przycisk menu strzałki w dół.
HTNOWHERE	Wartość domyślna; nie reprezentuje polecenia.

CMFCCaptionButton::GetIconID

Zwraca identyfikator obrazu skojarzony z przyciskiem .

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

Parametry

bHorz
[in] Wartość TRUE dla identyfikatorów obrazów ze strzałką w lewo lub w prawo; FALSE dla identyfikatorów obrazów ze strzałką w górę lub w dół.

bMaximized
[in] WARTOŚĆ TRUE dla zmaksymalizowania identyfikatora obrazu; FAŁSZ dla identyfikatora obrazu zminimalizowania.

Wartość zwracana

Identyfikator obrazu.

Uwagi

Parametry określają identyfikatory obrazów w celu zminimalizowania lub zmaksymalizowania przycisków podpisów.

CMFCCaptionButton::GetRect

Zwraca prostokąt zajmowany przez przycisk.

virtual CRect GetRect() const;

Wartość zwracana

Prostokąt reprezentujący lokalizację przycisku.

Uwagi

Jeśli nie widzisz przycisku, zwrócony rozmiar to 0.

CMFCCaptionButton::GetSize

Zwraca szerokość i wysokość przycisku.

static CSize GetSize();

Wartość zwracana

Zewnętrzne wymiary przycisku.

Uwagi

Zwrócony rozmiar obejmuje margines przycisku i obramowanie.

CMFCCaptionButton::IsMiniFrameButton

Wskazuje, czy wysokość paska tytułu jest ustawiona na rozmiar mini.

BOOL IsMiniFrameButton() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli podpis jest ustawiony na rozmiar mini; w przeciwnym razie FAŁSZ.

Uwagi

CMFCCaptionButton::Move

Ustawia lokalizację narysowania przycisku i stan wyświetlania okna.

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

Parametry

ptTo
[in] Nowa lokalizacja.

bHide
[in] Czy wyświetlić przycisk.

CMFCCaptionButton::OnDraw

Rysuje przycisk podpisu.

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

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia dla przycisku.

bActive
[in] Czy narysować aktywny obraz przycisku.

bHorz
[in] Zarezerwowane do użycia w klasie pochodnej.

bMaximized
[in] Czy narysować zmaksymalizowany obraz przycisku.

bDisabled
[in] Czy narysować obraz przycisku z włączoną obsługą.

Uwagi

Parametr bMaximized jest używany, gdy przycisk jest przyciskiem maksymalizuj lub minimalizuj.

CMFCCaptionButton::SetMiniFrameButton

Ustawia mini rozmiar paska tytułu.

void SetMiniFramebutton(BOOL bSet = TRUE);

Parametry

Zestaw bSet
[in] WARTOŚĆ TRUE dla wysokości paska mini tytułu; FAŁSZ dla domyślnej wysokości paska tytułu.

Zobacz też

Wykres hierarchii
Klasy
Klasa CPaneFrameWnd
Klasa CDockablePane