Udostępnij za pośrednictwem


Klasa CDockingManager

Implementuje podstawowe funkcje, które sterują układem dokowania w głównym oknie ramowym.

Składnia

class CDockingManager : public CObject

Elementy członkowskie

Metody publiczne

Nazwa/nazwisko opis
CDockingManager::AddDockSite Tworzy okienko docku i dodaje je do listy pasków sterowania.
CDockingManager::AddHiddenMDITabbedBar Dodaje uchwyt do okienka paska do listy ukrytych okienek paska z kartami MDI.
CDockingManager::AddMiniFrame Dodaje ramkę do listy mini ramek.
CDockingManager::AddPane Rejestruje okienko za pomocą menedżera dokowania.
CDockingManager::AdjustDockingLayout Oblicza ponownie i dostosowuje układ wszystkich okienek w oknie ramowym.
CDockingManager::AdjustPaneFrames Powoduje wysłanie komunikatu WM_NCCALCSIZE do wszystkich okien i CPaneFrameWnd okien.
CDockingManager::AdjustRectToClientArea Dostosowuje wyrównanie prostokąta.
CDockingManager::AlignAutoHidePane Zmienia rozmiar okienka dokowania w trybie automatycznego ukrywania, dzięki czemu zajmuje pełną szerokość lub wysokość obszaru klienta ramki otoczonej lokacjami dokowania.
CDockingManager::AutoHidePane Tworzy automatycznie ukrywany pasek narzędzi.
CDockingManager::BringBarsToTop Przenosi zadokowane słupki, które mają określone wyrównanie do góry.
CDockingManager::BuildPanesMenu Dodaje nazwy okienek dokowania i pasków narzędzi do menu.
CDockingManager::CalcExpectedDockedRect Oblicza oczekiwany prostokąt zadokowanego okna.
CDockingManager::Create Tworzy menedżera dokowania.
CDockingManager::D eterminePaneAndStatus Określa okienko zawierające dany punkt i jego stan dokowania.
CDockingManager::D isableRestoreDockState Włącza lub wyłącza ładowanie układu dokowania z rejestru.
CDockingManager::D ockPane Zadokuje okienko do innego okienka lub okna ramowego.
CDockingManager::D ockPaneLeftOf Zadokuje okienko po lewej stronie innego okienka.
CDockingManager::EnableAutoHidePanes Umożliwia zadokowanie okienka do ramki głównej, tworzy okienko dokowania i dodaje je do listy pasków sterowania.
CDockingManager::EnableDocking Tworzy okienko docku i umożliwia dokowanie okienka do ramki głównej.
CDockingManager::EnableDockSiteMenu Wyświetla dodatkowy przycisk, który otwiera wyskakujące menu w podpisach wszystkich okienek dokowania.
CDockingManager::EnablePaneContextMenu Informuje bibliotekę o wyświetlaniu specjalnego menu kontekstowego z listą pasków narzędzi aplikacji i okienkami dokowania, gdy użytkownik kliknie prawym przyciskiem myszy, a biblioteka przetwarza komunikat WM_CONTEXTMENU.
CDockingManager::FindDockSite Pobiera okienko paska, które znajduje się na określonej pozycji i ma określone wyrównanie.
CDockingManager::FindDockSiteByPane Zwraca okienko paska, które ma identyfikator okienka paska docelowego.
CDockingManager::FindPaneByID Znajduje okienko według określonego identyfikatora kontrolki.
CDockingManager::FixupVirtualRects Zatwierdza wszystkie bieżące pozycje paska narzędzi w wirtualnych prostokątach.
CDockingManager::FrameFromPoint Zwraca ramkę zawierającą dany punkt.
CDockingManager::GetClientAreaBounds Pobiera prostokąt zawierający granice obszaru klienta.
CDockingManager::GetDockingMode Zwraca bieżący tryb dokowania.
CDockingManager::GetDockSiteFrameWnd Pobiera wskaźnik do ramki okna nadrzędnego.
CDockingManager::GetEnabledAutoHideAlignment Zwraca włączone wyrównanie okienek.
CDockingManager::GetMiniFrames Pobiera listę miniframe.
CDockingManager::GetOuterEdgeBounds Pobiera prostokąt zawierający zewnętrzne krawędzie ramki.
CDockingManager::GetPaneList Zwraca listę okienek należących do menedżera dokowania. Obejmuje to wszystkie przestawne okienka.
CDockingManager::GetSmartDockingManager Pobiera wskaźnik do menedżera inteligentnego dokowania.
CDockingManager::GetSmartDockingManagerPermanent Pobiera wskaźnik do menedżera inteligentnego dokowania.
CDockingManager::GetSmartDockingParams Zwraca parametry inteligentnego dokowania dla menedżera dokowania.
CDockingManager::GetSmartDockingTheme Metoda statyczna zwracająca motyw używany do wyświetlania znaczników inteligentnego dokowania.
CDockingManager::HideAutoHidePanes Ukrywa okienko w trybie automatycznego ukrywania.
CDockingManager::InsertDockSite Tworzy okienko docku i wstawia je do listy pasków sterowania.
CDockingManager::InsertPane Wstawia okienko kontrolki do listy pasków kontrolek.
CDockingManager::IsDockSiteMenu Określa, czy menu podręczne jest wyświetlane w podpisach wszystkich okienek.
CDockingManager::IsInAdjustLayout Określa, czy układy wszystkich okienek są dostosowywane.
CDockingManager::IsOLEContainerMode Określa, czy menedżer dokowania jest w trybie kontenera OLE.
CDockingManager::IsPointNearDockSite Określa, czy określony punkt znajduje się w pobliżu lokacji docku.
CDockingManager::IsPrintPreviewValid Określa, czy jest ustawiony tryb podglądu wydruku.
CDockingManager::LoadState Ładuje stan menedżera dokowania z rejestru.
CDockingManager::LockUpdate Blokuje podane okno.
CDockingManager::OnActivateFrame Wywoływana przez platformę, gdy okno ramki jest aktywne lub dezaktywowane.
CDockingManager::OnClosePopupMenu Wywoływana przez platformę, gdy aktywne menu podręczne przetwarza komunikat WM_DESTROY.
CDockingManager::OnMoveMiniFrame Wywoływana przez platformę w celu przeniesienia okna mini-ramka.
CDockingManager::OnPaneContextMenu Wywoływana przez platformę podczas kompilowania menu zawierającego listę okienek.
CDockingManager::P aneFromPoint Zwraca okienko zawierające dany punkt.
CDockingManager::P rocessPaneContextMenuCommand Wywoływana przez platformę do zaznaczenia lub wyczyszczenia pola wyboru dla określonego polecenia i ponowne obliczenie układu wyświetlanego okienka.
CDockingManager::RecalcLayout Oblicza ponownie wewnętrzny układ kontrolek znajdujących się na liście kontrolek.
CDockingManager::ReleaseEmptyPaneContainers Zwalnia puste kontenery okienka.
CDockingManager::RemoveHiddenMDITabbedBar Usuwa określone ukryte okienko paska.
CDockingManager::RemoveMiniFrame Usuwa określoną ramkę z listy mini ramek.
CDockingManager::RemovePaneFromDockManager Wyrejestrowuje okienko i usuwa je z listy w menedżerze dokowania.
CDockingManager::ReplacePane Zamienia jedno okienko na inne.
CDockingManager::ResortMiniFramesForZOrder Ucieka ramek na liście mini ramek.
CDockingManager::SaveState Zapisuje stan menedżera dokowania do rejestru.
CDockingManager::SendMessageToMiniFrames Wysyła określony komunikat do wszystkich mini ramek.
CDockingManager::Serialize Zapisuje menedżera dokowania do archiwum. (Przesłonięcia) CObject::Serialize.)
CDockingManager::SetAutohideZOrder Ustawia rozmiar, szerokość i wysokość pasków sterujących oraz określone okienko.
CDockingManager::SetDockingMode Ustawia tryb dokowania.
CDockingManager::SetDockState Ustawia stan dokowania pasków sterujących, mini ramek i pasków autohide.
CDockingManager::SetPrintPreviewMode Ustawia tryb podglądu wydruku pasków wyświetlanych w podglądzie wydruku.
CDockingManager::SetSmartDockingParams Ustawia parametry definiujące zachowanie inteligentnego dokowania.
CDockingManager::ShowDelayShowMiniFrames Pokazuje lub ukrywa okna mini ramek.
CDockingManager::ShowPanes Wyświetla lub ukrywa okienka kontrolki i automatycznie ukrywa paski.
CDockingManager::StartSDocking Uruchamia inteligentne dokowanie określonego okna zgodnie z dopasowaniem inteligentnego menedżera dokowania.
CDockingManager::StopSDocking Zatrzymuje inteligentne dokowanie.

Składowe danych

Nazwa/nazwisko opis
CDockingManager::m_bHideDockingBarsInContainerMode Określa, czy menedżer dokowania ukrywa okienka w trybie kontenera OLE.
CDockingManager::m_dockModeGlobal Określa globalny tryb dokowania.
CDockingManager::m_nDockSensitivity Określa czułość dokowania.
CDockingManager::m_nTimeOutBeforeDockingBarDock Określa czas w milisekundach, zanim okienko dockowania zostanie zadokowane w trybie natychmiastowego dokowania.
CDockingManager::m_nTimeOutBeforeToolBarDock Określa czas w milisekundach, zanim pasek narzędzi zostanie zadokowany do głównego okna ramki.

Uwagi

Główne okno ramki tworzy i inicjuje tę klasę automatycznie.

Obiekt menedżera dokowania zawiera listę wszystkich okienek znajdujących się w układzie dokowania, a także listę wszystkich okien CPaneFrameWnd należących do głównego okna ramki.

Klasa CDockingManager implementuje niektóre usługi, których można użyć do znalezienia okienka lub CPaneFrameWnd okna. Zazwyczaj te usługi nie są wywoływane bezpośrednio, ponieważ są one opakowane w głównym obiekcie okna ramowego. Aby uzyskać więcej informacji, zobacz Klasa CPaneFrameWnd.

Porady dotyczące dostosowywania

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

  • Klasa CDockingManager obsługuje następujące tryby dokowania:

    • AFX_DOCK_TYPE::DT_IMMEDIATE

    • AFX_DOCK_TYPE::DT_STANDARD

    • AFX_DOCK_TYPE::DT_SMART

    Te tryby dokowania są definiowane przez CDockingManager::m_dockModeGlobal i są ustawiane przez wywołanie CDockingManager::SetDockingMode.

  • Jeśli chcesz utworzyć okienko inne niż przestawne, niezwiązane z możliwością zmiany rozmiaru, wywołaj metodę CDockingManager::AddPane . Ta metoda rejestruje okienko za pomocą menedżera dokowania, który jest odpowiedzialny za układ okienka.

Przykład

W poniższym przykładzie pokazano, jak używać różnych metod w CDockingManager klasie do konfigurowania CDockingManager obiektu. W przykładzie pokazano, jak wyświetlić dodatkowy przycisk, który otwiera wyskakujące menu w podpisach wszystkich okienek dokowania i jak ustawić tryb dokowania obiektu. Ten fragment kodu jest częścią przykładu pokazowego programu Visual Studio.

CDockingManager *pDockManager = GetDockingManager();
ASSERT_VALID(pDockManager);
pDockManager->AdjustPaneFrames();
pDockManager->EnableDockSiteMenu();
pDockManager->SetDockingMode(DT_STANDARD);

Hierarchia dziedziczenia

Obiekt CObject

CDockingManager

Wymagania

Nagłówek: afxDockingManager.h

CDockingManager::AddDockSite

Tworzy okienko docku i dodaje je do listy pasków sterowania.

BOOL AddDockSite(
    const AFX_DOCKSITE_INFO& info,
    CDockSite** ppDockBar = NULL);

Parametry

Informacji
[in] Odwołanie do struktury informacji zawierającej wyrównanie okienka dokowania.

ppDockBar
[out] Wskaźnik do wskaźnika do nowego okienka dokowania.

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko docku zostało pomyślnie utworzone; FAŁSZ w przeciwnym razie.

CDockingManager::AddHiddenMDITabbedBar

Dodaje uchwyt do okienka paska do listy ukrytych okienek paska z kartami MDI.

void AddHiddenMDITabbedBar(CDockablePane* pBar);

Parametry

Pasek p
[in] Wskaźnik do okienka słupka

CDockingManager::AddPane

Rejestruje okienko za pomocą menedżera dokowania.

BOOL AddPane(
    CBasePane* pWnd,
    BOOL bTail = TRUE,
    BOOL bAutoHide = FALSE,
    BOOL bInsertForOuterEdge = FALSE);

Parametry

pWnd
[in, out] Określa okienko, które ma zostać dodane do menedżera dokowania.

bTail
[in] WARTOŚĆ TRUE, aby dodać okienko na końcu listy okienek dla menedżera dokowania; w przeciwnym razie, FAŁSZ.

bAutoHide
[in] Tylko do użytku wewnętrznego. Zawsze używaj wartości domyślnej FALSE.

bInsertForOuterEdge
[in] Tylko do użytku wewnętrznego. Zawsze używaj wartości domyślnej FALSE.

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko zostało pomyślnie zarejestrowane w menedżerze dokowania; w przeciwnym razie, FAŁSZ.

Uwagi

Wywołaj tę metodę, aby zarejestrować nieprzenośne, niezwiązane okienka z menedżerem dokowania. Jeśli nie zarejestrujesz okienek, nie będą one wyświetlane poprawnie, gdy menedżer dokowania zostanie ułożony.

CDockingManager::AdjustDockingLayout

Oblicza ponownie i dostosowuje układ wszystkich okienek w oknie ramowym.

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

Parametry

hdwp
[in] Określa strukturę odroczonego położenia okna. Aby uzyskać więcej informacji, zobacz Typy danych systemu Windows.

Uwagi

CDockingManager::AddMiniFrame

Dodaje ramkę do listy mini ramek.

virtual BOOL AddMiniFrame(CPaneFrameWnd* pWnd);

Parametry

pWnd
[in] Wskaźnik do ramki.

Wartość zwracana

WARTOŚĆ TRUE, jeśli ramka nie znajduje się na liście mini ramek i została pomyślnie dodana; FAŁSZ w przeciwnym razie.

CDockingManager::AdjustPaneFrames

Powoduje wysłanie komunikatu WM_NCCALCSIZE do wszystkich okien i CPaneFrameWnd okien.

virtual void AdjustPaneFrames();

Uwagi

CDockingManager::AdjustRectToClientArea

Dostosowuje wyrównanie prostokąta.

virtual BOOL AdjustRectToClientArea(
    CRect& rectResult,
    DWORD dwAlignment);

Parametry

rectResult
[in] Odwołanie do CRect obiektu

dwAlignment
[in] Wyrównanie CRect obiektu

Wartość zwracana

WARTOŚĆ TRUE, jeśli wyrównanie CRect obiektu zostało dostosowane; FAŁSZ w przeciwnym razie.

Uwagi

Parametr dwAlignment może mieć jedną z następujących wartości:

  • CBRS_ALIGN_TOP

  • CBRS_ALIGN_BOTTOM

  • CBRS_ALIGN_LEFT

  • CBRS_ALIGN_RIGHT

CDockingManager::AlignAutoHidePane

Zmienia rozmiar okienka dokowania w trybie automatycznego ukrywania, dzięki czemu zajmuje pełną szerokość lub wysokość obszaru klienta ramki otoczonej lokacjami dokowania.

void AlignAutoHidePane(
    CPaneDivider* pDefaultSlider,
    BOOL bIsVisible = TRUE);

Parametry

pDefaultSlider
[in] Okienko suwaka dokowania.

bIsVisible
[in] WARTOŚĆ TRUE, jeśli okienko dokowania jest widoczne; FAŁSZ w przeciwnym razie.

CDockingManager::AutoHidePane

Tworzy automatycznie ukrywany pasek narzędzi.

CMFCAutoHideToolBar* AutoHidePane(
    CDockablePane* pBar,
    CMFCAutoHideToolBar* pCurrAutoHideToolBar = NULL);

Parametry

Pasek p
[in] Wskaźnik do okienka słupka.

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

Wartość zwracana

Wartość NULL, jeśli pasek narzędzi automatycznego ukrywania nie został utworzony; w przeciwnym razie wskaźnik do nowego paska narzędzi.

CDockingManager::BringBarsToTop

Przenosi zadokowane słupki, które mają określone wyrównanie do góry.

void BringBarsToTop(
    DWORD dwAlignment = 0,
    BOOL bExcludeDockedBars = TRUE);

Parametry

dwAlignment
[in] Wyrównanie pasków dokowych, które są przywiezione do góry innych okien.

bExcludeDockedBars
[in] WARTOŚĆ TRUE, aby wykluczyć zadokowane słupki z bycia na górze; w przeciwnym razie FAŁSZ.

CDockingManager::BuildPanesMenu

Dodaje nazwy okienek dokowania i pasków narzędzi do menu.

void BuildPanesMenu(
    CMenu& menu,
    BOOL bToolbarsOnly);

Parametry

menu
[in] Menu umożliwiające dodanie nazw okienek dokowania i pasków narzędzi.

bToolbarsOnly
[in] WARTOŚĆ TRUE, aby dodać tylko nazwy pasków narzędzi do menu; FAŁSZ w przeciwnym razie.

CDockingManager::CalcExpectedDockedRect

Oblicza oczekiwany prostokąt zadokowanego okna.

void CalcExpectedDockedRect(
    CWnd* pWnd,
    CPoint ptMouse,
    CRect& rectResult,
    BOOL& bDrawTab,
    CDockablePane** ppTargetBar);

Parametry

pWnd
[in] Wskaźnik do zadokowania okna.

ptMouse
[in] Lokalizacja myszy.

rectResult
[out] Prostokąt obliczeniowy.

bDrawTab
[in] PRAWDA, aby narysować kartę; w przeciwnym razie FAŁSZ.

ppTargetBar
[out] Wskaźnik do wskaźnika do okienka docelowego.

Uwagi

Ta metoda oblicza prostokąt zajmowany przez okno, jeśli użytkownik przeciągnął okno do punktu określonego przez ptMouse i zadokował go tam.

CDockingManager::Create

Tworzy menedżera dokowania.

BOOL Create(CFrameWnd* pParentWnd);

Parametry

pParentWnd
[in] Wskaźnik do ramki nadrzędnej menedżera dokowania. Ta wartość nie może mieć wartości NULL.

Wartość zwracana

Prawda zawsze.

CDockingManager::D eterminePaneAndStatus

Określa okienko zawierające dany punkt i jego stan dokowania.

virtual AFX_CS_STATUS DeterminePaneAndStatus(
    CPoint pt,
    int nSensitivity,
    DWORD dwEnabledAlignment,
    CBasePane** ppTargetBar,
    const CBasePane* pBarToIgnore,
    const CBasePane* pBarToDock);

Parametry

Pt
[in] Lokalizacja okienka do sprawdzenia.

nSensitivity
[in] Wartość zwiększająca prostokąt okna każdego zaznaczonego okienka. Okienko spełnia kryteria wyszukiwania, jeśli dany punkt znajduje się w tym zwiększonym regionie.

dwEnabledAlignment
[in] Wyrównanie okienka dokowania.

ppTargetBar
[out] Wskaźnik do wskaźnika do okienka docelowego.

pBarToIgnore
[in] Okienko ignorowane przez metodę.

pBarToDock
[in] Okienko, które jest zadokowane.

Wartość zwracana

Stan dokowania.

Uwagi

Stan dokowania może być jedną z następujących wartości:

AFX_CS_STATUS wartość Znaczenie
CS_NOTHING Wskaźnik nie znajduje się w miejscu docku. W związku z tym zachowaj przestawne okienko.
CS_DOCK_IMMEDIATELY Wskaźnik znajduje się w miejscu dokowania w trybie bezpośrednim (DT_IMMEDIATE stylu jest włączony), więc okienko musi być zadokowane natychmiast.
CS_DELAY_DOCK Wskaźnik znajduje się w miejscu dokowania, który jest innym okienkiem dokowania lub jest krawędzią ramki głównej.
CS_DELAY_DOCK_TO_TAB Wskaźnik znajduje się w lokacji dokowania, która powoduje, że okienko jest zadokowane w oknie z kartami. Dzieje się tak, gdy mysz znajduje się nad podpisem innego okienka dokowania lub w obszarze tabulacji okienka z kartami.

CDockingManager::D isableRestoreDockState

Włącza lub wyłącza ładowanie układu dokowania z rejestru.

void DisableRestoreDockState(BOOL bDisable = TRUE);

Parametry

bDisable
[in] WARTOŚĆ TRUE, aby wyłączyć ładowanie układu dokowania z rejestru; w przeciwnym razie, FAŁSZ.

Uwagi

Wywołaj tę metodę, gdy musisz zachować bieżący układ okienek dokowania i pasków narzędzi podczas ładowania stanu aplikacji.

CDockingManager::D ockPane

Zadokuje okienko do innego okienka lub okna ramowego.

void DockPane(
    CBasePane* pBar,
    UINT nDockBarID = 0,
    LPCRECT lpRect = NULL);

Parametry

Pasek p
[in] Wskaźnik do okienka słupka w celu zadokowania do.

nDockBarID
[in] Identyfikator paska do zadokowania.

lpRect
[in] Prostokąt docelowy.

CDockingManager::D ockPaneLeftOf

Zadokuje okienko po lewej stronie innego okienka.

BOOL DockPaneLeftOf(
    CPane* pBarToDock,
    CPane* pTargetBar);

Parametry

pBarToDock
[in] Wskaźnik do okienka, który ma zostać zadokowany po lewej stronie paska pTargetBar.

pTargetBar
[in] Wskaźnik do okienka docelowego.

Wartość zwracana

Wartość TRUE, jeśli okienko zostało pomyślnie zadokowane; w przeciwnym razie, FAŁSZ.

CDockingManager::EnableAutoHidePanes

Umożliwia zadokowanie okienka do ramki głównej, tworzy okienko dokowania i dodaje je do listy pasków sterowania.

BOOL EnableAutoHidePanes(DWORD dwStyle);

Parametry

dwStyle
[in] Wyrównanie dokowania.

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko docku zostało pomyślnie utworzone; FAŁSZ w przeciwnym razie.

CDockingManager::EnableDocking

Tworzy okienko docku i umożliwia dokowanie okienka do ramki głównej.

BOOL EnableDocking(DWORD dwStyle);

Parametry

dwStyle
[in] Wyrównanie dokowania.

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko docku zostało pomyślnie utworzone; FAŁSZ w przeciwnym razie.

CDockingManager::EnableDockSiteMenu

Wyświetla dodatkowy przycisk, który otwiera wyskakujące menu w podpisach wszystkich okienek dokowania.

static void EnableDockSiteMenu(BOOL bEnable = TRUE);

Parametry

bEnable
[in] Wartość TRUE w celu włączenia menu witryny docku; w przeciwnym razie, FAŁSZ.

Uwagi

W menu witryny dock są wyświetlane następujące opcje zmiany stanu dokowania okienka:

  • Floating — Unosi okienko

  • Docking - Zadokuje okienko w głównej ramce w lokalizacji, w której okienko zostało ostatnio zadokowane

  • AutoHide - Przełącza okienko w tryb autohide

  • Hide - Ukrywa okienko

Domyślnie to menu nie jest wyświetlane.

CDockingManager::EnablePaneContextMenu

Informuje bibliotekę o wyświetlaniu specjalnego menu kontekstowego z listą pasków narzędzi aplikacji i okienkami dokowania, gdy użytkownik kliknie prawym przyciskiem myszy, a biblioteka przetwarza komunikat WM_CONTEXTMENU.

void EnablePaneContextMenu(
    BOOL bEnable,
    UINT uiCustomizeCmd,
    const CString& strCustomizeText,
    BOOL bToolbarsOnly = FALSE);

Parametry

bEnable
[in] Jeśli wartość TRUE, biblioteka włącza obsługę automatycznego menu kontekstowego; jeśli wartość FALSE biblioteki wyłączy obsługę automatycznego menu kontekstowego.

uiCustomizeCmd
[in] Identyfikator polecenia dla elementu Dostosuj w menu.

strCustomizeText
[in] Tekst elementu Dostosuj .

bToolbarsOnly
[in] Jeśli wartość TRUE, w menu jest wyświetlana tylko lista pasków narzędzi aplikacji; Jeśli wartość FALSE, biblioteka dodaje okienka dockowania aplikacji do tej listy.

CDockingManager::FindDockSite

Pobiera okienko paska, które znajduje się na określonej pozycji i ma określone wyrównanie.

virtual CDockSite* FindDockSite(
    DWORD dwAlignment,
    BOOL bOuter);

Parametry

dwAlignment
[in] Wyrównanie okienka słupka.

bOuter
[in] Jeśli wartość TRUE, pobierz pasek na pozycji głowy na liście pasków sterowania. W przeciwnym razie pobierz pasek na pozycji ogona na liście pasków sterowania.

Wartość zwracana

Okienko dokowania, które ma określone wyrównanie; W przeciwnym razie wartość NULL.

CDockingManager::FindPaneByID

Znajduje okienko według określonego identyfikatora kontrolki.

virtual CBasePane* FindPaneByID(
    UINT uBarID,
    BOOL bSearchMiniFrames = FALSE);

Parametry

uBarID
[in] Określa identyfikator kontrolki okienka do znalezienia.

bSearchMiniFrames
[in] Wartość TRUE, aby uwzględnić wszystkie okienka przestawne w wyszukiwaniu. FAŁSZ do uwzględnienia tylko zadokowanych okienek.

Wartość zwracana

Obiekt CBasePane , który ma określony identyfikator kontrolki lub wartość NULL, jeśli nie można odnaleźć określonego okienka.

Uwagi

CDockingManager::FindDockSiteByPane

Zwraca okienko paska, które ma identyfikator okienka paska docelowego.

virtual CDockSite* FindDockSiteByPane(CPane* pTargetBar);

Parametry

pTargetBar
[in] Wskaźnik do okienka paska docelowego.

Wartość zwracana

Okienko paska z identyfikatorem okienka paska docelowego; Wartość NULL, jeśli takie okienko paska nie istnieje.

CDockingManager::FixupVirtualRects

Zatwierdza wszystkie bieżące pozycje paska narzędzi w wirtualnych prostokątach.

virtual void FixupVirtualRects();

Uwagi

Gdy użytkownik zacznie przeciągać pasek narzędzi, aplikacja zapamiętuje jego oryginalną pozycję w wirtualnym prostokątze. Gdy użytkownik przenosi pasek narzędzi w całej witrynie docka, pasek narzędzi może przesuwać inne paski narzędzi. Oryginalne pozycje innych pasków narzędzi są przechowywane w odpowiednich prostokątach wirtualnych.

CDockingManager::FrameFromPoint

Zwraca ramkę zawierającą dany punkt.

virtual CPaneFrameWnd* FrameFromPoint(
    CPoint pt,
    CPaneFrameWnd* pFrameToExclude,
    BOOL bFloatMultiOnly) const;

Parametry

Pt
[in] Określa punkt we współrzędnych ekranu, aby sprawdzić.

pFrameToExclude
[in] Wskaźnik do ramki do wykluczenia.

bFloatMultiOnly
[in] WARTOŚĆ TRUE do wykluczenia ramek, które nie są wystąpieniami CMultiPaneFrameWnd; FAŁSZ w przeciwnym razie.

Wartość zwracana

Ramka zawierająca dany punkt; W przeciwnym razie wartość NULL.

CDockingManager::GetClientAreaBounds

Pobiera prostokąt zawierający granice obszaru klienta.

CRect GetClientAreaBounds() const;

void GetClientAreaBounds(CRect& rcClient);

Parametry

rcClient
[out] Odwołanie do prostokąta zawierającego granice obszaru klienta.

Wartość zwracana

Prostokąt zawierający granice obszaru klienta.

CDockingManager::GetDockingMode

Zwraca bieżący tryb dokowania.

static AFX_DOCK_TYPE GetDockingMode();

Wartość zwracana

Wartość modułu wyliczającego reprezentująca bieżący tryb dokowania. Może to być jedna z następujących wartości:

  • DT_STANDARD

  • DT_IMMEDIATE

  • DT_SMART

Uwagi

Aby ustawić tryb dockowania, wywołaj metodę CDockingManager::SetDockingMode.

CDockingManager::GetDockSiteFrameWnd

Pobiera wskaźnik do ramki okna nadrzędnego.

CFrameWnd* GetDockSiteFrameWnd() const;

Wartość zwracana

Wskaźnik do ramki okna nadrzędnego.

CDockingManager::GetEnabledAutoHideAlignment

Zwraca włączone wyrównanie okienek.

DWORD GetEnabledAutoHideAlignment() const;

Wartość zwracana

Bitowa kombinacja flag CBRS_ALIGN_ lub 0, jeśli okienka autohide nie są włączone. Aby uzyskać więcej informacji, zobacz CFrameWnd::EnableDocking.

Uwagi

Metoda zwraca włączone wyrównanie dla automatycznych pasków kontrolek. Aby włączyć automatyczne ukrywanie pasków, wywołaj metodę CFrameWndEx::EnableAutoHidePanes.

CDockingManager::GetMiniFrames

Pobiera listę miniframe.

const CObList& GetMiniFrames() const;

Wartość zwracana

Lista miniframe, które zawierają paski sterujące należące do menedżera dokowania.

CDockingManager::GetOuterEdgeBounds

Pobiera prostokąt zawierający zewnętrzne krawędzie ramki.

CRect GetOuterEdgeBounds() const;

Wartość zwracana

Prostokąt zawierający zewnętrzne krawędzie ramki.

CDockingManager::GetPaneList

Zwraca listę okienek należących do menedżera dokowania. Obejmuje to wszystkie przestawne okienka.

void GetPaneList(
    CObList& lstBars,
    BOOL bIncludeAutohide = FALSE,
    CRuntimeClass* pRTCFilter = NULL,
    BOOL bIncludeTabs = FALSE);

Parametry

lstBars
[in, out] Zawiera wszystkie okienka bieżącego menedżera dokowania.

bIncludeAutohide
[in] WARTOŚĆ TRUE, aby uwzględnić okienka, które są w trybie automatycznego ukrywania; w przeciwnym razie, FAŁSZ.

pRTCFilter
[in] Jeśli nie ma wartości NULL, zwracana lista zawiera okienka tylko określonej klasy środowiska uruchomieniowego.

bIncludeTabs
[in] WARTOŚĆ TRUE do uwzględnienia kart; w przeciwnym razie, FAŁSZ.

Uwagi

Jeśli w menedżerze dokowania istnieją jakiekolwiek okienka z kartami, metoda zwraca wskaźniki do obiektów klasy CBaseTabbedPane i należy jawnie wyliczyć karty.

Użyj narzędzia pRTCFilter , aby uzyskać określoną klasę okienek. Na przykład można uzyskać tylko paski narzędzi, ustawiając tę wartość odpowiednio.

CDockingManager::GetSmartDockingManager

Pobiera wskaźnik do menedżera inteligentnego dokowania.

CSmartDockingManager* GetSmartDockingManager();

Wartość zwracana

Wskaźnik do inteligentnego menedżera dokowania.

CDockingManager::GetSmartDockingManagerPermanent

Pobiera wskaźnik do menedżera inteligentnego dokowania.

CSmartDockingManager* GetSmartDockingManagerPermanent() const;

Wartość zwracana

Wskaźnik do inteligentnego menedżera dokowania.

CDockingManager::GetSmartDockingParams

Zwraca parametry inteligentnego dokowania dla menedżera dokowania.

static CSmartDockingInfo& GetSmartDockingParams();

Wartość zwracana

Klasa zawierająca parametry inteligentnego dokowania dla bieżącego menedżera dokowania. Aby uzyskać więcej informacji, zobacz Klasa CSmartDockingInfo.

Uwagi

CDockingManager::HideAutoHidePanes

Ukrywa okienko w trybie automatycznego ukrywania.

void HideAutoHidePanes(
    CDockablePane* pBarToExclude = NULL,
    BOOL bImmediately = FALSE);

Parametry

pBarToExclude
[in] Wskaźnik do paska do wykluczenia z ukrycia.

bImmediately
[in] PRAWDA, aby natychmiast ukryć okienko; FAŁSZ, aby ukryć okienko za pomocą efektu automatycznego ukrycia.

CDockingManager::InsertDockSite

Tworzy okienko docku i wstawia je do listy pasków sterowania.

BOOL InsertDockSite(
    const AFX_DOCKSITE_INFO& info,
    DWORD dwAlignToInsertAfter,
    CDockSite** ppDockBar = NULL);

Parametry

Informacji
[in] Struktura zawierająca informacje o wyrównaniu okienka dokowania.

dwAlignToInsertAfter
[in] Wyrównanie okienka dokowania.

ppDockBar
[out] Wskaźnik do okienka dokowania.

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko docku zostało pomyślnie utworzone; FAŁSZ w przeciwnym razie.

CDockingManager::InsertPane

Wstawia okienko kontrolki do listy pasków kontrolek.

BOOL InsertPane(
    CBasePane* pControlBar,
    CBasePane* pTarget,
    BOOL bAfter = TRUE);

Parametry

pControlBar
[in] Wskaźnik do okienka sterowania.

pTarget
[in] Wskaźnik do okienka docelowego.

bAfter
[in] WARTOŚĆ TRUE, aby wstawić okienko po pozycji okienka docelowego; FAŁSZ w przeciwnym razie.

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko sterowania zostało pomyślnie dodane do listy pasków sterowania; FAŁSZ w przeciwnym razie.

Uwagi

Ta metoda zwraca wartość false, jeśli okienko sterowania znajduje się już na liście pasków kontrolek lub jeśli okienko docelowe nie istnieje na liście pasków kontrolek.

CDockingManager::IsDockSiteMenu

Określa, czy menu podręczne jest wyświetlane w podpisach wszystkich okienek.

static BOOL IsDockSiteMenu();

Wartość zwracana

WARTOŚĆ TRUE, jeśli menu witryny docku jest wyświetlane na podpisach wszystkich okienek dockowania; w przeciwnym razie FAŁSZ.

Uwagi

Menu witryny docku można włączyć, wywołując polecenie CDockingManager::EnableDockSiteMenu.

CDockingManager::IsInAdjustLayout

Określa, czy układy wszystkich okienek są dostosowywane.

BOOL IsInAdjustLayout() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli układy wszystkich okienek są dostosowywane; FAŁSZ w przeciwnym razie.

CDockingManager::IsOLEContainerMode

Określa, czy menedżer dokowania jest w trybie kontenera OLE.

BOOL IsOLEContainerMode() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli menedżer dokowania jest w trybie kontenera OLE; w przeciwnym razie, FAŁSZ.

Uwagi

W trybie kontenera OLE wszystkie okienka dokowania i paski narzędzi aplikacji są ukryte. Okienka są również ukryte w tym trybie, jeśli ustawiono wartość CDockingManager::m_bHideDockingBarsInContainerMode wartość TRUE.

CDockingManager::IsPointNearDockSite

Określa, czy określony punkt znajduje się w pobliżu lokacji docku.

BOOL IsPointNearDockSite(
    CPoint point,
    DWORD& dwBarAlignment,
    BOOL& bOuterEdge) const;

Parametry

punkt
[in] Określony punkt.

dwBarAlignment
[out] Określa krawędź, w której znajduje się punkt. Możliwe wartości to CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP i CBRS_ALIGN_BOTTOM.

bOuterEdge
[out] WARTOŚĆ TRUE, jeśli punkt znajduje się w pobliżu zewnętrznej granicy miejsca docka; FAŁSZ w przeciwnym razie.

Wartość zwracana

WARTOŚĆ TRUE, jeśli punkt znajduje się w pobliżu miejsca dokowania; w przeciwnym razie FAŁSZ.

CDockingManager::IsPrintPreviewValid

Określa, czy jest ustawiony tryb podglądu wydruku.

BOOL IsPrintPreviewValid() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli jest ustawiony tryb podglądu wydruku; FAŁSZ w przeciwnym razie.

CDockingManager::LoadState

Ładuje stan menedżera dokowania z rejestru.

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

Parametry

lpszProfileName
[in] Nazwa profilu.

identyfikator uiID
[in] Identyfikator menedżera dokowania.

Wartość zwracana

WARTOŚĆ TRUE, jeśli stan menedżera dokowania został pomyślnie załadowany; w przeciwnym razie FAŁSZ.

CDockingManager::LockUpdate

Blokuje podane okno.

void LockUpdate(BOOL bLock);

Parametry

blok
[in] WARTOŚĆ TRUE, jeśli okno jest zablokowane; FAŁSZ w przeciwnym razie.

Uwagi

Gdy okno jest zablokowane, nie można go przenieść i nie można go ponownie wyrysować.

CDockingManager::m_bHideDockingBarsInContainerMode

Określa, czy menedżer dokowania ukrywa okienka w trybie kontenera OLE.

AFX_IMPORT_DATA static BOOL m_bHideDockingBarsInContainerMode;

Uwagi

Ustaw tę wartość na FALSE, jeśli chcesz zachować wszystkie okienka zadokowane do głównej ramki widocznej, gdy aplikacja jest w trybie kontenera OLE. Domyślnie ta wartość ma wartość TRUE.

CDockingManager::m_dockModeGlobal

Określa globalny tryb dokowania.

AFX_IMPORT_DATA static AFX_DOCK_TYPE m_dockModeGlobal;

Uwagi

Domyślnie każde okienko dokowania używa tego trybu dokowania. Aby uzyskać więcej informacji o wartościach, na które można ustawić to pole, zobacz CBasePane::GetDockingMode.

CDockingManager::m_nDockSensitivity

Określa czułość dokowania.

AFX_IMPORT_DATA static int m_nDockSensitivity;

Uwagi

Ważność dokowania określa, jak blisko okienka przestawnego może zbliżyć się do okienka dokowania, dokowania lokacji lub innego okienka, zanim struktura zmieni jego stan na zadokowany.

CDockingManager::m_nTimeOutBeforeDockingBarDock

Określa czas w milisekundach, zanim okienko dockowania zostanie zadokowane w trybie natychmiastowego dokowania.

static UINT m_nTimeOutBeforeDockingBarDock;

Uwagi

Przed zadokowaniu okienka platforma czeka określony czas. Zapobiega to przypadkowemu zadokowaniu okienka do lokalizacji, gdy użytkownik nadal go przeciąga.

CDockingManager::m_nTimeOutBeforeToolBarDock

Określa czas w milisekundach, zanim pasek narzędzi zostanie zadokowany do głównego okna ramki.

static UINT m_nTimeOutBeforeToolBarDock;

Uwagi

Zanim pasek narzędzi zostanie zadokowany, struktura czeka na określony czas. Zapobiega to przypadkowemu zadokowaniu paska narzędzi do lokalizacji, gdy użytkownik nadal go przeciąga.

CDockingManager::OnActivateFrame

Wywoływana przez platformę, gdy okno ramki jest aktywne lub dezaktywowane.

virtual void OnActivateFrame(BOOL bActivate);

Parametry

bActivate
[in] Jeśli wartość TRUE, okno ramki jest aktywne; jeśli fałsz, okno ramki jest dezaktywowane.

CDockingManager::OnClosePopupMenu

Wywoływana przez platformę, gdy aktywne menu podręczne przetwarza komunikat WM_DESTROY.

void OnClosePopupMenu();

Uwagi

Platforma wysyła komunikat WM_DESTROY, gdy ma zamknąć bieżące okno główne. Zastąpi tę metodę do obsługi powiadomień z CMFCPopupMenu obiektów należących do okna ramki, gdy CMFCPopupMenu obiekt przetwarza komunikat WM_DESTROY.

CDockingManager::OnMoveMiniFrame

Wywoływana przez platformę w celu przeniesienia okna mini-ramka.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parametry

Ramka pFrame
[in] Wskaźnik do mini-ramy okna.

Wartość zwracana

Wartość TRUE, jeśli metoda powiedzie się; w przeciwnym razie FAŁSZ.

CDockingManager::OnPaneContextMenu

Wywoływana przez platformę podczas kompilowania menu zawierającego listę okienek.

void OnPaneContextMenu(CPoint point);

Parametry

punkt
[in] Określa lokalizację menu.

CDockingManager::P aneFromPoint

Zwraca okienko zawierające dany punkt.

virtual CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    bool bExactBar = false,
    CRuntimeClass* pRTCBarType = NULL,
    BOOL bCheckVisibility = FALSE,
    const CBasePane* pBarToIgnore = NULL) const;

virtual CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    DWORD& dwAlignment,
    CRuntimeClass* pRTCBarType = NULL,
    const CBasePane* pBarToIgnore = NULL) const;

Parametry

punkt
[in] Określa punkt we współrzędnych ekranu, aby sprawdzić.

nSensitivity
[in] Wartość do zawyżania prostokąta okna każdego zaznaczonego okienka. Okienko spełnia kryteria wyszukiwania, jeśli dany punkt znajduje się w tym zawyżonym regionie.

bExactBar
[in] Wartość TRUE, aby zignorować parametr nSensitivity ; w przeciwnym razie wartość FALSE.

pRTCBarType
[in] Jeśli nie ma wartości NULL, metoda wyszukuje tylko okienka określonego typu.

bCheckVisibility
[in] WARTOŚĆ TRUE do sprawdzania tylko widocznych okienek; w przeciwnym razie, FAŁSZ.

dwAlignment
[out] Jeśli okienko zostanie znalezione w określonym punkcie, ten parametr zawiera stronę okienka znajdującego się najbliżej określonego punktu. Aby uzyskać więcej informacji, zobacz sekcję: Uwagi.

pBarToIgnore
[in] Jeśli nie ma wartości NULL, metoda ignoruje okienka określone przez ten parametr.

Wartość zwracana

Obiekt pochodny CBasePane zawierający dany punkt lub wartość NULL, jeśli nie znaleziono okienka.

Uwagi

Po znalezieniu funkcji i znalezieniu okienka dwAlignment zawiera wyrównanie określonego punktu. Jeśli na przykład punkt znajdował się najbliżej górnej części okienka, wartość dwAlignment jest ustawiona na wartość CBRS_ALIGN_TOP.

CDockingManager::P rocessPaneContextMenuCommand

Wywoływana przez platformę do zaznaczenia lub wyczyszczenia pola wyboru dla określonego polecenia i ponowne obliczenie układu wyświetlanego okienka.

BOOL ProcessPaneContextMenuCommand(
    UINT nID,
    int nCode,
    void* pExtra,
    AFX_CMDHANDLERINFO* pHandlerInfo);

Parametry

Nid
[in] Identyfikator paska sterowania w menu.

nCode
[in] Kod powiadomienia polecenia.

pExtra
[in] Wskaźnik do pustki, który jest rzutowany na wskaźnik do CCmdUI , jeśli nCode jest CN_UPDATE_COMMAND_UI.

pHandlerInfo
[in] Wskaźnik do struktury informacji. Ten parametr nie jest używany.

Wartość zwracana

Wartość TRUE, jeśli parametr pEXtra nie ma wartości NULL, a kod nCode równa się CN_UPDATE_COMMAND_UI lub jeśli istnieje pasek sterowania z określonym identyfikatorem nID.

CDockingManager::RecalcLayout

Oblicza ponownie wewnętrzny układ kontrolek znajdujących się na liście kontrolek.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parametry

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

CDockingManager::ReleaseEmptyPaneContainers

Zwalnia puste kontenery okienka.

void ReleaseEmptyPaneContainers();

CDockingManager::RemoveHiddenMDITabbedBar

Usuwa określone ukryte okienko paska.

void RemoveHiddenMDITabbedBar(CDockablePane* pBar);

Parametry

Pasek p
[in] Wskaźnik do okienka słupka do usunięcia.

CDockingManager::RemoveMiniFrame

Usuwa określoną ramkę z listy mini ramek.

virtual BOOL RemoveMiniFrame(CPaneFrameWnd* pWnd);

Parametry

pWnd
[in] Wskaźnik do ramki do usunięcia.

Wartość zwracana

WARTOŚĆ TRUE, jeśli określona ramka zostanie usunięta; FAŁSZ w przeciwnym razie.

CDockingManager::RemovePaneFromDockManager

Wyrejestrowuje okienko i usuwa je z listy w menedżerze dokowania.

void RemovePaneFromDockManager(
    CBasePane* pWnd,
    BOOL bDestroy,
    BOOL bAdjustLayout,
    BOOL bAutoHide = FALSE,
    CBasePane* pBarReplacement = NULL);

Parametry

pWnd
[in] Wskaźnik do okienka do usunięcia.

bDestroy
[in] Jeśli wartość TRUE, usunięte okienko zostanie zniszczone.

bAdjustLayout
[in] Jeśli wartość TRUE, dostosuj układ dokowania natychmiast.

bAutoHide
[in] Jeśli wartość TRUE, okienko zostanie usunięte z listy pasków automatycznego ukrywania. Jeśli wartość FALSE, okienko zostanie usunięte z listy zwykłych okienek.

pBarReplacement
[in] Wskaźnik do okienka, który zastępuje usunięte okienko.

CDockingManager::ReplacePane

Zamienia jedno okienko na inne.

BOOL ReplacePane(
    CDockablePane* pOriginalBar,
    CDockablePane* pNewBar);

Parametry

pOriginalBar
[in] Wskaźnik do oryginalnego okienka.

pNewBar
[in] Wskaźnik do okienka, który zastępuje oryginalne okienko.

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko zostało pomyślnie zastąpione; FAŁSZ w przeciwnym razie.

CDockingManager::ResortMiniFramesForZOrder

Ucieka ramek na liście mini ramek.

void ResortMiniFramesForZOrder();

CDockingManager::SaveState

Zapisuje stan menedżera dokowania do rejestru.

virtual BOOL SaveState(
    LPCTSTR lpszProfileName = NULL,
    UINT uiID = (UINT) -1);

Parametry

lpszProfileName
[in] Ścieżka do klucza rejestru.

identyfikator uiID
[in] Identyfikator menedżera dokowania.

Wartość zwracana

Wartość TRUE, jeśli stan został zapisany pomyślnie; w przeciwnym razie FAŁSZ.

Uwagi

Zapisanie stanu menedżera dokowania do rejestru obejmuje zapisanie stanów pasków kontrolnych, stanów pasków automatycznego ukrycia i stanów mini ramek znajdujących się w menedżerze dokowania.

CDockingManager::SendMessageToMiniFrames

Wysyła określony komunikat do wszystkich mini ramek.

BOOL SendMessageToMiniFrames(
    UINT uMessage,
    WPARAM wParam = 0,
    LPARAM lParam = 0);

Parametry

uMessage
[in] Wiadomość do wysłania.

wParam
[in] Dodatkowe informacje zależne od komunikatu.

lParam
[in] Dodatkowe informacje zależne od komunikatu.

Wartość zwracana

Prawda zawsze.

CDockingManager::Serialize

Zapisuje menedżera dokowania do archiwum.

void Serialize(CArchive& ar);

Parametry

Ar
[in] Odwołanie do obiektu archiwum.

Uwagi

Napisanie menedżera dokowania do archiwum obejmuje określenie liczby zadokowanych pasków sterujących i suwaków, a także zapisanie pasków sterujących, mini ramek, pasków automatycznych i pasków kart MDI do archiwum.

CDockingManager::SetAutohideZOrder

Ustawia rozmiar, szerokość i wysokość pasków sterujących oraz określone okienko.

void SetAutohideZOrder(CDockablePane* pAHDockingBar);

Parametry

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

CDockingManager::SetDockingMode

Ustawia tryb dokowania.

static void SetDockingMode(
    AFX_DOCK_TYPE dockMode,
    AFX_SMARTDOCK_THEME theme = AFX_SDT_DEFAULT);

Parametry

dockMode
Określa nowy tryb dokowania. Aby uzyskać więcej informacji, zobacz sekcję: Uwagi.

kompozycja
Określa motyw, który ma być używany na potrzeby inteligentnych znaczników dokowania. Może to być jedna z następujących wyliczonych wartości: AFX_SDT_DEFAULT, AFX_SDT_VS2005, AFX_SDT_VS2008.

Uwagi

Wywołaj tę metodę statyczną, aby ustawić tryb dokowania.

dockMode może być jedną z następujących wartości:

  • DT_STANDARD — standardowy tryb dokowania wdrożony w programie Visual Studio .NET 2003. Okienka są przeciągane bez przeciągania kontekstu.

  • DT_IMMEDIATE — tryb natychmiastowego dokowania zgodnie z implementacją w programie Microsoft Visio. Okienka są przeciągane z kontekstem przeciągania, ale nie są wyświetlane żadne znaczniki.

  • DT_SMART — tryb inteligentnego dokowania zaimplementowany w programie Visual Studio 2005. Okienka są przeciągane z kontekstem przeciągania, a znaczniki inteligentne pokazują, gdzie można zadokować okienko.

CDockingManager::SetDockState

Ustawia stan dokowania pasków sterujących, mini ramek i pasków autohide.

virtual void SetDockState();

CDockingManager::SetPrintPreviewMode

Ustawia tryb podglądu wydruku pasków wyświetlanych w podglądzie wydruku.

void SetPrintPreviewMode(
    BOOL bPreview,
    CPrintPreviewState* pState);

Parametry

bPreview
[in] Wartość TRUE, jeśli jest ustawiony tryb podglądu wydruku; FAŁSZ w przeciwnym razie.

pState
[in] Wskaźnik do stanu podglądu. Ten parametr nie jest używany.

CDockingManager::SetSmartDockingParams

Ustawia parametry definiujące zachowanie inteligentnego dokowania.

static void SetSmartDockingParams(CSmartDockingInfo& params);

Parametry

params
[in, out] Definiuje parametry inteligentnego dokowania.

Uwagi

Wywołaj tę metodę, jeśli chcesz dostosować wygląd, kolor lub kształt znaczników inteligentnego dokowania.

Aby użyć domyślnego wyszukiwania znaczników dokowania inteligentnego, przekaż niezainicjowane wystąpienie klasy CSmartDockingInfo do parametrów.

CDockingManager::ShowDelayShowMiniFrames

Pokazuje lub ukrywa okna mini ramek.

void ShowDelayShowMiniFrames(BOOL bshow);

Parametry

bShow
[in] WARTOŚĆ TRUE, aby okno wyświetlanej ramki było aktywne; FAŁSZ, aby ukryć okno ramki.

CDockingManager::ShowPanes

Wyświetla lub ukrywa okienka kontrolki i automatycznie ukrywa paski.

virtual BOOL ShowPanes(BOOL bShow);

Parametry

bShow
[in] WARTOŚĆ TRUE, aby wyświetlić okienka; FAŁSZ, aby ukryć okienka.

Wartość zwracana

Zawsze FAŁSZ.

CDockingManager::StartSDocking

Uruchamia inteligentne dokowanie określonego okna zgodnie z dopasowaniem inteligentnego menedżera dokowania.

void StartSDocking(CWnd* pDockingWnd);

Parametry

pDockingWnd
[in] Wskaźnik do zadokowania okna.

CDockingManager::StopSDocking

Zatrzymuje inteligentne dokowanie.

void StopSDocking();

CDockingManager::GetSmartDockingTheme

Metoda statyczna zwracająca motyw używany do wyświetlania znaczników inteligentnego dokowania.

static AFX_SMARTDOCK_THEME __stdcall GetSmartDockingTheme();

Wartość zwracana

Zwraca jedną z następujących wyliczonych wartości: AFX_SDT_DEFAULT, AFX_SDT_VS2005, AFX_SDT_VS2008.

Uwagi

Zobacz też

Wykres hierarchii
Klasy
Klasa CObject
Klasa CFrameWndEx
Klasa CDockablePane
Klasa CPaneFrameWnd