Klasa CDockingManager
Implementuje podstawowe funkcje, które sterują układem dokowania w głównym oknie ramowym.
Składnia
class CDockingManager : public CObject
Członkowie
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 podpis wszystkich okienkach 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 na podpis 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.
Wskazówki dostosowywania
Następujące porady dotyczą CDockingManager obiektów:
Klasa CDockingManager obsługuje następujące tryby dokowania:
AFX_DOCK_TYPE::DT_IMMEDIATEAFX_DOCK_TYPE::DT_STANDARDAFX_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 podpis 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
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ę na podpis innego okienka dokowania lub w obszarze tabulatora okienka z kartami. |
CDockingManager::D isableRestoreDockState
Włącza lub wyłącza ładowanie układu dokowania z rejestru.
void DisableRestoreDockState(BOOL bDisable = TRUE);
Parametry
Bwyłączenie
[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 podpis wszystkich okienkach 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 okienkoDocking- Zadokuje okienko w głównej ramce w lokalizacji, w której okienko zostało ostatnio zadokowaneAutoHide- Przełącza okienko w tryb autohideHide- 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 na podpis wszystkich okienek.
static BOOL IsDockSiteMenu();
Wartość zwracana
WARTOŚĆ TRUE, jeśli w podpis wszystkich okienkach dokowania jest wyświetlane menu witryny dockowania. W przeciwnym razie wartość FALSE.
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.
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
Bloku
[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.
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.
Tematu
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
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla