Udostępnij za pośrednictwem

CDockablePane Klasa

  • Artykuł

Implementuje okienko, które można zadokować w lokacji docka lub dołączone do okienka z kartami.

Składnia

class CDockablePane : public CPane

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CDockablePane::CDockablePane Tworzy i inicjuje CDockablePane obiekt.

Metody publiczne

Nazwa/nazwisko opis
CDockablePane::AttachToTabWnd Dołącza okienko do innego okienka. Spowoduje to utworzenie okienka z kartami.
CDockablePane::CalcFixedLayout Zwraca rozmiar prostokąta okienka.
CDockablePane::CanAcceptMiniFrame Określa, czy określona mini ramka może być zadokowana do okienka.
CDockablePane::CanAcceptPane Określa, czy można zadokować kolejne okienko do bieżącego okienka.
CDockablePane::CanAutoHide Określa, czy okienko obsługuje tryb automatycznego ukrywania. (Przesłania CBasePane::CanAutoHide).
CDockablePane::CanBeAttached Określa, czy bieżące okienko można zadokować do innego okienka.
CDockablePane::ConvertToTabbedDocument Konwertuje co najmniej jedno okienko z możliwością dokowania do dokumentów z kartami MDI.
CDockablePane::CopyState Kopiuje stan okienka z możliwością dokowania.
CDockablePane::Create Tworzy kontrolkę systemu Windows i dołącza ją do CDockablePane obiektu.
CDockablePane::CreateDefaultPaneDivider Tworzy domyślny podział okienka, ponieważ jest on zadokowany do okna ramki.
CDockablePane::CreateEx Tworzy kontrolkę systemu Windows i dołącza ją do CDockablePane obiektu.
CDockablePane::CreateTabbedPane Tworzy okienko z kartami z bieżącego okienka.
CDockablePane::DockPaneContainer Zadokuje kontener do okienka.
CDockablePane::DockPaneStandard Dokowuje okienko przy użyciu zadokowania konspektu (standardowego).
CDockablePane::DockToFrameWindow Używane wewnętrznie. Aby zadokować okienko, użyj polecenia CPane::DockPane lub CDockablePane::DockToWindow.
CDockablePane::DockToRecentPos Zadokuje okienko do przechowywanej ostatnio pozycji dokowania.
CDockablePane::DockToWindow Zadokuje jedno okienko dokowania do innego okienka dokowania.
CDockablePane::EnableAutohideAll Włącza lub wyłącza tryb automatycznego ukrywania dla tego okienka wraz z innymi okienkami w kontenerze.
CDockablePane::EnableGripper Wyświetla lub ukrywa podpis (uchwyt).
CDockablePane::GetAHRestoredRect Określa położenie okienka, gdy jest widoczne w trybie automatycznego ukrywania.
CDockablePane::GetAHSlideMode Pobiera tryb automatycznego ukrywania slajdów dla okienka.
CDockablePane::GetAutoHideButton Używane wewnętrznie.
CDockablePane::GetAutoHideToolBar Używane wewnętrznie.
CDockablePane::GetCaptionHeight Zwraca wysokość bieżącego podpisu.
CDockablePane::GetDefaultPaneDivider Zwraca domyślny podział okienka dla kontenera okienka.
CDockablePane::GetDockingStatus Określa możliwość zadokowania okienka na podstawie podanej lokalizacji wskaźnika.
CDockablePane::GetDragSensitivity Zwraca czułość przeciągania okienka dokowania.
CDockablePane::GetLastPercentInPaneContainer Pobiera procent miejsca zajmowanego przez okienko w kontenerze.
CDockablePane::GetTabArea Pobiera obszar karty dla okienka.
CDockablePane::GetTabbedPaneRTC Zwraca informacje o klasie środowiska uruchomieniowego dotyczące okna z kartami utworzonego podczas dokowania innego okienka do bieżącego okienka.
CDockablePane::HasAutoHideMode Określa, czy okienko dokowania można przełączyć do trybu automatycznego ukrywania.
CDockablePane::HitTest Określa określoną lokalizację w okienku, w którym użytkownik klika mysz.
CDockablePane::IsAccessibilityCompatible Używane wewnętrznie.
CDockablePane::IsAutohideAllEnabled Wskazuje, czy okienko dokowania i wszystkie inne okienka w kontenerze można umieścić w trybie automatycznego ukrywania.
CDockablePane::IsAutoHideMode Określa, czy okienko jest w trybie automatycznego ukrywania.
CDockablePane::IsChangeState Używane wewnętrznie.
CDockablePane::IsDocked Określa, czy bieżące okienko jest zadokowane.
CDockablePane::IsHideInAutoHideMode Określa zachowanie okienka, które jest w trybie automatycznego ukrywania, jeśli jest wyświetlane (lub ukryte), wywołując polecenie ShowPane.
CDockablePane::IsInFloatingMultiPaneFrameWnd Określa, czy okienko znajduje się w oknie ramki z wieloma okienkami.
CDockablePane::IsResizable Określa, czy okienko jest możliwe do zmiany rozmiaru.
CDockablePane::IsTabLocationBottom Określa, czy karty znajdują się w górnej lub dolnej części okienka.
CDockablePane::IsTracked Określa, czy okienko jest przeciągane przez użytkownika.
CDockablePane::IsVisible Określa, czy bieżące okienko jest widoczne.
CDockablePane::LoadState Używane wewnętrznie.
CDockablePane::OnAfterChangeParent Wywoływana przez platformę, gdy element nadrzędny okienka uległ zmianie. (Przesłania CPane::OnAfterChangeParent).
CDockablePane::OnAfterDockFromMiniFrame Wywoływana przez platformę, gdy pływający pasek dokowania dokuje w oknie ramowym.
CDockablePane::OnBeforeChangeParent Wywoływana przez strukturę, gdy element nadrzędny okienka ma ulec zmianie. (Przesłania CPane::OnBeforeChangeParent).
CDockablePane::OnBeforeFloat Wywoływana przez platformę, gdy okienko ma być zmiennoprzecinkowe. (Przesłania CPane::OnBeforeFloat).
CDockablePane::RemoveFromDefaultPaneDividier Struktura wywołuje tę metodę, gdy okienko jest oddokowane.
CDockablePane::ReplacePane Zamienia okienko na określone okienko.
CDockablePane::RestoreDefaultPaneDivider Struktura wywołuje tę metodę jako okienko jest deserializowane w celu przywrócenia domyślnego podziału okienka.
CDockablePane::SaveState Używane wewnętrznie.
CDockablePane::Serialize Serializuje okienko. (Przesłania CBasePane::Serialize).
CDockablePane::SetAutoHideMode Przełącza okienko dokowania między trybem widocznym i automatycznym ukrywaniem.
CDockablePane::SetAutoHideParents Ustawia przycisk automatycznego ukrywania i automatycznie ukrywa pasek narzędzi okienka.
CDockablePane::SetDefaultPaneDivider Używane wewnętrznie.
CDockablePane::SetLastPercentInPaneContainer Ustawia procent miejsca zajmowanego przez okienko w kontenerze.
CDockablePane::SetResizeMode Używane wewnętrznie.
CDockablePane::SetRestoredDefaultPaneDivider Ustawia przywrócony domyślny podział okienka.
CDockablePane::SetTabbedPaneRTC Ustawia informacje o klasie środowiska uruchomieniowego dla okna z kartami, które jest tworzone podczas łączenia dwóch okienek.
CDockablePane::ShowPane Wyświetla lub ukrywa okienko.
CDockablePane::Slide Wyświetla lub ukrywa okienko z przesuwaną animacją, która jest wyświetlana tylko wtedy, gdy okienko jest w trybie automatycznego ukrywania.
CDockablePane::ToggleAutoHide Przełącza tryb automatycznego ukrywania. (Przesłonięcia CPane::ToggleAutoHide ).
CDockablePane::UndockPane Oddokuje okienko z głównego okna ramowego lub kontenera okien miniframe.
CDockablePane::UnSetAutoHideMode Używane wewnętrznie. Aby ustawić tryb automatycznego ukrywania, użyj polecenia CDockablePane::SetAutoHideMode

Metody chronione

Nazwa/nazwisko opis
CDockablePane::CheckAutoHideCondition Określa, czy okienko dokowania jest ukryte (w trybie automatycznego ukrywania).
CDockablePane::CheckStopSlideCondition Określa, kiedy okienko automatycznego ukrywania dokowania powinno przestać przesuwać się.
CDockablePane::DrawCaption Rysuje podpis okienka dokowania (uchwyt).
CDockablePane::OnPressButtons Wywoływana, gdy użytkownik naciska przycisk podpisu inny niż AFX_HTCLOSE przyciski i AFX_HTMAXBUTTON .
CDockablePane::OnSlide Wywoływana przez strukturę w celu renderowania efektu automatycznego ukrywania slajdu, gdy okienko jest wyświetlane lub ukryte.

Składowe danych

Nazwa/nazwisko opis
CDockablePane::m_bDisableAnimation Określa, czy animacja automatycznego ukrywania okienka z możliwością dokowania jest wyłączona.
CDockablePane::m_bHideInAutoHideMode Określa zachowanie okienka, gdy okienko jest w trybie automatycznego ukrywania.
CDockablePane::m_nSlideSteps Określa szybkość animacji okienka, gdy jest wyświetlana lub ukryta w trybie automatycznego ukrywania.

Uwagi

CDockablePane implementuje następujące funkcje:

  • Zadokowanie okienka do głównego okna ramowego.

  • Przełączanie okienka do trybu automatycznego ukrywania.

  • Dołączanie okienka do okna z kartami.

  • Przestawne okienko w oknie miniframe.

  • Zadokowanie okienka do innego okienka, które unosi się w oknie miniframe.

  • Zmiana rozmiaru okienka.

  • Ładowanie i zapisywanie stanu dla okienka dokowania.

    Uwaga

    Informacje o stanie są zapisywane w rejestrze systemu Windows.

  • Tworzenie okienka z podpisem lub bez go. Podpis może mieć etykietę tekstową i może być wypełniony kolorem gradientu.

  • Przeciąganie okienka podczas wyświetlania zawartości okienka

  • Przeciąganie okienka podczas wyświetlania prostokąta przeciągania.

Aby użyć okienka dokowania w aplikacji, utwórz klasę okienka z CDockablePane klasy . Osadź obiekt pochodny w obiekcie okna głównego ramki lub w obiekcie okna, który kontroluje wystąpienie okienka. Następnie wywołaj metodę lub CDockablePane::CreateEx metodę CDockablePane::Create podczas przetwarzania komunikatu WM_CREATE w głównym oknie ramki. Na koniec skonfiguruj obiekt okienka, wywołując metodę CBasePane::EnableDocking, CBasePane::DockPanelub CDockablePane::AttachToTabWnd.

Porady dotyczące dostosowywania

Następujące porady dotyczą CDockablePane obiektów:

  • Jeśli wywołasz CDockablePane::AttachToTabWnd wywołanie dwóch okienek bez kart, dokowania, wskaźnik do okna z kartą zostanie zwrócony w parametrze ppTabbedControlBar . Możesz nadal dodawać karty do okna z kartami przy użyciu tego parametru.

  • Rodzaj okienka z kartami tworzonym CDockablePane::AttachToTabWnd przez program jest określany przez CDockablePane obiekt w parametrze pTabControlBarAttachTo . Możesz wywołać metodę CDockablePane::SetTabbedPaneRTC , aby ustawić rodzaj okienka z kartami, które CDockablePane zostanie utworzone. Typ domyślny jest określany przez dwTabbedStyle wartość typu CDockablePane::Create podczas pierwszego tworzenia elementu CDockablePane. Jeśli jest typem domyślnym jestCMFCOutlookBar AFX_CBRS_OUTLOOK_TABS Klasa. Jeśli dwTabbedStyle dwTabbedStyle jest to typ domyślny, to AFX_CBRS_REGULAR_TABSCTabbedPane Klasa.

  • Jeśli chcesz zadokować jedno dokowalne okienko do drugiego, wywołaj metodę CDockablePane::DockToWindow . Oryginalne okienko musi być zadokowane gdzieś przed wywołaniem tej metody.

  • Zmienna składowa CDockablePane::m_bHideInAutoHideMode steruje zachowaniem okienek dokowania w trybie automatycznego ukrywania podczas wywoływania elementu CDockablePane::ShowPane. Jeśli ta zmienna składowa jest ustawiona na TRUE, zadokowalne okienka i ich automatyczne ukrywanie przycisków będzie ukryte. W przeciwnym razie wysuną się i wyjdą.

  • Możesz wyłączyć automatyczną animację, ustawiając zmienną składową CDockablePane::m_bDisableAnimation na TRUEwartość .

Przykład

W poniższym przykładzie pokazano, jak skonfigurować CDockablePane obiekt przy użyciu różnych metod w CDockablePane klasie. W przykładzie pokazano, jak włączyć funkcję automatycznego ukrywania wszystkich funkcji dla okienka z możliwością dokowania, włączać podpis lub uchwyt, włączać tryb automatycznego ukrywania, pokazywać okienko i animować okienko, które jest w trybie automatycznego ukrywania. Ten fragment kodu jest częścią przykładu pokazowego programu Visual Studio.

// GetOwner is an inherited method.
CDockablePane *pParentBar = DYNAMIC_DOWNCAST(CDockablePane, GetOwner());

pParentBar->EnableAutohideAll();
pParentBar->EnableGripper(true);
pParentBar->SetAutoHideMode(true, CBRS_ALIGN_LEFT);
pParentBar->ShowPane(true, false, true);
pParentBar->Slide(true);

Hierarchia dziedziczenia

CObject

CCmdTarget

CWnd

CBasePane

CPane

CDockablePane

Wymagania

Nagłówek: afxDockablePane.h

CDockablePane::AttachToTabWnd

Dołącza bieżące okienko do okienka docelowego, tworząc okienko z kartami.

virtual CDockablePane* AttachToTabWnd(
    CDockablePane* pTabControlBarAttachTo,
    AFX_DOCK_METHOD dockMethod,
    BOOL bSetActive= TRUE,
    CDockablePane** ppTabbedControlBar = NULL);

Parametry

pTabControlBarAttachTo
[in, out] Określa okienko docelowe, do którego jest dołączane bieżące okienko. Okienko docelowe musi być okienkiem z możliwością dokowania.

dockMethod
[in] Określa metodę dokowania.

bSetActive
[in] TRUE aby aktywować okienko z kartami po operacji dołączania; w przeciwnym razie, FALSE.

ppTabbedControlBar
[out] Zawiera okienko z kartami, które wynika z operacji dołączania.

Wartość zwracana

Wskaźnik do bieżącego okienka, jeśli nie jest to okienko z kartami; w przeciwnym razie wskaźnik do okienka z kartami, które wynika z operacji dołączania. Zwracana wartość to NULL , jeśli bieżące okienko nie może być dołączone lub jeśli wystąpi błąd.

Uwagi

Gdy jedno okienko z możliwością dokowania jest dołączane do innego okienka przy użyciu tej metody, występują następujące czynności:

  1. Struktura sprawdza, czy okienko docelowe jest zwykłym okienkiem pTabControlBarAttachTo dokowania, czy pochodzi z CBaseTabbedPane.

  2. Jeśli okienko docelowe jest okienkiem z kartami, platforma dodaje do niego bieżące okienko jako kartę.

  3. Jeśli okienko docelowe jest zwykłym okienkiem dokowania, platforma tworzy okienko z kartami.

    • Struktura wywołuje metodę pTabControlBarAttachTo->CreateTabbedPane. Styl nowego okienka z kartami zależy od elementu m_pTabbedControlBarRTC członkowskiego. Domyślnie ten element członkowski jest ustawiony na klasę środowiska uruchomieniowego .CTabbedPane W przypadku przekazania AFX_CBRS_OUTLOOK_TABS stylu jako parametru dwTabbedStyle do CDockablePane::Create metody obiekt klasy środowiska uruchomieniowego zostanie ustawiony na klasę środowiska uruchomieniowego klasy CMFCOutlookBar. Możesz zmienić ten element członkowski w dowolnym momencie, aby zmienić styl nowego okienka.

    • Gdy ta metoda tworzy okienko z kartami, platforma zastępuje wskaźnik do pTabControlBarAttachTo (jeśli okienko jest zadokowane lub przestawne w oknie z wieloma miniframe) wskaźnikiem do nowego okienka kart.

    • Platforma dodaje pTabControlBarAttachTo okienko do okienka z kartami jako pierwszą kartę. Następnie platforma dodaje bieżące okienko jako drugą kartę.

  4. Jeśli bieżące okienko pochodzi z CBaseTabbedPaneelementu , wszystkie jej karty zostaną przeniesione do pTabControlBarAttachTo i bieżące okienko zostanie zniszczone. Dlatego należy zachować ostrożność podczas wywoływania tej metody, ponieważ wskaźnik do bieżącego okienka może być nieprawidłowy, gdy metoda zwróci.

W przypadku dołączenia jednego okienka do innego podczas tworzenia układu dokowania ustaw wartość dockMethod DM_SHOW.

Przed dołączeniem do niego innego okienka należy zadokować pierwsze okienko.

CDockablePane::CalcFixedLayout

Zwraca rozmiar prostokąta okienka.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parametry

bStretch
[in] Nieużytne.

bHorz
[in] Nieużytne.

Wartość zwracana

CSize Obiekt zawierający rozmiar prostokąta okienka.

CDockablePane::CanAcceptMiniFrame

Określa, czy określona mini-ramka może być zadokowana do okienka.

virtual BOOL CanAcceptMiniFrame(CPaneFrameWnd* pMiniFrame) const;

Parametry

pMiniFrame
[in] Wskaźnik do CPaneFrameWnd obiektu.

Wartość zwracana

TRUEjeśli pMiniFrame można zadokować do okienka; w przeciwnym razie . FALSE

CDockablePane::CanAcceptPane

Określa, czy można zadokować kolejne okienko do bieżącego okienka.

virtual BOOL CanAcceptPane(const CBasePane* pBar) const;

Parametry

pBar
[in] Określa okienko, aby zadokować do bieżącego okienka.

Wartość zwracana

TRUE jeśli określone okienko można zadokować do tego okienka; w przeciwnym razie, FALSE.

Uwagi

Struktura wywołuje tę metodę, zanim okienko zostanie zadokowane do bieżącego okienka.

Zastąp tę funkcję w klasie pochodnej, aby włączyć lub wyłączyć dokowanie do określonego okienka.

Domyślnie ta metoda zwraca TRUE wartość , jeśli pBar element nadrzędny lub jest typu CDockablePane.

CDockablePane::CanAutoHide

Określa, czy okienko może automatycznie ukrywać.

virtual BOOL CanAutoHide() const;

Wartość zwracana

TRUE jeśli okienko może się automatycznie ukryć; w przeciwnym razie, FALSE.

Uwagi

CDockablePane::CanAutoHide zwraca FALSE wartość w dowolnej z następujących sytuacji:

  • Okienko nie ma elementu nadrzędnego.

  • Menedżer dokowania nie zezwala na automatyczne ukrywanie okienek.

  • Okienko nie jest zadokowane.

CDockablePane::CanBeAttached

Określa, czy bieżące okienko można zadokować do innego okienka.

virtual BOOL CanBeAttached() const;

Wartość zwracana

TRUE jeśli okienko dokowania można zadokować do innego okienka lub do głównego okna ramowego; w przeciwnym razie, FALSE.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość TRUE. Zastąp tę metodę w klasie pochodnej, aby włączyć lub wyłączyć dokowanie bez wywoływania metody CBasePane::EnableDocking.

CDockablePane::CDockablePane

Tworzy i inicjuje CDockablePane obiekt.

CDockablePane();

Uwagi

Po utworzeniu obiektu okienka z możliwością dokowania wywołaj CDockablePane::Create lub CDockablePane::CreateEx utwórz go.

CDockablePane::ConvertToTabbedDocument

Konwertuje co najmniej jedno okienko z możliwością dokowania do dokumentów z kartami MDI.

virtual void ConvertToTabbedDocument(BOOL bActiveTabOnly = TRUE);

Parametry

bActiveTabOnly
[in] Podczas konwertowania elementu CTabbedPaneokreśl TRUE wartość , aby przekonwertować tylko aktywną kartę. Określ FALSE , aby przekonwertować wszystkie karty w okienku.

CDockablePane::CheckAutoHideCondition

Określa, czy okienko dokowania jest ukryte (nazywane również trybem automatycznego ukrywania).

virtual BOOL CheckAutoHideCondition();

Wartość zwracana

TRUE jeśli warunek ukrywania jest spełniony; w przeciwnym razie, FALSE.

Uwagi

Struktura używa czasomierza do okresowego sprawdzania, czy ukryć okienko dokowania automatycznie. Metoda zwraca TRUE wartość, gdy okienko nie jest aktywne, okienko nie jest zmieniane, a wskaźnik myszy nie znajduje się w okienku.

Jeśli zostaną spełnione wszystkie poprzednie warunki, struktura wywołuje metodę CDockablePane::Slide ukrywania okienka.

CDockablePane::CheckStopSlideCondition

Określa, kiedy okienko automatycznego zadokowania powinno przestać przesuwać się.

virtual BOOL CheckStopSlideCondition(BOOL bDirection);

Parametry

bDirection
[in] TRUE jeśli okienko jest widoczne; FALSE jeśli okienko jest ukryte.

Wartość zwracana

TRUE jeśli warunek zatrzymania jest spełniony; w przeciwnym razie, FALSE.

Uwagi

Gdy okienko z możliwością dokowania jest ustawione na tryb automatycznego ukrywania, platforma używa efektów przesuwanych do pokazywania lub ukrywania okienka. Platforma wywołuje tę funkcję, gdy okienko jest przesuwane. CheckStopSlideCondition zwraca wartość TRUE , gdy okienko jest w pełni widoczne lub gdy jest w pełni ukryte.

Zastąp tę metodę w klasie pochodnej, aby zaimplementować niestandardowe efekty autohide.

CDockablePane::CopyState

Kopiuje stan okienka z możliwością dokowania.

virtual void CopyState(CDockablePane* pOrgBar);

Parametry

pOrgBar
[in] Wskaźnik do okienka z możliwością dokowania.

Uwagi

CDockablePane::CopyState Kopiuje stan pOrgBar do bieżącego okienka, wywołując następujące metody:

CDockablePane::Create

Tworzy kontrolkę systemu Windows i dołącza ją do CDockablePane obiektu.

virtual BOOL Create(
    LPCTSTR lpszCaption,
    CWnd* pParentWnd,
    const RECT& rect,
    BOOL bHasGripper,
    UINT nID,
    DWORD dwStyle,
    DWORD dwTabbedStyle = AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE,
    CCreateContext* pContext = NULL);

virtual BOOL Create(
    LPCTSTR lpszWindowName,
    CWnd* pParentWnd,
    CSize sizeDefault,
    BOOL bHasGripper,
    UINT nID,
    DWORD dwStyle = WS_CHILD|WS_VISIBLE|CBRS_TOP|CBRS_HIDE_INPLACE,
    DWORD dwTabbedStyle = AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE);

Parametry

lpszCaption
[in] Określa nazwę okna.

pParentWnd
[in, out] Określa okno nadrzędne.

rect
[in] Określa rozmiar i położenie okna we współrzędnych pParentWndklienta .

bHasGripper
[in] TRUE aby utworzyć okienko z podpisem; w przeciwnym razie, FALSE.

nID
[in] Określa identyfikator okna podrzędnego. Ta wartość musi być unikatowa, jeśli chcesz zapisać stan dokowania dla tego okienka dokowania.

dwStyle
[in] Określa atrybuty stylu okna.

dwTabbedStyle
[in] Określa styl z kartami okna z kartami, który jest tworzony, gdy użytkownik przeciąga okienko na podpis tego okienka.

dwControlBarStyle
[in] Określa dodatkowe atrybuty stylu.

pContext
[in, out] Określa kontekst tworzenia okna.

lpszWindowName
[in] Określa nazwę okna.

sizeDefault
[in] Określa rozmiar okna.

Wartość zwracana

TRUE jeśli okienko z możliwością dokowania zostało pomyślnie utworzone; w przeciwnym razie, FALSE.

Uwagi

Tworzy okienko systemu Windows i dołącza je do CDockablePane obiektu.

dwStyle Jeśli styl okna ma flagęCBRS_FLOAT_MULTI, okno miniframe może unosić się z innymi okienkami w oknie miniframe. Domyślnie okienka dokowania mogą nosić tylko pojedynczo.

dwTabbedStyle Jeśli parametr ma określoną flagęAFX_CBRS_OUTLOOK_TABS, okienko tworzy okienka z kartami w stylu programu Outlook, gdy inne okienko jest dołączone do tego okienka CDockablePane::AttachToTabWnd przy użyciu metody . Domyślnie okienka z możliwością dokowania tworzą zwykłe okienka z kartami typu CTabbedPane.

CDockablePane::CreateDefaultPaneDivider

Tworzy domyślny podział okienka, ponieważ jest on zadokowany do okna ramki.

static CPaneDivider* __stdcall CreateDefaultPaneDivider(
    DWORD dwAlignment,
    CWnd* pParent,
    CRuntimeClass* pSliderRTC = NULL);

Parametry

dwAlignment
[in] Określa stronę ramki głównej, do której jest zadokowane okienko. Jeśli dwAlignment zawiera flagę CBRS_ALIGN_LEFT lub CBRS_ALIGN_RIGHT , ta metoda tworzy pionowy () rozdzielacz;CPaneDivider::SS_VERT w przeciwnym razie ta metoda tworzy dzielenie poziome (CPaneDivider::SS_HORZ).

pParent
[in] Wskaźnik do ramki nadrzędnej.

pSliderRTC
[in] Nieużytne.

Wartość zwracana

Ta metoda zwraca wskaźnik do nowo utworzonego dzielenia lub NULL jeśli tworzenie dzielenia zakończy się niepowodzeniem.

Uwagi

dwAlignment może być dowolną z następujących wartości:

Wartość Opis
CBRS_ALIGN_TOP Okienko jest zadokowane do góry obszaru klienta okna ramowego.
CBRS_ALIGN_BOTTOM Okienko jest zadokowane do dołu obszaru klienta okna ramowego.
CBRS_ALIGN_LEFT Okienko jest zadokowane po lewej stronie obszaru klienta okna ramowego.
CBRS_ALIGN_RIGHT Okienko jest zadokowane po prawej stronie obszaru klienta okna ramowego.

CDockablePane::CreateEx

Tworzy kontrolkę systemu Windows i dołącza ją do CDockablePane obiektu.

virtual BOOL CreateEx(
    DWORD dwStyleEx,
    LPCTSTR lpszCaption,
    CWnd* pParentWnd,
    const RECT& rect,
    BOOL bHasGripper,
    UINT nID,
    DWORD dwStyle,
    DWORD dwTabbedStyle = AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE,
    CCreateContext* pContext = NULL);

Parametry

dwStyleEx
[in] Określa atrybuty stylu rozszerzonego dla nowego okna.

lpszCaption
[in] Określa nazwę okna.

pParentWnd
[in, out] Określa okno nadrzędne.

rect
[in] Określa rozmiar i położenie okna we współrzędnych pParentWndklienta .

bHasGripper
[in] TRUE aby utworzyć okienko z podpisem; w przeciwnym razie, FALSE.

nID
[in] Określa identyfikator okna podrzędnego. Ta wartość musi być unikatowa, jeśli chcesz zapisać stan dockowania dla tego okienka dokowania.

dwStyle
[in] Określa atrybuty stylu okna.

dwTabbedStyle
[in] Określa styl z kartami okna z kartami, który jest tworzony, gdy użytkownik przeciąga okienko na podpis tego okienka.

dwControlBarStyle
[in] Określa dodatkowe atrybuty stylu.

pContext
[in, out] Określa kontekst tworzenia okna.

Wartość zwracana

TRUE jeśli okienko z możliwością dokowania zostało pomyślnie utworzone; w przeciwnym razie, FALSE.

Uwagi

Tworzy okienko systemu Windows i dołącza je do CDockablePane obiektu.

dwStyle Jeśli styl okna ma flagęCBRS_FLOAT_MULTI, okno miniframe może unosić się z innymi okienkami w oknie miniframe. Domyślnie okienka dokowania mogą nosić tylko pojedynczo.

dwTabbedStyle Jeśli parametr ma określoną flagęAFX_CBRS_OUTLOOK_TABS, okienko tworzy okienka z kartami w stylu programu Outlook, gdy inne okienko jest dołączone do tego okienka CDockablePane::AttachToTabWnd przy użyciu metody . Domyślnie okienka z możliwością dokowania tworzą zwykłe okienka z kartami typu CTabbedPane.

CDockablePane::CreateTabbedPane

Tworzy okienko z kartami z bieżącego okienka.

virtual CTabbedPane* CreateTabbedPane();

Wartość zwracana

Nowe okienko z kartami lub NULL jeśli operacja tworzenia nie powiodła się.

Uwagi

Struktura wywołuje tę metodę podczas tworzenia okienka z kartami w celu zastąpienia tego okienka. Aby uzyskać więcej informacji, zobacz CDockablePane::AttachToTabWnd.

Zastąp tę metodę w klasie pochodnej, aby dostosować sposób tworzenia i inicjowania okienek z kartami.

Okienko z kartami jest tworzone zgodnie z informacjami o klasie środowiska uruchomieniowego przechowywanymi w składowej m_pTabbedControlBarRTC , która jest inicjowana przez metodę CDockablePane::CreateEx .

CDockablePane::DockPaneContainer

Zadokuje kontener do okienka.

virtual BOOL DockPaneContainer(
    CPaneContainerManager& barContainerManager,
    DWORD dwAlignment,
    AFX_DOCK_METHOD dockMethod);

Parametry

barContainerManager
[in] Odwołanie do menedżera kontenera kontenera, który jest zadokowany.

dwAlignment
[in] DWORD który określa stronę okienka, z którą kontener jest zadokowany.

dockMethod
[in] Nieużytne.

Wartość zwracana

TRUE jeśli kontener został pomyślnie zadokowany do okienka; w przeciwnym razie, FALSE.

Uwagi

dwAlignment może być dowolną z następujących wartości:

Wartość Opis
CBRS_ALIGN_TOP Kontener jest zadokowany do góry okienka.
CBRS_ALIGN_BOTTOM Kontener jest zadokowany do dołu okienka.
CBRS_ALIGN_LEFT Kontener jest zadokowany po lewej stronie okienka.
CBRS_ALIGN_RIGHT Kontener jest zadokowany po prawej stronie okienka.

CDockablePane::DockPaneStandard

Dokowuje okienko przy użyciu zadokowania konspektu (standardowego).

virtual CPane* DockPaneStandard(BOOL& bWasDocked);

Parametry

bWasDocked
[in] Gdy metoda zwróci wartość , ta wartość zawiera TRUE informację, czy okienko zostało pomyślnie zadokowane; w przeciwnym razie zawiera FALSEwartość .

Wartość zwracana

Jeśli okienko zostało zadokowane do okna z kartą lub jeśli okno z kartą zostało utworzone w wyniku zadokowania, ta metoda zwraca wskaźnik do okna z kartą. Jeśli okienko zostało pomyślnie zadokowane, ta metoda zwraca this wskaźnik. Jeśli dockowanie nie powiodło się, ta metoda zwraca wartość NULL.

CDockablePane::DockToRecentPos

Zadokuje okienko do przechowywanej pozycji dokowania.

BOOL CDockablePane::DockToRecentPos();

Wartość zwracana

TRUE jeśli okienko zostało pomyślnie zadokowane; w przeciwnym razie, FALSE.

Uwagi

Okienka z możliwością dokowania przechowują CRecentDockSiteInfo najnowsze informacje o dokowaniu w obiekcie.

CDockablePane::DockToWindow

Zadokuje jedno okienko dokowania do innego okienka dokowania.

virtual BOOL DockToWindow(
    CDockablePane* pTargetWindow,
    DWORD dwAlignment,
    LPCRECT lpRect = NULL);

Parametry

pTargetWindow
[in, out] Określa dokowalne okienko, aby zadokować to okienko.

dwAlignment
[in] Określa wyrównanie dokowania dla okienka. Może być jednym z CBRS_ALIGN_LEFTelementów , CBRS_ALIGN_TOP, CBRS_ALIGN_BOTTOM CBRS_ALIGN_RIGHTlub CBRS_ALIGN_ANY. (Zdefiniowane w pliku afxres.h.)

lpRect
[in] Określa prostokąt dokowania dla okienka.

Wartość zwracana

TRUE jeśli okienko zostało pomyślnie zadokowane; w przeciwnym razie, FALSE.

Uwagi

Wywołaj tę metodę, aby zadokować jedno okienko do innego okienka z wyrównaniem określonym przez dwAlignment.

CDockablePane::DrawCaption

Rysuje podpis (nazywany również uchwytem) okienka dokowania.

virtual void DrawCaption(
    CDC* pDC,
    CRect rectCaption);

Parametry

pDC
[in] Reprezentuje kontekst urządzenia używany do rysowania.

rectCaption
[in] Określa prostokąt ograniczenia podpisu okienka.

Uwagi

Struktura wywołuje tę metodę, aby narysować podpis okienka z możliwością dokowania.

Zastąp tę metodę w klasie pochodnej, aby dostosować wygląd podpisu.

CDockablePane::EnableAutohideAll

Włącza lub wyłącza tryb automatycznego ukrywania dla tego okienka i innych okienek w kontenerze.

void EnableAutohideAll(BOOL bEnable = TRUE);

Parametry

bEnable
[in] TRUE aby włączyć funkcję automatycznego ukrywania wszystkich funkcji dla okienka z możliwością dokowania; w przeciwnym razie, FALSE.

Uwagi

Gdy użytkownik trzyma Ctrl i klika przycisk pinezki, aby przełączyć okienko w tryb autohide, wszystkie inne okienka w tym samym kontenerze są również przełączane do trybu automatycznego ukrywania.

Wywołaj tę metodę z ustawioną wartością bEnable , aby FALSE wyłączyć tę funkcję dla określonego okienka.

CDockablePane::EnableGripper

Wyświetla lub ukrywa podpis (nazywany również uchwytem).

virtual void EnableGripper(BOOL bEnable);

Parametry

bEnable
[in] TRUE aby włączyć podpis; w przeciwnym razie, FALSE.

Uwagi

Gdy platforma tworzy okienka z możliwością dokowania, nie mają WS_STYLE stylu okna, nawet jeśli zostanie określony. Oznacza to, że podpis okienka jest obszarem spoza klienta kontrolowanym przez platformę, ale ten obszar różni się od standardowego podpisu okna.

W dowolnym momencie możesz pokazać lub ukryć podpis. Struktura ukrywa podpis po dodaniu okienka jako karty do okna z kartą lub gdy okienko jest unoszone w oknie miniframe.

CDockablePane::GetAHRestoredRect

Określa położenie okienka w trybie automatycznego ukrywania.

CRect GetAHRestoredRect() const;

Wartość zwracana

CRect Obiekt, który zawiera położenie okienka, gdy jest w trybie automatycznego ukrywania.

Uwagi

CDockablePane::GetAHSlideMode

Pobiera tryb automatycznego ukrywania slajdów dla okienka.

virtual UINT GetAHSlideMode() const;

Wartość zwracana

Element UINT określający tryb automatycznego ukrywania slajdów dla okienka. Wartość zwracana może mieć wartość AFX_AHSM_MOVE lub AFX_AHSM_STRETCH, ale implementacja używa AFX_AHSM_MOVEtylko wartości .

Uwagi

CDockablePane::GetCaptionHeight

Zwraca wysokość w pikselach bieżącego podpisu.

virtual int GetCaptionHeight() const;

Wartość zwracana

Wysokość podpisu w pikselach.

Uwagi

Wysokość podpisu wynosi 0, jeśli podpis został ukryty przez metodę CDockablePane::EnableGripper lub jeśli okienko nie ma podpisu.

CDockablePane::GetDefaultPaneDivider

Zwraca domyślny podział okienka dla kontenera okienka.

CPaneDivider* GetDefaultPaneDivider() const;

Wartość zwracana

Prawidłowy CPaneDivider obiekt, jeśli okienko dokowania jest zadokowane do głównego okna ramowego lub NULL jeśli okienko dokowania nie jest zadokowane lub jeśli jest przestawne.

Uwagi

Aby uzyskać więcej informacji na temat dzielenia okienek, zobacz CPaneDivider Klasa.

CDockablePane::GetDockingStatus

Określa możliwość zadokowania okienka na podstawie podanej lokalizacji wskaźnika.

virtual AFX_CS_STATUS GetDockingStatus(
    CPoint pt,
    int nSensitivity);

Parametry

pt
[in] Lokalizacja wskaźnika we współrzędnych ekranu.

nSensitivity
[in] Odległość w pikselach z dala od krawędzi prostokąta wskaźnika musi być włączona dokowania.

Wartość zwracana

Jedna z następujących wartości stanu:

AFX_CS_STATUS wartość Znaczenie
CS_NOTHING Wskaźnik nie znajduje się w miejscu dokowania. Platforma nie zadokuje okienka.
CS_DOCK_IMMEDIATELY Wskaźnik znajduje się w miejscu dokowania w trybie natychmiastowym (okienko używa DT_IMMEDIATE trybu dokowania). Platforma natychmiast zadokuje okienko.
CS_DELAY_DOCK Wskaźnik znajduje się w miejscu dokowania, który jest innym okienkiem dokowania lub jest krawędzią ramki głównej. Struktura zadokuje okienko po opóźnieniu. Aby uzyskać więcej informacji na temat tego opóźnienia, zobacz sekcję Uwagi.
CS_DELAY_DOCK_TO_TAB Wskaźnik znajduje się nad lokacją docka, która powoduje, że okienko jest zadokowane w oknie z kartami. Dzieje się tak, gdy wskaźnik znajduje się nad podpisem innego okienka dokowania lub obszarem karty okienka z kartą.

Uwagi

Struktura wywołuje tę metodę do obsługi zadokowania przestawnego okienka.

W przypadku przestawnych pasków narzędzi lub okienek dokowania korzystających z DT_IMMEDIATE trybu dokowania platforma opóźnia polecenie dock, aby umożliwić użytkownikowi przeniesienie okna z obszaru klienta ramki nadrzędnej przed dokowaniem. Długość opóźnienia jest mierzona w milisekundach i jest kontrolowana przez element członkowski CDockingManager::m_nTimeOutBeforeToolBarDock danych. Wartość domyślna to CDockingManager::m_nTimeOutBeforeToolBarDock 200. To zachowanie emuluje zachowanie dokowania programu Microsoft Word 2007.

W przypadku opóźnionych stanów dokowania (CS_DELAY_DOCK i CS_DELAY_DOCK_TO_TAB) struktura nie wykonuje zadokowania, dopóki użytkownik nie zwolni przycisku myszy. Jeśli okienko używa DT_STANDARD trybu dokowania, platforma wyświetla prostokąt w przewidywanej lokalizacji dokowania. Jeśli okienko używa DT_SMART trybu dokowania, platforma wyświetla inteligentne znaczniki dokowania i półprzezroczyste prostokąty w przewidywanej lokalizacji dokowania. Aby określić tryb dokowania dla okienka, wywołaj metodę CBasePane::SetDockingMode . Aby uzyskać więcej informacji na temat inteligentnego dokowania, zobacz CDockingManager::GetSmartDockingParams.

CDockablePane::GetDragSensitivity

Zwraca czułość przeciągania okienka dokowania.

static const CSize& GetDragSensitivity();

Wartość zwracana

CSize Obiekt, który zawiera szerokość i wysokość w pikselach prostokąta wyśrodkowanego na punkcie przeciągania. Operacja przeciągania nie rozpoczyna się, dopóki wskaźnik myszy nie zostanie przeniesiony poza ten prostokąt.

CDockablePane::GetLastPercentInPaneContainer

Pobiera procent miejsca zajmowanego przez okienko w kontenerze ( CPaneContainer Klasa).

int GetLastPercentInPaneContainer() const;

Wartość zwracana

Element int określający procent miejsca zajmowanego przez okienko w kontenerze.

Uwagi

Ta metoda jest używana, gdy kontener dostosowuje jego układ.

CDockablePane::GetTabArea

Pobiera obszar karty dla okienka.

virtual void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const;

Parametry

rectTabAreaTop
[in] GetTabArea Wypełnia tę zmienną obszarem karty, jeśli karty znajdują się w górnej części okienka. Jeśli karty znajdują się w dolnej części okienka, ta zmienna jest wypełniona pustym prostokątem.

rectTabAreaBottom
[in] GetTabArea Wypełnia tę zmienną obszarem tabulacji, jeśli karty znajdują się w dolnej części okienka. Jeśli karty znajdują się w górnej części okienka, ta zmienna jest wypełniona pustym prostokątem.

Uwagi

Ta metoda jest używana tylko w klasach, z których pochodzą CDockablePane i mają karty. Aby uzyskać więcej informacji, zobacz tematy CTabbedPane::GetTabArea oraz CMFCOutlookBar::GetTabArea.

CDockablePane::GetTabbedPaneRTC

Zwraca informacje o klasie środowiska uruchomieniowego dotyczące okna z kartami utworzonego podczas dokowania innego okienka do bieżącego okienka.

CRuntimeClass* GetTabbedPaneRTC() const;

Wartość zwracana

Informacje o klasie środowiska uruchomieniowego dla okienka z możliwością dokowania.

Uwagi

Wywołaj tę metodę, aby pobrać informacje o klasie środowiska uruchomieniowego dla okienk z kartami, które są tworzone dynamicznie. Taka sytuacja może wystąpić, gdy użytkownik przeciąga jedno okienko do podpisu innego okienka lub jeśli wywołasz CDockablePane::AttachToTabWnd metodę w celu programowego utworzenia okienka z kartami z dwóch okienk dokowania.

Informacje o klasie środowiska uruchomieniowego można ustawić, wywołując metodę CDockablePane::SetTabbedPaneRTC .

CDockablePane::HasAutoHideMode

Określa, czy okienko dokowania można przełączyć do trybu automatycznego ukrywania.

virtual BOOL HasAutoHideMode() const;

Wartość zwracana

TRUE jeśli okienko z możliwością dokowania można przełączyć na tryb automatycznego ukrywania; w przeciwnym razie, FALSE.

Uwagi

Zastąp tę metodę w klasie pochodnej, aby wyłączyć tryb automatycznego ukrywania dla określonego okienka z możliwością dokowania.

CDockablePane::HitTest

Określa lokalizację w okienku, w którym użytkownik klika mysz.

virtual int HitTest(
    CPoint point,
    BOOL bDetectCaption = FALSE);

Parametry

point
[in] Określa punkt do przetestowania.

bDetectCaption
[in] TRUE jeśli HTCAPTION punkt ma znajdować się w podpisie okienka, w przeciwnym razie FALSE.

Wartość zwracana

Jedna z następujących wartości:

  • HTNOWHERE jeśli point nie znajduje się w okienku z możliwością dokowania.

  • HTCLIENT jeśli point znajduje się w obszarze klienta okienka z możliwością dokowania.

  • HTCAPTION jeśli point znajduje się w obszarze podpisu okienka z możliwością dokowania.

  • AFX_HTCLOSE jeśli point znajduje się na przycisku zamknij.

  • HTMAXBUTTON jeśli point znajduje się na przycisku pinezki.

CDockablePane::IsAutohideAllEnabled

Wskazuje, czy okienko dokowania i wszystkie inne okienka w kontenerze można przełączyć na tryb automatycznego ukrywania.

virtual BOOL IsAutohideAllEnabled() const;

Wartość zwracana

TRUE jeśli okienko z możliwością dokowania i wszystkie inne okienka w kontenerze, można przełączyć się na tryb automatycznego ukrywania; w przeciwnym razie, FALSE.

Uwagi

Użytkownik włącza tryb automatycznego ukrywania, klikając przycisk zadokowania przypinania przytrzymując Ctrl

Aby włączyć lub wyłączyć to zachowanie, wywołaj metodę CDockablePane::EnableAutohideAll .

CDockablePane::IsAutoHideMode

Określa, czy okienko jest w trybie automatycznego ukrywania.

virtual BOOL IsAutoHideMode() const;

Wartość zwracana

TRUE jeśli okienko z możliwością dokowania jest w trybie automatycznego ukrywania; w przeciwnym razie, FALSE.

CDockablePane::IsDocked

Określa, czy bieżące okienko jest zadokowane.

virtual BOOL IsDocked() const;

Wartość zwracana

TRUE jeśli okienko z możliwością dokowania nie należy do okna miniframe lub jeśli unosi się w oknie miniframe z innym okienkiem. FALSE jeśli okienko jest elementem podrzędnym okna miniframe i nie ma żadnych innych okienek należących do okna miniframe.

Uwagi

Aby określić, czy okienko jest zadokowane do głównego okna ramowego, wywołaj metodę CDockablePane::GetDefaultPaneDivider. Jeśli metoda zwracaNULL wskaźnik inny niż wskaźnik, okienko jest zadokowane w głównym oknie ramki.

CDockablePane::IsHideInAutoHideMode

Określa zachowanie okienka, które jest w trybie autohide, jeśli jest wyświetlane (lub ukryte) przez wywołanie metody CDockablePane::ShowPane.

virtual BOOL IsHideInAutoHideMode() const;

Wartość zwracana

TRUE jeśli okienko z możliwością dokowania powinno być ukryte w trybie automatycznego ukrywania; w przeciwnym razie, FALSE.

Uwagi

Gdy okienko z możliwością dokowania jest w trybie automatycznego ukrywania, zachowuje się inaczej podczas wywoływania ShowPane w celu ukrycia lub wyświetlenia okienka. To zachowanie jest kontrolowane przez statyczny element członkowski CDockablePane::m_bHideInAutoHideMode. Jeśli ten element członkowski to TRUE, okienko z możliwością dokowania i powiązany z nią autohide pasek narzędzi lub przycisk autohide są ukryte lub wyświetlane podczas wywoływania polecenia ShowPane. W przeciwnym razie okienko z możliwością dokowania jest aktywowane lub dezaktywowane, a jego powiązany autohide pasek narzędzi lub przycisk autohide są zawsze widoczne.

Zastąp tę metodę w klasie pochodnej, aby zmienić domyślne zachowanie poszczególnych okienek.

Wartość domyślna parametru m_bHideInAutoHideMode to FALSE.

CDockablePane::IsInFloatingMultiPaneFrameWnd

Określa, czy okienko znajduje się w oknie ramek z wieloma okienkami ( CMultiPaneFrameWnd Class).

virtual BOOL IsInFloatingMultiPaneFrameWnd() const;

Wartość zwracana

TRUE jeśli okienko znajduje się w oknie ramowym z wieloma okienkami; w przeciwnym razie, FALSE.

Uwagi

CDockablePane::IsResizable

Określa, czy okienko jest możliwe do zmiany rozmiaru.

virtual BOOL IsResizable() const;

Wartość zwracana

TRUE jeśli okienko jest możliwe do zmiany rozmiaru; w przeciwnym razie, FALSE.

Uwagi

Domyślnie okienka z możliwością dokowania można zmieniać rozmiar. Aby zapobiec zmianie rozmiaru, przesłoń tę metodę w klasie pochodnej i zwróć wartość FALSE. Należy pamiętać, że FALSE wartość prowadzi do błędu ASSERT w pliku CPane::DockPane. Zamiast tego służy CDockingManager::AddPane do dokowania okienka w ramce nadrzędnej.

Nie można zmieniać rozmiaru okienek ani nie może wprowadzać trybu automatycznego ukrywania ani znajdować się na zewnętrznej krawędzi ramki nadrzędnej.

CDockablePane::IsTabLocationBottom

Określa, czy karty znajdują się w górnej lub dolnej części okienka.

virtual BOOL IsTabLocationBottom() const;

Wartość zwracana

TRUE jeśli karty znajdują się w dolnej części okienka; FALSE jeśli karty znajdują się w górnej części okienka.

Uwagi

Aby uzyskać więcej informacji, zobacz CTabbedPane::IsTabLocationBottom.

CDockablePane::IsTracked

Określa, czy okienko jest przenoszone przez użytkownika.

BOOL IsTracked() const;

Wartość zwracana

TRUE jeśli okienko jest przenoszone; w przeciwnym razie, FALSE.

CDockablePane::IsVisible

Określa, czy bieżące okienko jest widoczne.

virtual BOOL IsVisible() const;

Wartość zwracana

TRUE jeśli okienko z możliwością dokowania jest widoczne; w przeciwnym razie, FALSE.

Uwagi

Wywołaj tę metodę, aby określić, czy okienko z możliwością dokowania jest widoczne. Tej metody można użyć zamiast wywoływania CWnd::IsWindowVisible lub testowania WS_VISIBLE stylu. Zwrócony stan widoczności zależy od tego, czy tryb automatycznego ukrywania jest włączony, czy wyłączony oraz od wartości CDockablePane::IsHideInAutoHideMode właściwości.

Jeśli okienko z możliwością dokowania jest w trybie automatycznego ukrywania i IsHideInAutoHideMode zwraca FALSE stan widoczności to zawsze FALSE.

Jeśli okienko z możliwością dokowania jest w trybie automatycznego ukrywania i IsHideInAutoHideMode zwraca TRUE stan widoczności, zależy od stanu widoczności powiązanego paska narzędzi automatycznego ukrywania.

Jeśli okienko z możliwością dokowania nie jest w trybie automatycznego ukrywania, stan widoczności jest określany przez metodę CBasePane::IsVisible .

## CDockablePane::LoadState

Tylko do użytku wewnętrznego. Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w mfc folderze instalacji programu Visual Studio. Na przykład %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual BOOL LoadState(
   LPCTSTR lpszProfileName = NULL,
   int nIndex = -1,
   UINT uiID = (UINT) -1
);

CDockablePane::m_bDisableAnimation

Określa, czy automatycznie ukrywana animacja okienka z możliwością dokowania jest wyłączona.

AFX_IMPORT_DATA static BOOL m_bDisableAnimation;

CDockablePane::m_bHideInAutoHideMode

Określa zachowanie okienka, gdy okienko jest w trybie automatycznego ukrywania.

AFX_IMPORT_DATA static BOOL m_bHideInAutoHideMode;

Uwagi

Ta wartość ma wpływ na wszystkie okienka dokowania w aplikacji.

Jeśli ustawisz ten element członkowski na TRUE, okienka z możliwością dokowania są ukryte lub wyświetlane przy użyciu powiązanych automatycznych pasków narzędzi i przycisków podczas wywoływania polecenia CDockablePane::ShowPane.

Jeśli ustawisz ten element członkowski na FALSE, okienka z możliwością dokowania są aktywowane lub dezaktywowane podczas wywoływania elementu CDockablePane::ShowPane.

CDockablePane::m_nSlideSteps

Określa szybkość animacji okienka, gdy jest w trybie autohide.

AFX_IMPORT_DATA static int m_nSlideSteps;

Uwagi

Aby uzyskać szybszy efekt animacji, zmniejsz tę wartość. W przypadku wolniejszego efektu animacji zwiększ tę wartość.

CDockablePane::OnAfterChangeParent

Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w mfc folderze instalacji programu Visual Studio. Na przykład %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual void OnAfterChangeParent(CWnd* pWndOldParent);

Parametry

[in] pWndOldParent\

Uwagi

CDockablePane::OnAfterDockFromMiniFrame

Wywoływana przez platformę, gdy pływający pasek dokowania dokuje w oknie ramowym.

virtual void OnAfterDockFromMiniFrame();

Uwagi

Domyślnie ta metoda nic nie robi.

CDockablePane::OnBeforeChangeParent

Struktura wywołuje tę metodę przed zmianą elementu nadrzędnego okienka.

virtual void OnBeforeChangeParent(
    CWnd* pWndNewParent,
    BOOL bDelay = FALSE);

Parametry

pWndNewParent
[in] Wskaźnik do nowego okna nadrzędnego.

bDelay
[in] Wartość logiczna określająca, czy opóźnić ponowne obliczanie układu dokowania, jeśli okienko jest oddokowane. Aby uzyskać więcej informacji, zobacz CDockablePane::UndockPane.

Uwagi

Jeśli okienko jest zadokowane, a nowy element nadrzędny nie zezwala na dokowanie, ta metoda oddokuje okienko.

Jeśli okienko jest konwertowane na dokument z kartami, ta metoda przechowuje ostatnie położenie dokowania. Struktura używa ostatniego położenia dokowania, aby przywrócić położenie okienka po przekonwertowaniu z powrotem na stan zadokowany.

CDockablePane::OnBeforeFloat

Struktura wywołuje tę metodę przed przejściem okienka do stanu zmiennoprzecinkowego.

virtual BOOL OnBeforeFloat(
    CRect& rectFloat,
    AFX_DOCK_METHOD dockMethod);

Parametry

rectFloat
[in] Określa położenie i rozmiar okienka, gdy znajduje się on w stanie zmiennoprzecinkowa.

dockMethod
[in] Określa metodę dokowania. Zobacz CPane::DockPane listę możliwych wartości.

Wartość zwracana

TRUE jeśli okienko może być zmiennoprzecinkowe; w przeciwnym razie, FALSE.

Uwagi

Ta metoda jest wywoływana przez platformę, gdy okienko ma upłynąć zmiennoprzecinkowe. Tę metodę można zastąpić w klasie pochodnej, jeśli chcesz wykonać jakiekolwiek przetwarzanie przed upłynięciem okienka.

CDockablePane::OnPressButtons

Wywoływana, gdy użytkownik naciska przycisk podpisu inny niż AFX_HTCLOSE przyciski i AFX_HTMAXBUTTON .

virtual void OnPressButtons(UINT nHit);

Parametry

nHit
[in] Ten parametr nie jest używany.

Uwagi

Jeśli dodasz przycisk niestandardowy do podpisu okienka z możliwością dokowania, przesłoń tę metodę, aby otrzymywać powiadomienia po naciśnięciu przycisku przez użytkownika.

CDockablePane::OnSlide

Wywoływana przez platformę w celu animowania okienka w trybie automatycznego ukrywania.

virtual void OnSlide(BOOL bSlideOut);

Parametry

bSlideOut
[in] TRUE aby wyświetlić okienko; FALSE aby ukryć okienko.

Uwagi

Zastąp tę metodę w klasie pochodnej, aby zaimplementować niestandardowe efekty autohide.

CDockablePane::RemoveFromDefaultPaneDividier

Struktura wywołuje tę metodę, gdy okienko jest oddokowane.

void RemoveFromDefaultPaneDividier();

Uwagi

Ta metoda ustawia domyślny podział okienka na NULL i usuwa okienko z kontenera.

CDockablePane::ReplacePane

Zamienia okienko na określone okienko.

BOOL ReplacePane(
    CDockablePane* pBarToReplaceWith,
    AFX_DOCK_METHOD dockMethod,
    BOOL bRegisterWithFrame = FALSE);

Parametry

pBarToReplaceWith
[in] Wskaźnik do okienka z możliwością dokowania.

dockMethod
[in] Nieużytne.

bRegisterWithFrame
[in] Jeśli TRUEnowe okienko zostanie zarejestrowane w menedżerze dokowania elementu nadrzędnego starego okienka. Nowe okienko jest wstawione do indeksu starego okienka na liście okienek obsługiwanych przez menedżera dokowania.

Wartość zwracana

TRUE jeśli zastąpienie zakończy się powodzeniem; w przeciwnym razie, FALSE.

CDockablePane::RestoreDefaultPaneDivider

Gdy okienko jest deserializowane, struktura wywołuje tę metodę, aby przywrócić domyślny podział okienka.

void RestoreDefaultPaneDivider();

Uwagi

Przywrócony domyślny podział okienka zastępuje bieżący domyślny podział okienka, jeśli istnieje.

CDockablePane::SetAutoHideMode

Przełącza okienko dokowania między trybem widocznym i automatycznym.

virtual CMFCAutoHideBar* SetAutoHideMode(
    BOOL bMode,
    DWORD dwAlignment,
    CMFCAutoHideBar* pCurrAutoHideBar = NULL,
    BOOL bUseTimer = TRUE);

Parametry

bMode
[in] TRUE aby włączyć tryb automatycznego ukrywania; FALSE aby włączyć zwykły tryb dokowania.

dwAlignment
[in] Określa wyrównanie okienka autohide do utworzenia.

pCurrAutoHideBar
[in, out] Wskaźnik do bieżącego paska narzędzi autohide. Może to być NULL.

bUseTimer
[in] Określa, czy używać efektu autohide, gdy użytkownik przełącza okienko w tryb autohide, czy ukrywa okienko natychmiast.

Wartość zwracana

Automatycznie ukrywany pasek narzędzi, który został utworzony w wyniku przełączenia do trybu automatycznego ukrywania lub NULL.

Uwagi

Struktura wywołuje tę metodę, gdy użytkownik kliknie przycisk pinezki, aby przełączyć okienko z możliwością dokowania do trybu automatycznego lub zwykłego trybu dokowania.

Wywołaj tę metodę, aby przełączyć okienko z możliwością dokowania w trybie programowym. Okienko musi być zadokowane do głównego okna ramowego ( CDockablePane::GetDefaultPaneDivider musi zwrócić prawidłowy wskaźnik do CPaneDividerelementu ).

CDockablePane::SetAutoHideParents

Ustawia przycisk automatycznego ukrywania i automatycznie ukrywa pasek narzędzi okienka.

void SetAutoHideParents(
    CMFCAutoHideBar* pToolBar,
    CMFCAutoHideButton* pBtn);

Parametry

pToolBar
[in] Wskaźnik do paska narzędzi automatycznego ukrywania.

pBtn
[in] Wskaźnik do przycisku automatycznego ukrywania.

CDockablePane::SetLastPercentInPaneContainer

Ustawia procent miejsca zajmowanego przez okienko w kontenerze.

void SetLastPercentInPaneContainer(int n);

Parametry

n
[in] Element int określający procent miejsca zajmowanego przez okienko w kontenerze.

Uwagi

Platforma dostosowuje okienko, aby używać nowej wartości podczas ponownego obliczania układu.

CDockablePane::SetRestoredDefaultPaneDivider

Ustawia przywrócony domyślny podział okienka.

void SetRestoredDefaultPaneDivider(HWND hRestoredSlider);

Parametry

hRestoredSlider
[in] Uchwyt do podziału okienka (suwak).

Uwagi

Przywrócony domyślny podział okienka jest uzyskiwany po deserializacji okienka. Aby uzyskać więcej informacji, zobacz CDockablePane::RestoreDefaultPaneDivider.

CDockablePane::SetTabbedPaneRTC

Ustawia informacje o klasie środowiska uruchomieniowego dla okna z kartami, które jest tworzone podczas łączenia dwóch okienek.

void SetTabbedPaneRTC(CRuntimeClass* pRTC);

Parametry

pRTC
[in] Informacje o klasie środowiska uruchomieniowego dla okienka z kartami.

Uwagi

Wywołaj tę metodę, aby ustawić informacje o klasie środowiska uruchomieniowego dla okienk z kartami, które są tworzone dynamicznie. Taka sytuacja może wystąpić, gdy użytkownik przeciąga jedno okienko do podpisu innego okienka lub jeśli wywołasz CDockablePane::AttachToTabWnd metodę w celu programowego utworzenia okienka z kartami z dwóch okienk dokowania.

Domyślna klasa środowiska uruchomieniowego jest ustawiana zgodnie z parametrem dwTabbedStyle i CDockablePane::Create CDockablePane::CreateEx. Aby dostosować nowe okienka z kartami, utwórz klasę z jednej z następujących klas:

Następnie wywołaj tę metodę za pomocą wskaźnika do informacji o klasie środowiska uruchomieniowego.

CDockablePane::ShowPane

Wyświetla lub ukrywa okienko.

virtual void ShowPane(
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Parametry

bShow
[in] TRUE aby wyświetlić okienko; FALSE aby ukryć okienko.

bDelay
[in] TRUE aby opóźnić dostosowywanie układu dokowania; FALSE aby natychmiast dostosować układ dokowania.

bActivate
[in] TRUE w celu aktywowania okienka po wyświetleniu; w przeciwnym razie, FALSE.

Uwagi

Wywołaj tę metodę zamiast CWnd::ShowWindow podczas wyświetlania lub ukrywania okienek z możliwością dokowania.

CDockablePane::Slide

Animuje okienko, które jest w trybie automatycznego ukrywania.

virtual void Slide(
    BOOL bSlideOut,
    BOOL bUseTimer = TRUE);

Parametry

bSlideOut
[in] TRUE aby wyświetlić okienko; FALSE aby ukryć okienko.

bUseTimer
[in] TRUE aby wyświetlić lub ukryć okienko za pomocą efektu autohide; FALSE aby wyświetlić lub ukryć okienko natychmiast.

Uwagi

Struktura wywołuje tę metodę, aby animować okienko, które jest w trybie autohide.

Ta metoda używa CDockablePane::m_nSlideDefaultTimeOut wartości w celu określenia limitu czasu efektu slajdu. Wartość domyślna limitu czasu wynosi 1. Jeśli dostosujesz algorytm autohide, zmodyfikuj ten element członkowski, aby zmienić limit czasu.

CDockablePane::ToggleAutoHide

Przełącza okienko między trybem zawsze widocznym i automatycznym.

virtual void ToggleAutoHide();

Uwagi

Ta metoda przełącza tryb automatycznego ukrywania okienka przez wywołanie metody CDockablePane::SetAutoHideMode.

CDockablePane::UndockPane

Oddokuje okienko z głównego okna ramowego lub kontenera okien miniframe.

virtual void UndockPane(BOOL bDelay = FALSE);

Parametry

bDelay
[in] TRUE aby opóźnić obliczanie układu dokowania; FALSE aby natychmiast ponownie obliczyć układ dokowania.

Uwagi

Wywołaj tę metodę, aby oddokować okienko z okna głównego ramki lub z kontenera okien z wieloma miniframe (okienko unoszące się w jednym oknie miniframe z innymi okienkami).

Przed wykonaniem jakiejkolwiek operacji zewnętrznej, która nie jest wykonywana przez program , należy oddokować okienko CDockingManager. Na przykład należy oddokować okienko, aby programowo przenieść je z jednej lokalizacji do innej.

Platforma automatycznie oddokuje okienka przed ich zniszczeniem.

Zobacz też

Wykres hierarchii
Klasy
CPane Klasa