Udostępnij za pośrednictwem

Klasa CMFCCaptionButton

Uwaga / Notatka

Biblioteka Klas programu Microsoft Foundation (MFC) nadal jest obsługiwana. Nie dodajemy już funkcji ani nie aktualizujemy dokumentacji.

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

  • Last updated on