Klasa CDockSite
Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.
Udostępnia funkcje rozmieszczania okienek, które pochodzą z klasy CPane w zestawach wierszy.
Składnia
class CDockSite: public CBasePane
Elementy członkowskie
Metody publiczne
Uwagi
Struktura tworzy CDockSite obiekty automatycznie po wywołaniu obiektu CFrameWndEx::EnableDocking. Okna lokacji dokowania znajdują się na krawędzi obszaru klienta w głównym oknie ramowym.
Zazwyczaj nie trzeba wywoływać usług udostępnianych przez witrynę docku, ponieważ klasa CFrameWndEx obsługuje te usługi.
Przykład
W poniższym przykładzie pokazano, jak utworzyć obiekt CDockSite klasy.
AFX_DOCKSITE_INFO info;
CDockSite *pDockBar = (CDockSite*)info.pDockBarRTC->CreateObject();
Hierarchia dziedziczenia
Obiekt CObject
└ CCmdTarget
└ CWnd
└ CBasePane
└ CDockSite
Wymagania
Nagłówek: afxDockSite.h
CDockSite::AddRow
CDockingPanesRow* AddRow(
POSITION pos,
int nHeight);
Parametry
[in] pozytyw
[in] nHeight
Wartość zwracana
Uwagi
CDockSite::AdjustDockingLayout
virtual void AdjustDockingLayout();
Uwagi
CDockSite::AdjustLayout
virtual void AdjustLayout();
Uwagi
CDockSite::AlignDockSite
void AlignDockSite(
const CRect& rectToAlignBy,
CRect& rectResult,
BOOL bMoveImmediately);
Parametry
[in] rectToAlignBy
[in] rectResult
[in] bMoveImmediately
Uwagi
CDockSite::CalcFixedLayout
virtual CSize CalcFixedLayout(
BOOL bStretch,
BOOL bHorz);
Parametry
[in] bStretch
[in] bHorz
Wartość zwracana
Uwagi
CDockSite::CanAcceptPane
virtual BOOL CanAcceptPane(const CBasePane* pBar) const;
Parametry
[in] Pasek p
Wartość zwracana
Uwagi
CDockSite::CreateEx
virtual BOOL CreateEx(
DWORD dwStyleEx,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
DWORD dwControlBarStyle,
CCreateContext* pContext = NULL);
Parametry
[in] dwStyleEx
[in] dwStyle
[in] Rect
[in] pParentWnd
[in] dwControlBarStyle
[in] pContext
Wartość zwracana
Uwagi
CDockSite::CreateRow
virtual CDockingPanesRow* CreateRow(
CDockSite* pParentDockBar,
int nOffset,
int nRowHeight);
Parametry
[in] pParentDockBar
[in] nOffset
[in] nRowHeight
Wartość zwracana
Uwagi
CDockSite::D ockPane
virtual void DockPane(
CPane* pWnd,
AFX_DOCK_METHOD dockMethod,
LPCRECT lpRect = NULL);
Parametry
[in] pWnd
[in] dockMethod
[in] lpRect
Uwagi
CDockSite::D ockPaneLeftOf
Zadokuje okienko po lewej stronie innego okienka.
virtual BOOL DockPaneLeftOf(
CPane* pBarToDock,
CPane* pTargetBar);
Parametry
pBarToDock
[in, out] Wskaźnik do okienka, który ma zostać zadokowany po lewej stronie paska pTargetBar.
pTargetBar
[in, out] Wskaźnik do okienka docelowego.
Wartość zwracana
Wartość TRUE, jeśli okienko zostało pomyślnie zadokowane; w przeciwnym razie, FAŁSZ.
Uwagi
CDockSite::D oesAllowDynInsertBefore
virtual BOOL DoesAllowDynInsertBefore() const;
Wartość zwracana
Uwagi
CDockSite::FindPaneByID
Zwraca okienko z danym identyfikatorem.
CPane* FindPaneByID(UINT nID);
Parametry
Nid
[in] Identyfikator polecenia okienka do znalezienia.
Wartość zwracana
Wskaźnik do okienka z określonym identyfikatorem polecenia lub wartością NULL, jeśli okienko nie zostanie znalezione.
Uwagi
CDockSite::FindRowIndex
int FindRowIndex(CDockingPanesRow* pRow);
Parametry
[in] dziób
Wartość zwracana
Uwagi
CDockSite::FixupVirtualRects
virtual void FixupVirtualRects();
Uwagi
CDockSite::GetDockSiteID
virtual UINT GetDockSiteID() const;
Wartość zwracana
Uwagi
CDockSite::GetDockSiteRowsList
const CObList& GetDockSiteRowsList() const;
Wartość zwracana
Uwagi
CDockSite::GetPaneList
Zwraca listę okienek, które są zadokowane w lokacji docku.
const CObList& GetPaneList() const;
Wartość zwracana
Odwołanie tylko do odczytu do listy okienek aktualnie zadokowanych na pasku dokowania.
CDockSite::IsAccessibilityCompatible
virtual BOOL IsAccessibilityCompatible();
Wartość zwracana
Uwagi
CDockSite::IsDragMode
virtual BOOL IsDragMode() const;
Wartość zwracana
Uwagi
CDockSite::IsLastRow
bool IsLastRow(CDockingPanesRow* pRow) const;
Parametry
[in] dziób
Wartość zwracana
Uwagi
CDockSite::IsRectWithinDockSite
BOOL IsRectWithinDockSite(
CRect rect,
CPoint& ptDelta);
Parametry
[in] Rect
[in] ptDelta
Wartość zwracana
Uwagi
CDockSite::IsResizable
virtual BOOL IsResizable() const;
Wartość zwracana
Uwagi
CDockSite::MovePane
virtual BOOL MovePane(
CPane* pWnd,
UINT nFlags,
CPoint ptOffset);
Parametry
[in] pWnd
[in] nFlags
[in] ptOffset
Wartość zwracana
Uwagi
CDockSite::OnInsertRow
virtual void OnInsertRow(POSITION pos);
Parametry
[in] pozytyw
Uwagi
CDockSite::OnRemoveRow
virtual void OnRemoveRow(
POSITION pos,
BOOL bByShow = FALSE);
Parametry
[in] pozytyw
[in] bByShow
Uwagi
CDockSite::OnResizeRow
virtual int OnResizeRow(
CDockingPanesRow* pRowToResize,
int nOffset);
Parametry
[in] pRowToResize
[in] nOffset
Wartość zwracana
Uwagi
CDockSite::OnSizeParent
virtual void OnSizeParent(
CRect& rectAvailable,
UINT nSide,
BOOL bExpand,
int nOffset);
Parametry
[in] rectAvailable
[in] nSide
[in] bExpand
[in] nOffset
Uwagi
CDockSite::OnSetWindowPos
virtual BOOL OnSetWindowPos(
const CWnd* pWndInsertAfter,
const CRect& rectWnd,
UINT nFlags);
Parametry
[in] pWndInsertAfter
[in] rectWnd
[in] nFlags
Wartość zwracana
Uwagi
CDockSite::OnShowRow
virtual void OnShowRow(
POSITION pos,
BOOL bShow);
Parametry
[in] pozytyw
[in] bShow
Uwagi
CDockSite::P aneFromPoint
Zwraca okienko, które jest zadokowane w lokacji docku w punkcie określonym przez dany parametr.
virtual CPane* PaneFromPoint(CPoint pt);
Parametry
Pt
[in] Punkt we współrzędnych ekranu, aby okienko było pobierane.
Wartość zwracana
Wskaźnik do okienka znajdującego się w określonym punkcie lub wartości NULL, jeśli w określonym punkcie nie było żadnego okienka.
Uwagi
CDockSite::RectSideFromPoint
static int __stdcall RectSideFromPoint(
const CRect& rect,
const CPoint& point);
Parametry
[in] Rect
[in] punkt
Wartość zwracana
Uwagi
CDockSite::RemovePane
virtual void RemovePane(
CPane* pWnd,
AFX_DOCK_METHOD dockMethod);
Parametry
[in] pWnd
[in] dockMethod
Uwagi
CDockSite::RemoveRow
void RemoveRow(CDockingPanesRow* pRow);
Parametry
[in] dziób
Uwagi
CDockSite::ReplacePane
BOOL ReplacePane(
CPane* pOldBar,
CPane* pNewBar);
Parametry
[in] pOldBar
[in] pNewBar
Wartość zwracana
Uwagi
CDockSite::RepositionPanes
virtual void RepositionPanes(CRect& rectNewClientArea);
Parametry
[in] rectNewClientArea
Uwagi
CDockSite::ResizeDockSite
void ResizeDockSite(
int nNewWidth,
int nNewHeight);
Parametry
[in] nNewWidth
[in] nNewHeight
Uwagi
CDockSite::ResizeRow
int ResizeRow(
CDockingPanesRow* pRow,
int nNewSize,
BOOL bAdjustLayout = TRUE);
Parametry
[in] dziób
[in] nNewSize
[in] bAdjustLayout
Wartość zwracana
Uwagi
CDockSite::ShowPane
Pokazuje okienko.
virtual BOOL ShowPane(
CBasePane* pBar,
BOOL bShow,
BOOL bDelay,
BOOL bActivate);
Parametry
Pasek p
[in, out] Wskaźnik do okienka, który ma być wyświetlany lub ukryty.
bShow
[in] WARTOŚĆ TRUE określająca, że okienko ma być wyświetlane; FAŁSZ, aby określić, że okienko ma być ukryte.
bDelay
[in] WARTOŚĆ TRUE określająca, że układ okienka powinien być opóźniony do momentu wyświetlenia okienka; w przeciwnym razie, FAŁSZ.
bActivate
[in] Ten parametr nie jest używany.
Wartość zwracana
Wartość TRUE, jeśli okienko zostało wyświetlone lub zostało pomyślnie ukryte. FAŁSZ, jeśli określone okienko nie należy do tej witryny docku.
Uwagi
Wywołaj tę metodę, aby wyświetlić lub ukryć zadokowane okienka. Zwykle nie trzeba wywoływać CDockSite::ShowPane bezpośrednio, ponieważ jest wywoływana przez okno ramki nadrzędnej lub przez okienko podstawowe.
CDockSite::ShowRow
void ShowRow(
CDockingPanesRow* pRow,
BOOL bShow,
BOOL bAdjustLayout);
Parametry
[in] dziób
[in] bShow
[in] bAdjustLayout
Uwagi
CDockSite::SwapRows
void SwapRows(
CDockingPanesRow* pFirstRow,
CDockingPanesRow* pSecondRow);
Parametry
[in] pFirstRow
[in] pSecondRow