Klasa CPane
Klasa CPane
jest ulepszeniem klasy CControlBar. Jeśli uaktualniasz istniejący projekt MFC, zastąp wszystkie wystąpienia elementu CControlBar
CPane
.
Składnia
class CPane : public CBasePane
Elementy członkowskie
Konstruktory publiczne
Nazwa/nazwisko | opis |
---|---|
CPane::~CPane |
Destruktor. |
Metody publiczne
Nazwa/nazwisko | opis |
---|---|
CPane::AdjustSizeImmediate | Natychmiast ponownie oblicza układ okienka. |
CPane::AllocElements | Przydziela magazyn do użytku wewnętrznego. |
CPane::AllowShowOnPaneMenu | Określa, czy okienko jest wyświetlane na liście okienek generowanych przez środowisko uruchomieniowe dla aplikacji. |
CPane::CalcAvailableSize | Oblicza różnicę rozmiaru między określonym prostokątem a bieżącym prostokątem okna. |
CPane::CalcInsideRect | Oblicza wewnętrzny prostokąt okienka, biorąc pod uwagę obramowania i uchwyty. |
CPane::CalcRecentDockedRect | Oblicza ostatnio zadokowany prostokąt. |
CPane::CalcSize | Oblicza rozmiar okienka. |
CPane::CanBeDocked | Określa, czy okienko można zadokować w określonym okienku podstawowym. |
CPane::CanBeTabbedDocument | Określa, czy okienko można przekonwertować na dokument z kartami. |
CPane::ConvertToTabbedDocument | Konwertuje okienko z możliwością dokowania do dokumentu z kartami. |
CPane::CopyState | Kopiuje stan okienka. (Przesłonięcia) CBasePane::CopyState. |
CPane::Create | Tworzy pasek sterowania i dołącza go do CPane obiektu. |
CPane::CreateDefaultMiniframe | Tworzy mini-ramowe okno dla przestawnego okienka. |
CPane::CreateEx | Tworzy pasek sterowania i dołącza go do CPane obiektu. |
CPane::CreateObject |
Używana przez platformę do tworzenia wystąpienia dynamicznego tego typu klasy. |
CPane::D ockByMouse | Zadokuje okienko przy użyciu metody dokowania myszy. |
CPane::D ockPane | Zadokuje przestawne okienko do okienka podstawowego. |
CPane::D ockPaneStandard | Dokowuje okienko przy użyciu zadokowania konspektu (standardowego). |
CPane::D ockToFrameWindow | Zadokuje dokowalne okienko do ramki. (Przesłania CBasePane::DockToFrameWindow ). |
CPane::D oesAllowSiblingBars | Wskazuje, czy można zadokować kolejne okienko w tym samym wierszu, w którym jest zadokowane bieżące okienko. |
CPane::FloatPane | Unosi okienko. |
CPane::GetAvailableExpandSize | Zwraca ilość w pikselach, którą okienko może rozwinąć. |
CPane::GetAvailableStretchSize | Zwraca ilość w pikselach, którą okienko może zmniejszyć. |
CPane::GetBorders | Zwraca szerokość obramowań okienka. |
CPane::GetClientHotSpot | Zwraca gorące miejsce dla okienka. |
CPane::GetDockSiteRow | Zwraca wiersz docku, w którym okienko jest zadokowane. |
CPane::GetExclusiveRowMode | Określa, czy okienko jest w trybie wyłącznych wierszy. |
CPane::GetHotSpot | Zwraca punkt gorący przechowywany w obiekcie bazowym CMFCDragFrameImpl . |
CPane::GetMinSize | Pobiera minimalny dozwolony rozmiar okienka. |
CPane::GetPaneName | Pobiera tytuł okienka. |
CPane::GetResizeStep |
Używane wewnętrznie. |
CPane::GetThisClass |
Używany przez platformę do uzyskiwania wskaźnika do obiektu CRuntimeClass skojarzonego z tym typem klasy. |
CPane::GetVirtualRect | Pobiera wirtualny prostokąt okienka. |
CPane::IsChangeState | W miarę przenoszenia okienka ta metoda analizuje położenie okienka względem innych okienek, dokowania wierszy i okien miniramki oraz zwraca odpowiednią wartość AFX_CS_STATUS. |
CPane::IsDragMode | Określa, czy okienko jest przeciągane. |
CPane::IsInFloatingMultiPaneFrameWnd | Określa, czy okienko znajduje się w oknie ramki z wieloma okienkami. (Przesłania CBasePane::IsInFloatingMultiPaneFrameWnd ). |
CPane::IsLeftOf | Określa, czy okienko jest pozostawione (lub powyżej) określonego prostokąta. |
CPane::IsResizable | Określa, czy można zmienić rozmiar okienka. (Przesłonięcia) CBasePane::IsResizable.) |
CPane::IsTabbed | Określa, czy okienko zostało wstawione w kontrolce karty okna z kartą. (Przesłonięcia) CBasePane::IsTabbed).) |
CPane::LoadState | Ładuje stan okienka z rejestru. (Przesłonięcia) CBasePane::LoadState.) |
CPane::MoveByAlignment | Przenosi okienko i wirtualny prostokąt o określoną kwotę. |
CPane::MovePane | Przenosi okienko do określonego prostokąta. |
CPane::OnAfterChangeParent | Wywoływana przez platformę, gdy element nadrzędny okienka uległ zmianie. |
CPane::OnBeforeChangeParent | Wywoływana przez strukturę, gdy element nadrzędny okienka ma ulec zmianie. |
CPane::OnPressCloseButton | Wywoływana przez platformę, gdy użytkownik wybierze przycisk Zamknij w podpisie okienka. |
CPane::OnProcessDblClk |
Używane wewnętrznie. |
CPane::OnShowControlBarMenu | Wywoływana przez platformę, gdy ma być wyświetlane specjalne menu okienka. |
CPane::OnShowControlBarMenu | Wywoływana przez platformę, gdy ma być wyświetlane specjalne menu okienka. |
CPane::PrepareToDock |
Używane wewnętrznie. |
CPane::RecalcLayout | Oblicza ponownie informacje o układzie okienka. (Przesłonięcia) CBasePane::RecalcLayout). |
CPane::SaveState | Zapisuje stan okienka w rejestrze. (Przesłonięcia) CBasePane::SaveState. |
CPane::SetActiveInGroup | Flaguje okienko jako aktywne. |
CPane::SetBorders | Ustawia wartości obramowania okienka. |
CPane::SetClientHotSpot | Ustawia punkt gorący dla okienka. |
CPane::SetDockState | Przywraca informacje o stanie dokowania dla okienka. |
CPane::SetExclusiveRowMode | Włącza lub wyłącza tryb wyłącznych wierszy. |
CPane::SetMiniFrameRTC | Ustawia informacje o klasie środowiska uruchomieniowego dla domyślnego okna miniramki. |
CPane::SetMinSize | Ustawia minimalny dozwolony rozmiar okienka. |
CPane::SetVirtualRect | Ustawia wirtualny prostokąt okienka. |
CPane::StretchPaneDeferWndPos | Rozciąga okienko w pionie lub poziomo na podstawie stylu dokowania. |
CPane::ToggleAutoHide | Przełącza tryb automatycznego ukrywania. |
CPane::UndockPane | Usuwa okienko z witryny docka, suwak domyślny lub okno miniramki, w którym jest obecnie zadokowany. (Przesłonięcia) CBasePane::UndockPane.) |
CPane::UpdateVirtualRect | Aktualizuje prostokąt wirtualny. |
Metody chronione
Nazwa/nazwisko | opis |
---|---|
CPane::OnAfterDock | Wywoływana przez strukturę, gdy okienko zostało zadokowane. |
CPane::OnAfterFloat | Wywoływana przez platformę, gdy okienko zostało ułożone. |
CPane::OnBeforeDock | Wywoływana przez platformę, gdy okienko ma zostać zadokowane. |
CPane::OnBeforeFloat | Wywoływana przez platformę, gdy okienko ma zostać ułożone jako zmiennoprzecinkowe. |
Składowe danych
Nazwa/nazwisko | opis |
---|---|
CPane::m_bHandleMinSize | Umożliwia spójną obsługę minimalnego rozmiaru okienek. |
CPane::m_recentDockInfo | Zawiera najnowsze informacje o zadokowaniu. |
Uwagi
CPane
Zazwyczaj obiekty nie są tworzone bezpośrednio. Jeśli potrzebujesz okienka z funkcją dokowania, utwórz obiekt z CDockablePane. Jeśli potrzebujesz funkcji paska narzędzi, utwórz obiekt z narzędzia CMFCToolBar.
Po utworzeniu klasy z CPane
klasy można ją zadokować w CDockSite i można ją unosić w CPaneFrameWnd.
Hierarchia dziedziczenia
Wymagania
Nagłówek: afxPane.h
CPane::AdjustSizeImmediate
Natychmiast ponownie oblicza układ okienka.
virtual void AdjustSizeImmediate(BOOL bRecalcLayout = TRUE);
Parametry
bRecalcLayout
[in] WARTOŚĆ TRUE, aby automatycznie ponownie obliczyć układ okienka; w przeciwnym razie, FAŁSZ.
Uwagi
Wywołaj tę metodę, gdy dynamicznie zmieniasz układ okienka. Na przykład możesz wywołać tę metodę podczas ukrywania lub wyświetlania przycisków paska narzędzi.
CPane::AllocElements
Przydziela magazyn do użytku wewnętrznego.
BOOL AllocElements(
int nElements,
int cbElement);
Parametry
nElements
[in] Liczba elementów, dla których należy przydzielić magazyn.
cbElement
[in] Rozmiar elementu w bajtach.
Wartość zwracana
FAŁSZ, jeśli alokacja pamięci nie powiedzie się; w przeciwnym razie wartość TRUE.
CPane::AllowShowOnPaneMenu
Określa, czy okienko jest wyświetlane na liście okienek generowanych przez środowisko uruchomieniowe dla aplikacji.
virtual BOOL AllowShowOnPaneMenu() const;
Wartość zwracana
WARTOŚĆ TRUE, jeśli okienko jest wyświetlane na liście; w przeciwnym razie, FAŁSZ. Implementacja podstawowa zawsze zwraca wartość TRUE.
Uwagi
Aplikacja wygenerowana przez aplikację AppWizard zawiera opcję menu zawierającą okienka, które zawiera. Ta metoda określa, czy okienko jest wyświetlane na liście.
CPane::CalcAvailableSize
Oblicza różnicę rozmiaru między określonym prostokątem a bieżącym prostokątem okna.
virtual CSize CalcAvailableSize(CRect rectRequired);
Parametry
rectRequired
[in] Wymagany prostokąt.
Wartość zwracana
Różnica w szerokości i wysokości między prostokątem rectRequired a bieżącym prostokątem okna.
CPane::CalcInsideRect
Oblicza wewnętrzny prostokąt okienka, w tym obramowania i uchwyty.
void CalcInsideRect(
CRect& rect,
BOOL bHorz) const;
Parametry
Rect
[out] Zawiera rozmiar i przesunięcie obszaru klienta okienka.
bHorz
[in] WARTOŚĆ TRUE, jeśli okienko jest zorientowane w poziomie; w przeciwnym razie, FAŁSZ.
Uwagi
Ta metoda jest wywoływana przez platformę, gdy musi ponownie obliczyć układ okienka. Parametr rect jest wypełniony rozmiarem i przesunięciem obszaru klienta okienka. Obejmuje to swoje granice i uchwyty.
CPane::CalcRecentDockedRect
Oblicza ostatnio zadokowany prostokąt.
void CalcRecentDockedRect();
Uwagi
Ta metoda aktualizuje CPane::m_recentDockInfo.
CPane::CalcSize
Oblicza rozmiar okienka.
virtual CSize CalcSize(BOOL bVertDock);
Parametry
bVertDock
[in] Wartość TRUE, jeśli okienko jest zadokowane w pionie, w przeciwnym razie wartość FALSE.
Wartość zwracana
Domyślna implementacja tej metody zwraca rozmiar (0, 0).
Uwagi
Klasy pochodne powinny zastąpić tę metodę.
CPane::CanBeDocked
Określa, czy okienko można zadokować w określonym okienku podstawowym.
virtual BOOL CanBeDocked(CBasePane* pDockBar) const;
Parametry
pDockBar
[in] Określa okienko, w którym ma być zadokowane to okienko.
Wartość zwracana
WARTOŚĆ TRUE, jeśli to okienko można zadokować w określonym okienku dokowania; w przeciwnym razie, FAŁSZ.
Uwagi
Ta metoda jest zwykle wywoływana przez strukturę w celu określenia, czy okienko można zadokować w określonym okienku dokowania. Aby określić, czy okienko można zadokować, metoda ocenia aktualnie włączone wyrównanie dokowania okienka.
Zadokowanie można włączyć po różnych stronach okna ramki, wywołując polecenie CBasePane::EnableDocking.
CPane::CanBeTabbedDocument
Określa, czy okienko można przekonwertować na dokument z kartami.
virtual BOOL CanBeTabbedDocument() const;
Wartość zwracana
WARTOŚĆ TRUE, jeśli okienko można przekonwertować na dokument z kartami; w przeciwnym razie, FAŁSZ.
Uwagi
Zastąp tę metodę w klasie pochodnej i zwróć wartość FALSE, jeśli chcesz zapobiec konwersji okienka na dokument z kartami. Dokument z kartami nie będzie wyświetlany w menu Położenie okna.
CPane::ConvertToTabbedDocument
Konwertuje okienko z możliwością dokowania do dokumentu z kartami.
virtual void ConvertToTabbedDocument(BOOL bActiveTabOnly = TRUE);
Parametry
bActiveTabOnly
[in] Nieużytne w pliku CPane::ConvertToTabbedDocument
.
Uwagi
Tylko okienka z możliwością dokowania można konwertować na dokumenty z kartami. Aby uzyskać informacje, zobacz CDockablePane::ConvertToTabbedDocument.
CPane::CopyState
Kopiuje stan okienka.
virtual void CopyState(CPane* pOrgBar);
Parametry
pOrgBar
[in] Wskaźnik do okienka.
Uwagi
Ta metoda kopiuje stan elementu pOrgBar do bieżącego okienka.
CPane::Create
Tworzy pasek sterowania i dołącza go do obiektu CPane .
virtual BOOL Create(
LPCTSTR lpszClassName,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID,
DWORD dwControlBarStyle = AFX_DEFAULT_PANE_STYLE,
CCreateContext* pContext = NULL);
Parametry
lpszClassName
[in] Określa nazwę klasy systemu Windows.
dwStyle
[in] Określa atrybuty stylu okna. Aby uzyskać więcej informacji, zobacz Style okien.
Rect
[in] Określa początkowy rozmiar i położenie okna pParentWnd we współrzędnych klienta.
pParentWnd
[in, out] Określa okno nadrzędne tego okienka.
Nid
[in] Określa identyfikator okienka.
dwControlBarStyle
[in] Określa styl okienka. Aby uzyskać więcej informacji, zobacz CBasePane::CreateEx.
pContext
[in, out] Określa kontekst tworzenia okienka.
Wartość zwracana
WARTOŚĆ TRUE, jeśli okienko zostało utworzone pomyślnie; w przeciwnym razie, FAŁSZ.
Uwagi
Ta metoda tworzy okienko systemu Windows i dołącza je do CPane
obiektu.
Jeśli przed wywołaniem Create
nie zainicjowano jawnie CPane::m_recentDockInfo , rect parametru będzie używany jako prostokąt podczas pływającego lub zadokowania okienka.
CPane::CreateDefaultMiniframe
Tworzy mini-ramowe okno dla przestawnego okienka.
virtual CPaneFrameWnd* CreateDefaultMiniframe(CRect rectInitial);
Parametry
rectInitial
[in] Określa początkowy rozmiar i położenie we współrzędnych ekranu okna mini-ramek do utworzenia.
Wartość zwracana
Nowo utworzone okno miniramki.
Uwagi
Ta metoda jest wywoływana przez platformę, aby utworzyć okno mini-ramkowe po upłynięciu okienka. Mini-ramka okna może być typu CPaneFrameWnd lub typu CMultiPaneFrameWnd. Zostanie utworzone okno z wieloma miniramami, jeśli okienko ma styl AFX_CBRS_FLOAT_MULTI.
Informacje o klasie środowiska uruchomieniowego dla okna miniramki są przechowywane w elemencie CPane::m_pMiniFrameRTC
członkowskim. Możesz użyć klasy pochodnej, aby ustawić ten element członkowski, jeśli zdecydujesz się utworzyć dostosowane okna mini-ramowe.
CPane::CreateEx
Tworzy pasek sterowania i dołącza go do obiektu CPane .
virtual BOOL CreateEx(
DWORD dwStyleEx,
LPCTSTR lpszClassName,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID,
DWORD dwControlBarStyle = AFX_DEFAULT_PANE_STYLE,
CCreateContext* pContext = NULL);
Parametry
dwStyleEx
[in] Określa rozszerzone atrybuty stylu okna. Aby uzyskać więcej informacji, zobacz Rozszerzone style okien.
lpszClassName
[in] Określa nazwę klasy systemu Windows.
dwStyle
[in] Określa atrybuty stylu okna. Aby uzyskać więcej informacji, zobacz Style okien.
Rect
[in] Określa początkowy rozmiar i położenie okna pParentWnd we współrzędnych klienta.
pParentWnd
[in, out] Określa okno nadrzędne tego okienka.
Nid
[in] Określa identyfikator okienka.
dwControlBarStyle
[in] Określa styl okienka. Aby uzyskać więcej informacji, zobacz CBasePane::CreateEx.
pContext
[in, out] Określa kontekst tworzenia okienka.
Wartość zwracana
WARTOŚĆ TRUE, jeśli okienko zostało utworzone pomyślnie; w przeciwnym razie, FAŁSZ.
Uwagi
Ta metoda tworzy okienko systemu Windows i dołącza je do CPane
obiektu.
Jeśli przed wywołaniem CreateEx
nie zainicjowano jawnie CPane::m_recentDockInfo , rect parametru będzie używany jako prostokąt podczas pływającego lub zadokowania okienka.
CPane::D ockByMouse
Zadokuje okienko przy użyciu myszy.
virtual BOOL DockByMouse(CBasePane* pDockBar);
Parametry
pDockBar
[in] Określa okienko podstawowe, do którego ma być zadokowany ten okienko.
Wartość zwracana
Wartość TRUE, jeśli okienko zostało pomyślnie zadokowane; w przeciwnym razie, FAŁSZ.
CPane::D ockPane
Zadokuje przestawne okienko do okienka podstawowego.
virtual BOOL DockPane(
CBasePane* pDockBar,
LPCRECT lpRect,
AFX_DOCK_METHOD dockMethod);
Parametry
pDockBar
[in, out] Określa okienko podstawowe, aby zadokować to okienko do.
lpRect
[in] Określa prostokąt w okienku podstawowym, w którym ma zostać zadokowane to okienko.
dockMethod
[in] Określa metodę dokowania do użycia. Dostępne opcje są następujące:
Opcja | Opis |
---|---|
DM_UNKNOWN | Platforma używa tej opcji, gdy metoda dokowania jest nieznana. Okienko nie przechowuje najnowszej pozycji zmiennoprzecinkowej. Możesz również użyć tej opcji, aby programowo zadokować okienko, gdy nie trzeba przechowywać ostatnich pozycji zmiennoprzecinkowych. |
DM_MOUSE | Używane wewnętrznie. |
DM_DBL_CLICK | Ta opcja jest używana po dwukrotnym kliknięciu uchwytu. Okienko jest zmieniane w najnowszej pozycji dokowania. Jeśli okienko jest oddokowane przez dwukrotne kliknięcie, okienko zostanie umieszczone w najnowszej pozycji przestawnej. |
DM_SHOW | Tej opcji można użyć do programowego zadokowania okienka. Okienko przechowuje najnowszą pozycję zmienną. |
DM_RECT | Okienko jest zadokowane w regionie określonym przez lpRect. |
DM_STANDARD | Gdy używasz tej opcji, struktura rysuje okienko jako ramkę konspektu podczas jej przenoszenia. |
Wartość zwracana
Wartość TRUE, jeśli okienko zostało pomyślnie zadokowane; w przeciwnym razie, FAŁSZ.
Uwagi
Ta metoda zadokuje okienko do okienka podstawowego określonego przez parametr pDockBar . Najpierw należy włączyć dokowanie, wywołując polecenie CBasePane::EnableDocking.
CPane::D ockPaneStandard
Dokowuje okienko przy użyciu zadokowania konspektu (standardowego).
virtual CPane* DockPaneStandard(BOOL& bWasDocked);
Parametry
bWasDocked
[in] WARTOŚĆ TRUE, jeśli okienko zostało pomyślnie zadokowane; w przeciwnym razie, FAŁSZ.
Wartość zwracana
Ta metoda zawsze zwraca this
wskaźnik.
Uwagi
Ta metoda jest używana tylko w przypadku okienek pochodzących z klasy CDockablePane. Aby uzyskać więcej informacji, zobacz CDockablePane::D ockPaneStandard.
CPane::D ockToFrameWindow
Zadokuje dokowalne okienko do ramki.
virtual BOOL DockToFrameWindow(
DWORD dwAlignment,
LPCRECT lpRect = NULL,
DWORD dwDockFlags = DT_DOCK_LAST,
CBasePane* pRelativeBar = NULL,
int nRelativeIndex = -1,
BOOL bOuterEdge = FALSE);
Parametry
dwAlignment
[in] Bok ramki nadrzędnej, do której chcesz zadokować okienko.
lpRect
[in] Określony rozmiar.
dwDockFlags
[in] Ignorowane.
Pasek pRelative
[in] Ignorowane.
nRelativeIndex
[in] Ignorowane.
bOuterEdge
[in] Jeśli wartość TRUE i istnieją inne okienka z możliwością dokowania po stronie określone przez dwAlignment, okienko jest zadokowane poza innymi okienkami, bliżej krawędzi ramki nadrzędnej. Jeśli wartość FALSE, okienko jest zadokowane bliżej środka obszaru klienta.
Wartość zwracana
FAŁSZ, jeśli nie można utworzyć klasy dzielenia okienka ( CPaneDivider). W przeciwnym razie wartość TRUE.
Uwagi
CPane::D oesAllowSiblingBars
Wskazuje, czy można zadokować kolejne okienko w tym samym wierszu, w którym jest zadokowane bieżące okienko.
virtual BOOL DoesAllowSiblingBars() const;
Wartość zwracana
Wartość TRUE, jeśli to okienko może zadokować do innego okienka w tym samym wierszu co samo; w przeciwnym razie, FAŁSZ.
Uwagi
To zachowanie można włączyć lub wyłączyć, wywołując polecenie CPane::SetExclusiveRowMode.
Domyślnie paski narzędzi mają wyłączony tryb wyłącznych wierszy, a pasek menu ma włączony tryb wyłącznych wierszy.
CPane::FloatPane
Unosi okienko.
virtual BOOL FloatPane(
CRect rectFloat,
AFX_DOCK_METHOD dockMethod = DM_UNKNOWN,
bool bShow = true);
Parametry
rectFloat
[in] Określa lokalizację we współrzędnych ekranu, aby ustawić okienko po upłynięciu.
dockMethod
[in] Określa metodę dokowania, która ma być używana, gdy okienko jest unoszone. Aby uzyskać listę możliwych wartości, zobacz CPane::D ockPane.
bShow
[in] WARTOŚĆ TRUE, aby wyświetlić okienko po upłynięciu; w przeciwnym razie, FAŁSZ.
Wartość zwracana
Wartość TRUE, jeśli okienko zostało pomyślnie ułożone lub jeśli okienko nie może zostać ułożone, ponieważ CBasePane::CanFloat zwraca wartość FALSE; w przeciwnym razie wartość FALSE.
Uwagi
Wywołaj tę metodę, aby umieścić okienko w pozycji określonej przez parametr rectFloat . Ta metoda automatycznie tworzy nadrzędne okno mini-ramki dla okienka.
CPane::GetAvailableExpandSize
Zwraca ilość w pikselach, którą okienko może rozwinąć.
virtual int GetAvailableExpandSize() const;
Wartość zwracana
Jeśli okienko jest zadokowane w poziomie, zwracana wartość jest dostępna szerokość; w przeciwnym razie zwracana wartość jest dostępną wysokością.
Uwagi
CPane::GetAvailableStretchSize
Zwraca ilość w pikselach, którą okienko może zmniejszyć.
virtual int GetAvailableStretchSize() const;
Wartość zwracana
Ilość w pikselach, którą okienko może zmniejszyć. Jeśli okienko jest zadokowane w poziomie, ta ilość jest dostępna szerokość; w przeciwnym razie jest to dostępna wysokość.
Uwagi
Dostępny rozmiar rozciągnięcia jest obliczany przez odejmowanie minimalnego dozwolonego rozmiaru okienka ( CPane::GetMinSize) z bieżącego rozmiaru ( CWnd::GetWindowRect).
CPane::GetBorders
Zwraca szerokość obramowań okienka.
CRect GetBorders() const;
Wartość zwracana
Obiekt CRect zawierający bieżącą szerokość w pikselach każdej strony okienka. Na przykład wartość left
elementu członkowskiego CRect
obiektu to szerokość lewego obramowania.
Uwagi
Aby ustawić rozmiar obramowań, wywołaj metodę CPane::SetBorders.
CPane::GetClientHotSpot
Zwraca gorące miejsce dla okienka.
CPoint GetClientHotSpot() const;
Wartość zwracana
Uwagi
Hot spot to punkt w okienku, który użytkownik wybiera i przechowuje w celu przeniesienia okienka. Gorące miejsce służy do płynnej animacji, gdy okienko jest przenoszone z zadokowanej pozycji.
CPane::GetDockSiteRow
Zwraca wiersz docku ( klasa CDockingPanesRow), w którym okienko jest zadokowane.
CDockingPanesRow* GetDockSiteRow() const;
Wartość zwracana
Wartość CDockingPanesRow
* wskazująca wiersz docka, w którym okienko jest zadokowane, lub wartość NULL, jeśli okienko nie jest zadokowane.
CPane::GetExclusiveRowMode
Określa, czy okienko jest w trybie wyłącznych wierszy.
virtual BOOL GetExclusiveRowMode() const;
Wartość zwracana
WARTOŚĆ TRUE, jeśli okienko jest w trybie wyłącznych wierszy; w przeciwnym razie, FAŁSZ.
Uwagi
Aby uzyskać więcej informacji o trybie wyłącznych wierszy, zobacz CPane::SetExclusiveRowMode.
CPane::GetHotSpot
Zwraca punkt gorący przechowywany w obiekcie bazowym CMFCDragFrameImpl
.
CPoint GetHotSpot() const;
Wartość zwracana
Uwagi
Klasa CPane
zawiera CMFCDragFrameImpl
obiekt , m_dragFrameImpl
który jest odpowiedzialny za rysowanie prostokąta wyświetlanego, gdy użytkownik przenosi okienko w standardowym trybie dokowania. Punkt gorący służy do rysowania prostokąta względem bieżącej pozycji myszy, gdy użytkownik przenosi okienko.
CPane::GetMinSize
Pobiera minimalny dozwolony rozmiar okienka.
virtual void GetMinSize(CSize& size) const;
Parametry
rozmiar
[out] CSize
Obiekt wypełniony minimalnym dozwolonym rozmiarem.
Uwagi
CPane::GetPaneName
Pobiera tytuł okienka.
virtual void GetPaneName(CString& strName) const;
Parametry
strName
[out] CString
Obiekt wypełniony nazwą podpisu.
Uwagi
Tytuł okienka jest wyświetlany w obszarze podpisów, gdy okienko jest zadokowane lub przestawne. Jeśli okienko jest częścią grupy z kartami, tytuł jest wyświetlany w obszarze karty. Jeśli okienko jest w trybie automatycznego ukrywania, tytuł jest wyświetlany na .CMFCAutoHideButton
CPane::GetVirtualRect
Pobiera wirtualny prostokąt okienka.
void GetVirtualRect(CRect& rectVirtual) const;
Parametry
rectVirtual
[out] CRect
Obiekt wypełniony prostokątem wirtualnym.
Uwagi
Po przeniesieniu okienka struktura przechowuje oryginalną pozycję okienka w wirtualnym prostokątze. Struktura może używać wirtualnego prostokąta do przywrócenia oryginalnej pozycji okienka.
Nie należy wywoływać metod powiązanych z wirtualnymi prostokątami, chyba że przenosisz okienka programowo.
CPane::IsChangeState
W miarę przenoszenia okienka ta metoda analizuje swoją pozycję względem innych okienek, dokowania wierszy i okien mini-ramowych oraz zwraca odpowiednią wartość AFX_CS_STATUS.
virtual AFX_CS_STATUS IsChangeState(
int nOffset,
CBasePane** ppTargetBar) const;
Parametry
nOffset
[in] Określa czułość dokowania. Na przykład okienko przeniesione w pikselach nOffset z wiersza dock zostanie zadokowane.
ppTargetBar
[in] Gdy metoda zwraca wartość, ppTargetBar zawiera wskaźnik do obiektu, do którego powinno zostać zadokowane bieżące okienko, lub wartość NULL, jeśli nie powinno wystąpić dokowanie.
Wartość zwracana
Jedną z następujących wartości AFX_CS_STATUS:
Wartość | Opis |
---|---|
CS_NOTHING | Okienko nie znajduje się w pobliżu witryny docku. Struktura nie zadokuje okienka. |
CS_DOCK_IMMEDIATELY | Okienko znajduje się w witrynie dokowania, a styl DT_IMMEDIATE jest włączony. Platforma natychmiast zadokuje okienko. |
CS_DELAY_DOCK | Okienko znajduje się w lokacji dokowania, która jest innym okienkiem dokowania lub krawędzią ramki głównej. Platforma zadokuje okienko, gdy użytkownik zwolni przeniesienie. |
CS_DELAY_DOCK_TO_TAB | Okienko znajduje się w witrynie dokowania, która powoduje, że okienko jest zadokowane w oknie z kartami. Dzieje się tak, gdy okienko znajduje się nad podpisem innego okienka dokowania lub obszarem karty okienka z kartą. Platforma zadokuje okienko, gdy użytkownik zwolni przeniesienie. |
CPane::IsDragMode
Określa, czy okienko jest przenoszone.
virtual BOOL IsDragMode() const;
Wartość zwracana
WARTOŚĆ TRUE, jeśli okienko jest przenoszone; w przeciwnym razie, FAŁSZ.
Uwagi
CPane::IsInFloatingMultiPaneFrameWnd
Określa, czy okienko znajduje się w oknie ramowym z wieloma okienkami ( Klasa CMultiPaneFrameWnd).
virtual BOOL IsInFloatingMultiPaneFrameWnd() const;
Wartość zwracana
WARTOŚĆ TRUE, jeśli okienko znajduje się w oknie ramki z wieloma okienkami; w przeciwnym razie, FAŁSZ.
Uwagi
Tylko zadokowalne okienka mogą unosić się w oknie ramowym z wieloma okienkami. W związku z CPane::IsInFloatingMultiPaneFrameWnd
tym zawsze zwraca wartość FALSE.
CPane::IsLeftOf
Określa, czy okienko jest pozostawione (lub powyżej) określonego prostokąta.
bool IsLeftOf(
CRect rect,
bool bWindowRect = true) const;
Parametry
Rect
[in] CRect
Obiekt, który jest używany do porównania.
bWindowRect
[in] Jeśli wartość TRUE, przyjmuje się, że rect zawiera współrzędne ekranu; jeśli przyjmuje się, że fałsz, przyjmuje się, że zawiera współrzędne klienta.
Wartość zwracana
Uwagi
Jeśli okienko jest zadokowane w poziomie, ta metoda sprawdza, czy jego lokalizacja jest pozostawiona z rect. W przeciwnym razie ta metoda sprawdza, czy lokalizacja znajduje się powyżej rect.
CPane::IsResizable
Określa, czy okienko jest możliwe do zmiany rozmiaru.
virtual BOOL IsResizable() const;
Wartość zwracana
WARTOŚĆ TRUE, jeśli okienko jest możliwe do zmiany rozmiaru; w przeciwnym razie, FAŁSZ.
Uwagi
Obiekty podstawowe CPane
nie mogą zmieniać rozmiaru.
Menedżer dokowania używa flagi możliwej do zmiany rozmiaru w celu określenia układu okienka. Okienka z możliwością zmiany rozmiaru są zawsze zlokalizowane na zewnętrznych krawędziach ramki nadrzędnej.
Okienka z możliwością zmiany rozmiaru nie mogą znajdować się w kontenerach dokowania.
CPane::IsTabbed
Określa, czy okienko zostało wstawione do kontrolki karty okna z kartą.
virtual BOOL IsTabbed() const;
Wartość zwracana
WARTOŚĆ TRUE, jeśli okienko jest z kartami; w przeciwnym razie, FAŁSZ.
Uwagi
Stan z kartami jest traktowany oddzielnie od pływających, zadokowanych i automatycznie ukrywanych stanów.
CPane::LoadState
Ładuje stan okienka z rejestru.
virtual BOOL LoadState(
LPCTSTR lpszProfileName = NULL,
int nIndex = -1,
UINT uiID = (UINT) -1);
Parametry
lpszProfileName
[in] Nazwa profilu.
nIndex
[in] Indeks profilu.
identyfikator uiID
[in] Identyfikator okienka.
Wartość zwracana
WARTOŚĆ TRUE, jeśli stan okienka został pomyślnie załadowany; w przeciwnym razie, FAŁSZ.
Uwagi
Struktura wywołuje tę metodę, aby załadować stan okienka z rejestru. Zastąp go w klasie pochodnej, aby załadować dodatkowe informacje zapisane przez CPane::SaveState.
Gdy zastąpisz tę metodę, wywołaj również metodę podstawową i zwrócisz wartość FALSE, jeśli metoda podstawowa zwróci wartość FALSE.
CPane::m_bHandleMinSize
Umożliwia spójną obsługę minimalnych rozmiarów okienek.
AFX_IMPORT_DATA static BOOL m_bHandleMinSize;
Uwagi
Jeśli co najmniej jedno okienko dokowania w aplikacji zastępuje GetMinSize
metodę , lub jeśli aplikacja wywołuje SetMinSize
metodę , możesz ustawić ten statyczny element członkowski na wartość TRUE, aby umożliwić platformie spójną obsługę rozmiaru okienek.
Jeśli ta wartość ma wartość TRUE, wszystkie okienka, których rozmiar powinien zostać zmniejszony poniżej ich minimalnego rozmiaru, nie zostaną obcięte, a nie rozciągnięte. Ponieważ platforma używa regionów okien do celów ustalania rozmiaru okienka, nie zmieniaj rozmiaru obszaru okna na potrzeby dokowania okien, jeśli ta wartość jest ustawiona na WARTOŚĆ TRUE.
CPane::m_recentDockInfo
Zawiera najnowsze informacje o zadokowaniu.
CRecentDockSiteInfo m_recentDockInfo;
Uwagi
Platforma przechowuje najnowsze informacje o stanie dokowania dla okienka w tym elemencie członkowskim.
CPane::MoveByAlignment
Przenosi okienko i wirtualny prostokąt o określoną kwotę.
BOOL MoveByAlignment(
DWORD dwAlignment,
int nOffset);
Parametry
dwAlignment
[in] Określa wyrównanie okienka.
nOffset
[in] Ilość w pikselach, za pomocą której można przenieść okienko i wirtualny prostokąt.
Wartość zwracana
Uwagi
DwAlignment może być dowolną z następujących wartości:
Wartość | Opis |
---|---|
CBRS_ALIGN_TOP | Umożliwia zadokowaniu okienka do górnej części obszaru klienta okna ramki. |
CBRS_ALIGN_BOTTOM | Umożliwia zadokowaniu okienka do dołu obszaru klienta okna ramki. |
CBRS_ALIGN_LEFT | Umożliwia zadokowania okienka po lewej stronie obszaru klienta okna ramki. |
CBRS_ALIGN_RIGHT | Umożliwia zadokowania okienka po prawej stronie obszaru klienta okna ramowego. |
CBRS_ALIGN_ANY | Umożliwia zadokowaniu okienka do dowolnej strony obszaru klienta okna ramowego. |
Jeśli dwAlignment zawiera flagę CBRS_ALIGN_LEFT lub CBRS_ALIGN_RIGHT, okienko i wirtualny prostokąt są przenoszone w poziomie; w przeciwnym razie, jeśli dwAlignment zawiera flagę CBRS_ALIGN_TOP lub CBRS_ALIGN_BOTTOM, okienko i prostokąt wirtualny są przenoszone w pionie.
CPane::MovePane
Przenosi okienko do określonego prostokąta.
virtual CSize MovePane(
CRect rectNew,
BOOL bForceMove,
HDWP& hdwp);
Parametry
rectNew
[in] Określa nowy prostokąt dla okienka.
bForceMove
[in] Jeśli wartość TRUE, ta metoda ignoruje minimalny dozwolony rozmiar okienka ( CPane::GetMinSize); w przeciwnym razie okienko zostanie dostosowane, w razie potrzeby, aby upewnić się, że jest to co najmniej minimalny dozwolony rozmiar.
hdwp
[in] Nieużytne.
Wartość zwracana
CSize
Obiekt, który zawiera różnice szerokości i wysokości między nowymi i starymi prostokątami (stary prostokąt — rectNew).
Uwagi
Ta metoda jest używana tylko w przypadku okienk z możliwością dokowania.
CPane::OnAfterChangeParent
Wywoływana przez platformę, gdy element nadrzędny okienka uległ zmianie.
virtual void OnAfterChangeParent(CWnd* pWndOldParent);
Parametry
pWndOldParent
[in, out] Poprzednie okno nadrzędne okienka.
Uwagi
Ta metoda jest wywoływana przez strukturę, gdy element nadrzędny okienka uległ zmianie ze względu na operację dokowania lub zmiennoprzecinkową.
CPane::OnAfterDock
Wywoływana przez strukturę, gdy okienko zostało zadokowane.
virtual void OnAfterDock(
CBasePane* pBar,
LPCRECT lpRect,
AFX_DOCK_METHOD dockMethod);
Parametry
Pasek p
[in] Ten parametr nie jest używany.
lpRect
[in] Ten parametr nie jest używany.
dockMethod
[in] Ten parametr nie jest używany.
CPane::OnAfterFloat
Wywoływana przez strukturę po przecinkach okienka.
virtual void OnAfterFloat();
Uwagi
Tę metodę można zastąpić w klasie pochodnej, jeśli chcesz wykonać dowolne przetwarzanie po przecinkach okienka.
CPane::OnBeforeChangeParent
Wywoływana przez strukturę, gdy element nadrzędny okienka ma ulec zmianie.
virtual void OnBeforeChangeParent(
CWnd* pWndNewParent,
BOOL bDelay = FALSE);
Parametry
pWndNewParent
[in, out] Określa nowe okno nadrzędne.
bDelay
[in] WARTOŚĆ TRUE, aby opóźnić globalne dostosowanie układu dokowania; w przeciwnym razie, FAŁSZ.
Uwagi
Ta metoda jest wywoływana przez strukturę, gdy element nadrzędny okienka ma ulec zmianie, ponieważ okienko jest zadokowane lub zmiennoprzecinkowe.
Domyślnie okienko jest wyrejestrowane za pomocą okienka dokowania przez wywołanie metody CDockSite::RemovePane
.
CPane::OnBeforeDock
Wywoływana przez platformę, gdy okienko ma być dokowane.
virtual BOOL OnBeforeDock(
CBasePane** ppDockBar,
LPCRECT lpRect,
AFX_DOCK_METHOD dockMethod);
Parametry
ppDockBar
[in, out] Określa okienko, do którego jest zadokowany ten okienko.
lpRect
[in] Określa prostokąt dokowania.
dockMethod
[in] Określa metodę dokowania.
Wartość zwracana
Wartość TRUE, jeśli okienko można zadokować. Jeśli funkcja zwróci wartość FALSE, operacja dockowania zostanie przerwana.
Uwagi
Ta metoda jest wywoływana przez strukturę, gdy okienko ma zostać zadokowane. Tę metodę można zastąpić w klasie pochodnej, jeśli chcesz wykonać jakiekolwiek przetwarzanie, zanim okienko zostanie ostatecznie zadokowane.
CPane::OnBeforeFloat
Wywoływana przez platformę, gdy okienko ma być zmiennoprzecinkowe.
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 okienka.
Wartość zwracana
WARTOŚĆ TRUE, jeśli okienko można unosić; w przeciwnym razie, FAŁSZ.
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, zanim okienko w końcu przejdzie zmiennoprzecinkami.
CPane::OnPressCloseButton
Wywoływana przez platformę, gdy użytkownik naciska przycisk zamknij w podpisie okienka.
virtual void OnPressCloseButton();
Uwagi
Ta metoda jest wywoływana przez platformę, gdy użytkownik naciska przycisk Zamknij w podpisie okienka. Aby otrzymywać powiadomienia o zdarzeniu Close , można zastąpić tę metodę w klasie pochodnej.
CPane::OnShowControlBarMenu
Wywoływana przez platformę, gdy ma być wyświetlane specjalne menu okienka.
virtual BOOL OnShowControlBarMenu(CPoint point);
Parametry
punkt
[in] Określa lokalizację menu.
Wartość zwracana
WARTOŚĆ TRUE, jeśli można wyświetlić menu; w przeciwnym razie, FAŁSZ.
Uwagi
Menu zawiera kilka elementów, które umożliwiają określenie zachowania okienka, a mianowicie: Pływające, Dokowanie, AutoHide i Ukryj. To menu można włączyć dla wszystkich okienek, wywołując polecenie CDockingManager::EnableDockSiteMenu.
CPane::RecalcLayout
Oblicza ponownie informacje o układzie okienka.
virtual void RecalcLayout();
Uwagi
Jeśli okienko jest zadokowane, ta metoda aktualizuje wirtualny prostokąt okienka, ustawiając jego rozmiar na bieżący rozmiar okienka.
Jeśli okienko jest przestawne, ta metoda powiadamia nadrzędną mini-ramkę, aby dostosować rozmiar okienka do rozmiaru mini-ramki. Struktura zapewnia, że mini-ramka jest co najmniej minimalny dozwolony rozmiar okienka ( CPane::GetMinSize) i zmienia rozmiar mini-ramki, jeśli jest to konieczne.
CPane::SaveState
Zapisuje stan okienka w rejestrze.
virtual BOOL SaveState(
LPCTSTR lpszProfileName = NULL,
int nIndex = -1,
UINT uiID = (UINT) -1);
Parametry
lpszProfileName
[in] Nazwa profilu.
nIndex
[in] Indeks profilu.
identyfikator uiID
[in] Identyfikator okienka.
Wartość zwracana
Wartość TRUE, jeśli stan został zapisany pomyślnie; w przeciwnym razie, FAŁSZ.
Uwagi
Struktura wywołuje tę metodę, gdy zapisuje stan okienka w rejestrze. Zastąp SaveState
element w klasie pochodnej, aby przechowywać dodatkowe informacje.
Gdy zastąpisz tę metodę, wywołaj również metodę podstawową i zwrócisz wartość FALSE, jeśli metoda podstawowa zwróci wartość FALSE.
CPane::SetActiveInGroup
Flaguje okienko jako aktywne.
virtual void SetActiveInGroup(BOOL bActive);
Parametry
bActive
[in] Wartość LOGICZNA określająca, czy okienko jest oflagowane jako aktywne.
Uwagi
Po wyświetleniu okienka z możliwością dokowania lub wybraniu przycisku automatycznego ukrywania odpowiednie okienko automatycznego ukrywania jest oznaczone jako aktywne.
Wygląd przycisku automatycznego ukrywania skojarzonego z okienkiem opiera się na dwóch czynnikach. Jeśli okienko jest aktywne i static BOOL CMFCAutoHideButton::m_bOverlappingTabs
ma wartość TRUE, platforma wyświetla przycisk automatycznego ukrywania jako ikonę i etykietę. W przypadku okienka nieaktywnego platforma wyświetla tylko ikonę automatycznego ukrywania.
W przypadku CMFCAutoHideButton::m_bOverlappingTabs
wartości FALSE lub jeśli okienko nie znajduje się w grupie, platforma wyświetla skojarzony przycisk automatycznego ukrywania jako ikonę i etykietę.
CPane::SetBorders
Ustawia wartości obramowania okienka.
void SetBorders(
int cxLeft = 0,
int cyTop = 0,
int cxRight = 0,
int cyBottom = 0);
void SetBorders(LPCRECT lpRect);
Parametry
cxLeft
[in] Określa szerokość w pikselach lewej krawędzi okienka.
cyTop
[in] Określa szerokość w pikselach górnego obramowania okienka.
cxRight
[in] Określa szerokość w pikselach prawego obramowania okienka.
cyBottom
[in] Określa szerokość w pikselach dolnej krawędzi okienka.
lpRect
[in] Obiekt CRect zawierający szerokość w pikselach każdego obramowania okienka.
Uwagi
Wywołaj tę funkcję, aby ustawić rozmiary obramowań okienka.
CPane::SetClientHotSpot
Ustawia punkt gorący dla okienka.
void SetClientHotSpot(const CPoint& ptNew);
Parametry
ptNowy
[in] CPoint
Obiekt, który określa nową lokalizację gorącą.
Uwagi
Hot spot to punkt w okienku, który użytkownik wybiera i przechowuje w celu przeniesienia okienka. Gorące miejsce służy do płynnej animacji, gdy okienko jest przeciągane z zadokowanej pozycji.
CPane::SetDockState
Przywraca informacje o stanie dokowania dla okienka.
virtual void SetDockState(CDockingManager* pDockManager);
Parametry
pDockManager
[in] Wskaźnik do menedżera dokowania dla głównego okna ramowego.
Uwagi
Ta metoda jest wywoływana przez strukturę w celu przywrócenia najnowszych informacji o stanie dokowania dla okienka. Okienko przechowuje najnowsze informacje o stanie dokowania w CPane::m_recentDockInfo. Aby uzyskać więcej informacji, zobacz klasę CRecentDockSiteInfo.
Tę metodę można również wywołać, aby ustawić stan dokowania podczas ładowania informacji o okienku z zewnętrznego źródła.
CPane::SetExclusiveRowMode
Włącza lub wyłącza tryb wyłącznych wierszy.
virtual void SetExclusiveRowMode(BOOL bExclusive = TRUE);
Parametry
bExclusive
[in] WARTOŚĆ TRUE, aby włączyć tryb wyłącznych wierszy; w przeciwnym razie, FAŁSZ.
Uwagi
Wywołaj tę metodę, aby włączyć lub wyłączyć tryb wyłącznych wierszy. Gdy okienko jest w trybie wyłącznych wierszy, nie może współużytkowanie tego samego wiersza z żadnymi innymi paskami narzędzi.
Domyślnie wszystkie paski narzędzi mają wyłączony tryb wyłącznych wierszy, a pasek menu ma włączony tryb wyłącznych wierszy.
CPane::SetMinSize
Ustawia minimalny dozwolony rozmiar okienka.
void SetMinSize(const CSize& size);
Parametry
rozmiar
[in] CSize
Obiekt zawierający minimalny dozwolony rozmiar okienka.
Uwagi
CPane::SetVirtualRect
Ustawia wirtualny prostokąt okienka.
void SetVirtualRect(
const CRect& rect,
BOOL bMapToParent = TRUE);
Parametry
Rect
[in] CRect
Obiekt, który określa prostokąt wirtualny do ustawienia.
bMapToParent
[in] Określ wartość TRUE, jeśli rect zawiera punkty względem okna nadrzędnego.
Uwagi
Wirtualny prostokąt przechowuje oryginalną pozycję okienka po przeniesieniu. Struktura może używać wirtualnego prostokąta do przywrócenia oryginalnej pozycji.
Nie należy wywoływać metod powiązanych z wirtualnymi prostokątami, chyba że przenosisz okienka programowo.
CPane::SetMiniFrameRTC
Ustawia informacje o klasie środowiska uruchomieniowego dla domyślnego okna miniramki.
void SetMiniFrameRTC(CRuntimeClass* pClass);
Parametry
pClass
[in, out] Określa informacje o klasie środowiska uruchomieniowego dla okna miniramki.
Uwagi
Gdy okienko jest unoszone, jest umieszczane w oknie CPaneFrameWnd (mini-ramka). Możesz podać niestandardową CPaneFrameWnd
klasę pochodną, która będzie używana podczas wywoływanej klasy CPane::CreateDefaultMiniframe .
CPane::StretchPaneDeferWndPos
Rozciąga okienko w pionie lub poziomo na podstawie stylu dokowania.
virtual int StretchPaneDeferWndPos(
int nStretchSize,
HDWP& hdwp);
Parametry
nStretchSize
[in] Ilość w pikselach, aby rozciągnąć okienko. Użyj wartości ujemnej, aby zmniejszyć okienko.
hdwp
[in] Nieużytne.
Wartość zwracana
Rzeczywista ilość w pikselach, którą okienko zostało rozciągnięte.
Uwagi
W razie potrzeby ta metoda modyfikuje parametr nStretchSize , aby upewnić się, że okienko nie przekracza limitów rozmiaru. Te limity są uzyskiwane przez wywołanie CPane ::GetAvailableStretchSize i CPane::GetAvailableExpandSize.
CPane::ToggleAutoHide
Przełącza tryb automatycznego ukrywania.
virtual void ToggleAutoHide();
Uwagi
Wywołaj tę metodę, aby przełączać tryb automatycznego ukrywania. Aby można było przełączyć się do trybu automatycznego ukrywania, okienko musi być zadokowane do głównego okna ramowego.
CPane::UndockPane
Usuwa okienko z witryny docka, suwak domyślny lub okno miniramki, w którym jest obecnie zadokowany.
virtual void UndockPane(BOOL bDelay = FALSE);
Parametry
bDelay
[in] Jeśli wartość FALSE, struktura wywołuje element CBasePane::AdjustDockingLayout , aby dostosować układ dokowania.
Uwagi
Ta metoda służy do programowego oddokowania okienka.
CPane::UpdateVirtualRect
Aktualizuje prostokąt wirtualny.
void UpdateVirtualRect();
void UpdateVirtualRect(CPoint ptOffset);
void UpdateVirtualRect(CSize sizeNew);
Parametry
ptOffset
[in] CPoint
Obiekt, który określa przesunięcie, aby przesunąć okienko.
sizeNowy
[in] CSize
Obiekt określający nowy rozmiar okienka.
Uwagi
Pierwsze przeciążenie ustawia prostokąt wirtualny przy użyciu bieżącej pozycji i rozmiaru okienka.
Drugie przeciążenie przesuwa wirtualny prostokąt o wartość określoną przez ptOffset.
Trzecie przeciążenie ustawia wirtualny prostokąt przy użyciu bieżącej pozycji okienka i rozmiaru określonego przez rozmiarNowy.