Klasa CMFCAutoHideButton

Przycisk, który wyświetla lub ukrywa klasę CDockablePane skonfigurowaną do ukrycia.

Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.

Składnia

class CMFCAutoHideButton : public CObject

Elementy członkowskie

Metody publiczne

Uwagi

Podczas tworzenia CMFCAutoHideButton obiekt jest dołączony do klasy CDockablePane. Obiekt CDockablePane jest ukryty lub wyświetlany, gdy użytkownik wchodzi w interakcję z obiektem CMFCAutoHideButton .

Domyślnie platforma automatycznie tworzy CMFCAutoHideButton obiekt, gdy użytkownik włącza automatyczne ukrywanie. Platforma może utworzyć element niestandardowej klasy interfejsu użytkownika zamiast CMFCAutoHideButton klasy . Aby określić niestandardową klasę interfejsu użytkownika używaną przez platformę, ustaw zmienną CMFCAutoHideBar::m_pAutoHideButtonRTS statyczną składową równą niestandardowej klasie interfejsu użytkownika. Domyślnie ta zmienna jest ustawiona na CMFCAutoHideButtonwartość .

Przykład

W poniższym przykładzie pokazano, jak skonstruować CMFCAutoHideButton obiekt i używać różnych metod w CMFCAutoHideButton klasie. W przykładzie pokazano, jak zainicjować CMFCAutoHideButton obiekt przy użyciu jego Create metody, pokazać skojarzą CDockablePane klasę i wyświetlić przycisk automatycznego ukrywania.

CMFCAutoHideButton *autoHideButton = new CMFCAutoHideButton();
CDockablePane cPane;
// CMFCAutoHideBar* pParentBar
if (!autoHideButton->Create(pParentBar, &cPane, CBRS_ALIGN_LEFT))
{
   return 0;
}
autoHideButton->ShowAttachedWindow(true);
autoHideButton->ShowButton(true);

Hierarchia dziedziczenia

Obiekt CObject

CMFCAutoHideButton

Wymagania

Nagłówek: afxautohidebutton.h

CMFCAutoHideButton::BringToTop

void BringToTop();

Uwagi

CMFCAutoHideButton::Create

Tworzy i inicjuje przycisk automatycznego ukrywania.

virtual BOOL Create(
    CMFCAutoHideBar* pParentBar,
    CDockablePane* pAutoHideWnd,
    DWORD dwAlignment);

Parametry

pParentBar
[in] Wskaźnik do nadrzędnego paska narzędzi.

pAutoHideWnd
[in] Wskaźnik do obiektu CDockablePane . Ten przycisk auto-hide ukrywa i pokazuje, że CDockablePane.

dwAlignment
[in] Wartość określająca wyrównanie przycisku z głównym oknem ramki.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Podczas tworzenia CMFCAutoHideButton obiektu należy skojarzyć przycisk automatycznego ukrywania z określonym CDockablePaneelementem . Użytkownik może użyć przycisku automatycznego ukrywania, aby ukryć i pokazać skojarzony element CDockablePane.

Parametr dwAlignment wskazuje, gdzie w aplikacji znajduje się przycisk automatycznego ukrywania. Parametr może być jedną z następujących wartości:

• CBRS_ALIGN_LEFT

• CBRS_ALIGN_RIGHT

• CBRS_ALIGN_TOP

• CBRS_ALIGN_BOTTOM

CMFCAutoHideButton::GetAlignment

Pobiera wyrównanie przycisku automatycznego ukrywania.

DWORD GetAlignment() const;

Wartość zwracana

Wartość DWORD zawierająca bieżące wyrównanie przycisku automatycznego ukrywania.

Uwagi

Wyrównanie przycisku automatycznego ukrywania wskazuje, gdzie znajduje się przycisk w aplikacji. Może to być dowolna z następujących wartości:

• CBRS_ALIGN_LEFT

• CBRS_ALIGN_RIGHT

• CRBS_ALIGN_TOP

• CBRS_ALIGN_BOTTOM

CMFCAutoHideButton::GetAutoHideWindow

Zwraca obiekt CDockablePane skojarzony z przyciskiem automatycznego ukrywania.

CDockablePane* GetAutoHideWindow() const;

Wartość zwracana

Wskaźnik do skojarzonego CDockablePane obiektu.

Uwagi

Aby skojarzyć przycisk automatycznego ukrywania z elementem CDockablePane, przekaż CDockablePane parametr jako parametr do metody CMFCAutoHideButton::Create .

CMFCAutoHideButton::GetParentToolBar

CMFCAutoHideBar* GetParentToolBar();

Wartość zwracana

Uwagi

CMFCAutoHideButton::GetRect

CRect GetRect() const;

Wartość zwracana

Uwagi

CMFCAutoHideButton::GetSize

Określa rozmiar przycisku automatycznego ukrywania.

CSize GetSize() const;

Wartość zwracana

CSize Obiekt, który zawiera rozmiar przycisku.

Uwagi

Rozmiar obliczeniowy obejmuje rozmiar obramowania przycisku automatycznego ukrywania.

CMFCAutoHideButton::GetTextSize

Zwraca rozmiar etykiety tekstowej przycisku automatycznego ukrywania.

virtual CSize GetTextSize() const;

Wartość zwracana

Obiekt CSize zawierający rozmiar tekstu dla przycisku automatycznego ukrywania.

CMFCAutoHideButton::IsActive

Wskazuje, czy przycisk automatycznego ukrywania jest aktywny.

BOOL IsActive() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli przycisk automatycznego ukrywania jest aktywny; FAŁSZ w przeciwnym razie.

Uwagi

Po wyświetleniu skojarzonego okna Klasa CDockablePane przycisk automatycznego ukrywania jest aktywny.

CMFCAutoHideButton::IsHorizontal

Określa, czy przycisk automatycznego ukrywania jest poziomy, czy pionowy.

BOOL IsHorizontal() const;

Wartość zwracana

Nonzero, jeśli przycisk jest poziomy; 0 w przeciwnym razie.

Uwagi

Struktura ustawia orientację obiektu CMFCAutoHideButton podczas jego tworzenia. Orientację można kontrolować przy użyciu parametru dwAlignment w metodzie CMFCAutoHideButton::Create .

CMFCAutoHideButton::IsTop

BOOL IsTop() const;

Wartość zwracana

Uwagi

CMFCAutoHideButton::IsVisible

Wskazuje, czy przycisk automatycznego ukrywania jest widoczny.

virtual BOOL IsVisible() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli przycisk jest widoczny; FAŁSZ w przeciwnym razie.

CMFCAutoHideButton::OnDraw

Struktura wywołuje tę metodę, gdy rysuje przycisk automatycznego ukrywania.

virtual void OnDraw(CDC* pDC);

Parametry

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

Uwagi

Jeśli chcesz dostosować wygląd przycisków automatycznego ukrywania w aplikacji, utwórz nową klasę pochodzącą z CMFCAutoHideButtonklasy . W klasie pochodnej zastąp tę metodę.

CMFCAutoHideButton::OnDrawBorder

Struktura wywołuje tę metodę, gdy rysuje obramowanie przycisku automatycznego ukrywania.

virtual void OnDrawBorder(
    CDC* pDC,
    CRect rectBounds,
    CRect rectBorderSize);

Parametry

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

rectBounds
[in] Prostokąt ograniczenia przycisku automatycznego ukrywania.

rectBorderSize
[in] Grubość obramowania dla każdej strony przycisku automatycznego ukrywania.

Uwagi

Jeśli chcesz dostosować obramowanie każdego przycisku automatycznego ukrywania w aplikacji, utwórz nową klasę pochodzącą z klasy CMFCAutoHideButton. W klasie pochodnej zastąp tę metodę.

CMFCAutoHideButton::OnFillBackground

Struktura wywołuje tę metodę, gdy wypełnia tło przycisku automatycznego ukrywania.

virtual void OnFillBackground(
    CDC* pDC,
    CRect rect);

Parametry

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

Rect
[in] Prostokąt ograniczenia przycisku automatycznego ukrywania.

Uwagi

Jeśli chcesz dostosować tło dla przycisków automatycznego ukrywania w aplikacji, utwórz nową klasę pochodzącą z klasy CMFCAutoHideButton. W klasie pochodnej zastąp tę metodę.

CMFCAutoHideButton::ShowAttachedWindow

Wyświetla lub ukrywa skojarzona klasa CDockablePane.

void ShowAttachedWindow(BOOL bShow);

Parametry

bShow
[in] Wartość logiczna określająca, czy ta metoda pokazuje dołączony CDockablePaneelement .

CMFCAutoHideButton::ShowButton

Wyświetla lub ukrywa przycisk automatycznego ukrywania.

virtual void ShowButton(BOOL bShow);

Parametry

bShow
[in] Wartość logiczna określająca, czy ma być wyświetlany przycisk automatycznego ukrywania.

CMFCAutoHideButton::Move

void Move(int nOffset);

Parametry

[in] nOffset

Uwagi

CMFCAutoHideButton::ReplacePane

void ReplacePane(CDockablePane* pNewBar);

Parametry

[in] pNewBar

Uwagi

CMFCAutoHideButton::UnSetAutoHideMode

Wyłącz tryb automatycznego ukrywania.

virtual void UnSetAutoHideMode(CDockablePane* pFirstBarInGroup);

Parametry

pFirstBarInGroup
[in] Wskaźnik do pierwszego paska w grupie.

Uwagi

CMFCAutoHideButton::HighlightButton

Wyróżnia przycisk automatycznego ukrywania.

virtual void HighlightButton(BOOL bHighlight);

Parametry

bHighlight
Określa nowy stan przycisku automatycznego ukrywania. Wartość TRUE wskazuje, że przycisk jest wyróżniony, wartość FALSE wskazuje, że przycisk nie jest wyróżniony.

Uwagi

CMFCAutoHideButton::IsHighlighted

Zwraca stan wyróżnienia przycisku automatycznego ukrywania.

virtual BOOL IsHighlighted() const;

Wartość zwracana

Zwraca wartość TRUE, jeśli przycisk automatycznego ukrywania jest wyróżniony; w przeciwnym razie FAŁSZ.

Uwagi

Zobacz też

Wykres hierarchii
Klasy
Klasa CMFCAutoHideBar
Klasa CAutoHideDockSite