Classe CDockSite
Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.
Fornisce la funzionalità per disporre in set di righe i riquadri che derivano dalla CPane Class .
Sintassi
class CDockSite: public CBasePane
Membri
Metodi pubblici
Osservazioni:
Il framework crea CDockSite automaticamente oggetti quando si chiama CFrameWndEx::EnableDocking. Le finestre del sito di ancoraggio sono posizionate sul bordo dell'area client nella finestra cornice principale.
In genere non è necessario chiamare i servizi forniti dal sito dock perché la classe CFrameWndEx gestisce questi servizi.
Esempio
Nell'esempio riportato di seguito viene illustrato come creare un oggetto della classe CDockSite.
AFX_DOCKSITE_INFO info;
CDockSite *pDockBar = (CDockSite*)info.pDockBarRTC->CreateObject();
Gerarchia di ereditarietà
CObject
└ CCmdTarget
└ CWnd
└ CBasePane
└ CDockSite
Requisiti
Intestazione: afxDockSite.h
CDockSite::AddRow
CDockingPanesRow* AddRow(
POSITION pos,
int nHeight);
Parametri
[in] Pos
[in] nHeight
Valore restituito
Osservazioni:
CDockSite::AdjustDockingLayout
virtual void AdjustDockingLayout();
Osservazioni:
CDockSite::AdjustLayout
virtual void AdjustLayout();
Osservazioni:
CDockSite::AlignDockSite
void AlignDockSite(
const CRect& rectToAlignBy,
CRect& rectResult,
BOOL bMoveImmediately);
Parametri
[in] rectToAlignBy
[in] rectResult
[in] bMoveImmediately
Osservazioni:
CDockSite::CalcFixedLayout
virtual CSize CalcFixedLayout(
BOOL bStretch,
BOOL bHorz);
Parametri
[in] bStretch
[in] bHorz
Valore restituito
Osservazioni:
CDockSite::CanAcceptPane
virtual BOOL CanAcceptPane(const CBasePane* pBar) const;
Parametri
[in] pBar
Valore restituito
Osservazioni:
CDockSite::CreateEx
virtual BOOL CreateEx(
DWORD dwStyleEx,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
DWORD dwControlBarStyle,
CCreateContext* pContext = NULL);
Parametri
[in] dwStyleEx
[in] dwStyle
[in] rect
[in] pParentWnd
[in] dwControlBarStyle
[in] pContext
Valore restituito
Osservazioni:
CDockSite::CreateRow
virtual CDockingPanesRow* CreateRow(
CDockSite* pParentDockBar,
int nOffset,
int nRowHeight);
Parametri
[in] pParentDockBar
[in] nOffset
[in] nRowHeight
Valore restituito
Osservazioni:
CDockSite::D ockPane
virtual void DockPane(
CPane* pWnd,
AFX_DOCK_METHOD dockMethod,
LPCRECT lpRect = NULL);
Parametri
[in] pWnd
[in] dockMethod
[in] lpRect
Osservazioni:
CDockSite::D ockPaneLeftOf
Ancora un riquadro a sinistra di un altro riquadro.
virtual BOOL DockPaneLeftOf(
CPane* pBarToDock,
CPane* pTargetBar);
Parametri
pBarToDock
[in, out] Puntatore al riquadro da ancorare a sinistra di pTargetBar.
pTargetBar
[in, out] Puntatore al riquadro di destinazione.
Valore restituito
TRUE se il riquadro è ancorato correttamente; in caso contrario, FALSE.
Osservazioni:
CDockSite::D oesAllowDynInsertBefore
virtual BOOL DoesAllowDynInsertBefore() const;
Valore restituito
Osservazioni:
CDockSite::FindPaneByID
Restituisce il riquadro con l'ID specificato.
CPane* FindPaneByID(UINT nID);
Parametri
nID
[in] ID del comando del riquadro da trovare.
Valore restituito
Puntatore al riquadro con l'ID comando specificato o NULL se il riquadro non viene trovato.
Osservazioni:
CDockSite::FindRowIndex
int FindRowIndex(CDockingPanesRow* pRow);
Parametri
[in] prua
Valore restituito
Osservazioni:
CDockSite::FixupVirtualRects
virtual void FixupVirtualRects();
Osservazioni:
CDockSite::GetDockSiteID
virtual UINT GetDockSiteID() const;
Valore restituito
Osservazioni:
CDockSite::GetDockSiteRowsList
const CObList& GetDockSiteRowsList() const;
Valore restituito
Osservazioni:
CDockSite::GetPaneList
Restituisce un elenco di riquadri ancorati nel sito dock.
const CObList& GetPaneList() const;
Valore restituito
Riferimento di sola lettura all'elenco di riquadri attualmente ancorati nella barra di ancoraggio.
CDockSite::IsAccessibilityCompatible
virtual BOOL IsAccessibilityCompatible();
Valore restituito
Osservazioni:
CDockSite::IsDragMode
virtual BOOL IsDragMode() const;
Valore restituito
Osservazioni:
CDockSite::IsLastRow
bool IsLastRow(CDockingPanesRow* pRow) const;
Parametri
[in] prua
Valore restituito
Osservazioni:
CDockSite::IsRectWithinDockSite
BOOL IsRectWithinDockSite(
CRect rect,
CPoint& ptDelta);
Parametri
[in] rect
[in] ptDelta
Valore restituito
Osservazioni:
CDockSite::IsResizable
virtual BOOL IsResizable() const;
Valore restituito
Osservazioni:
CDockSite::MovePane
virtual BOOL MovePane(
CPane* pWnd,
UINT nFlags,
CPoint ptOffset);
Parametri
[in] pWnd
[in] nFlags
[in] ptOffset
Valore restituito
Osservazioni:
CDockSite::OnInsertRow
virtual void OnInsertRow(POSITION pos);
Parametri
[in] Pos
Osservazioni:
CDockSite::OnRemoveRow
virtual void OnRemoveRow(
POSITION pos,
BOOL bByShow = FALSE);
Parametri
[in] Pos
[in] bByShow
Osservazioni:
CDockSite::OnResizeRow
virtual int OnResizeRow(
CDockingPanesRow* pRowToResize,
int nOffset);
Parametri
[in] pRowToResize
[in] nOffset
Valore restituito
Osservazioni:
CDockSite::OnSizeParent
virtual void OnSizeParent(
CRect& rectAvailable,
UINT nSide,
BOOL bExpand,
int nOffset);
Parametri
[in] rectAvailable
[in] nSide
[in] bExpand
[in] nOffset
Osservazioni:
CDockSite::OnSetWindowPos
virtual BOOL OnSetWindowPos(
const CWnd* pWndInsertAfter,
const CRect& rectWnd,
UINT nFlags);
Parametri
[in] pWndInsertAfter
[in] rectWnd
[in] nFlags
Valore restituito
Osservazioni:
CDockSite::OnShowRow
virtual void OnShowRow(
POSITION pos,
BOOL bShow);
Parametri
[in] Pos
[in] bShow
Osservazioni:
CDockSite::P aneFromPoint
Restituisce un riquadro ancorato nel sito di ancoraggio nel punto definito dal parametro specificato.
virtual CPane* PaneFromPoint(CPoint pt);
Parametri
pt
[in] Punto, nelle coordinate dello schermo, per il recupero del riquadro.
Valore restituito
Puntatore al riquadro che si trova nel punto specificato o NULL se non è presente alcun riquadro nel punto specificato.
Osservazioni:
CDockSite::RectSideFromPoint
static int __stdcall RectSideFromPoint(
const CRect& rect,
const CPoint& point);
Parametri
[in] rect
[in] punto
Valore restituito
Osservazioni:
CDockSite::RemovePane
virtual void RemovePane(
CPane* pWnd,
AFX_DOCK_METHOD dockMethod);
Parametri
[in] pWnd
[in] dockMethod
Osservazioni:
CDockSite::RemoveRow
void RemoveRow(CDockingPanesRow* pRow);
Parametri
[in] prua
Osservazioni:
CDockSite::ReplacePane
BOOL ReplacePane(
CPane* pOldBar,
CPane* pNewBar);
Parametri
[in] pOldBar
[in] pNewBar
Valore restituito
Osservazioni:
CDockSite::RepositionPanes
virtual void RepositionPanes(CRect& rectNewClientArea);
Parametri
[in] rectNewClientArea
Osservazioni:
CDockSite::ResizeDockSite
void ResizeDockSite(
int nNewWidth,
int nNewHeight);
Parametri
[in] nNewWidth
[in] nNewHeight
Osservazioni:
CDockSite::ResizeRow
int ResizeRow(
CDockingPanesRow* pRow,
int nNewSize,
BOOL bAdjustLayout = TRUE);
Parametri
[in] prua
[in] nNewSize
[in] bAdjustLayout
Valore restituito
Osservazioni:
CDockSite::ShowPane
Mostra il riquadro.
virtual BOOL ShowPane(
CBasePane* pBar,
BOOL bShow,
BOOL bDelay,
BOOL bActivate);
Parametri
pBar
[in, out] Puntatore al riquadro da visualizzare o nascondere.
bShow
[in] TRUE per specificare che il riquadro deve essere visualizzato; FALSE per specificare che il riquadro deve essere nascosto.
bDelay
[in] TRUE per specificare che il layout del riquadro deve essere ritardato fino a quando non viene visualizzato il riquadro; in caso contrario, FALSE.
bActivate
[in] Questo parametro non viene usato.
Valore restituito
TRUE se il riquadro è stato visualizzato o nascosto correttamente. FALSE se il riquadro specificato non appartiene a questo sito dock.
Osservazioni:
Chiamare questo metodo per visualizzare o nascondere i riquadri ancorati. In genere, non è necessario chiamare CDockSite::ShowPane direttamente, perché viene chiamato dalla finestra cornice padre o dal riquadro di base.
CDockSite::ShowRow
void ShowRow(
CDockingPanesRow* pRow,
BOOL bShow,
BOOL bAdjustLayout);
Parametri
[in] prua
[in] bShow
[in] bAdjustLayout
Osservazioni:
CDockSite::SwapRows
void SwapRows(
CDockingPanesRow* pFirstRow,
CDockingPanesRow* pSecondRow);
Parametri
[in] pFirstRow
[in] pSecondRow