对话框与窗口

开发平台：
Visual C++

XTSplitterWnd.h：源码内容
							// XTSplitterWnd.h : header file
//
// This file is a part of the XTREME CONTROLS MFC class library.
// (c)1998-2008 Codejock Software, All Rights Reserved.
//
// THIS SOURCE FILE IS THE PROPERTY OF CODEJOCK SOFTWARE AND IS NOT TO BE
// RE-DISTRIBUTED BY ANY MEANS WHATSOEVER WITHOUT THE EXPRESSED WRITTEN
// CONSENT OF CODEJOCK SOFTWARE.
//
// THIS SOURCE CODE CAN ONLY BE USED UNDER THE TERMS AND CONDITIONS OUTLINED
// IN THE XTREME TOOLKIT PRO LICENSE AGREEMENT. CODEJOCK SOFTWARE GRANTS TO
// YOU (ONE SOFTWARE DEVELOPER) THE LIMITED RIGHT TO USE THIS SOFTWARE ON A
// SINGLE COMPUTER.
//
// CONTACT INFORMATION:
// support@codejock.com
// http://www.codejock.com
//
/////////////////////////////////////////////////////////////////////////////
//{{AFX_CODEJOCK_PRIVATE
#if !defined(__XTSPLITTERWND_H__)
#define __XTSPLITTERWND_H__
//}}AFX_CODEJOCK_PRIVATE
#if _MSC_VER > 1000
#pragma once
#endif // _MSC_VER > 1000
class CXTSplitterWndTheme;
#include "XTThemeManager.h"
// --------------------------------------------------------------------
// Summary:
//     CXTSplitterWnd is a CSplitterWnd derived class. It
//     adds the ability to hide and show splitter panes based upon its
//     index.
// --------------------------------------------------------------------
class _XTP_EXT_CLASS CXTSplitterWnd : public CSplitterWnd, public CXTThemeManagerStyleHostBase
{
	DECLARE_DYNAMIC(CXTSplitterWnd)
	DECLARE_THEME_HOST(CXTSplitterWnd)
	DECLARE_THEME_REFRESH(CXTSplitterWnd)
public:
	// ---------------------------------------------
	// Summary:
	//     Constructs a CXTSplitterWnd object
	// ---------------------------------------------
	CXTSplitterWnd();
	// ----------------------------------------------------------------
	// Summary:
	//     Destroys a CXTSplitterWnd object, handles cleanup and
	//     deallocation
	// ----------------------------------------------------------------
	virtual ~CXTSplitterWnd();
public:
	//-----------------------------------------------------------------------
	// Summary:
	//     This member function is called to show the column that was previously
	//     hidden.
	// See Also:
	//     HideColumn
	//-----------------------------------------------------------------------
	virtual void ShowColumn();
	//-----------------------------------------------------------------------
	// Summary:
	//     This member function will hide a column based upon its index.
	// Parameters:
	//     nColHide -  Index of the column to hide.
	// See Also:
	//     ShowColumn
	//-----------------------------------------------------------------------
	virtual void HideColumn(int nColHide);
	//-----------------------------------------------------------------------
	// Summary:
	//     This member function is called to show the row that was previously
	//     hidden.
	// See Also:
	//     HideRow
	//-----------------------------------------------------------------------
	virtual void ShowRow();
	//-----------------------------------------------------------------------
	// Summary:
	//     This member function will hide a row based upon its index.
	// Parameters:
	//     nRowHide -  Index of the row to hide.
	// See Also:
	//     ShowRow
	//-----------------------------------------------------------------------
	virtual void HideRow(int nRowHide);
	//-----------------------------------------------------------------------
	// Summary:
	//     This member function is called to switch, or swap, a splitter view
	//     with another.
	// Parameters:
	//     nRow -      Specifies a row.
	//     nCol -      Specifies a column.
	//     pNewView -  Specifies the view to switch the specified pane with.
	// Returns:
	//     TRUE if successful, otherwise returns FALSE.
	// See Also:
	//     ReplaceView
	//-----------------------------------------------------------------------
	virtual BOOL SwitchView(int nRow, int nCol, CView* pNewView);
	//-----------------------------------------------------------------------
	// Summary:
	//     This member function is called to replace an existing splitter view
	//     with another.
	// Parameters:
	//     nRow -        Specifies a row.
	//     nCol -        Specifies a column.
	//     pViewClass -  Specifies the runtime class to replace the specified pane with.
	//     pNewView -    Points to an already existing view.
	// Returns:
	//     A CView pointer to the view that was replaced, otherwise returns NULL.
	// See Also:
	//     SwitchView
	//-----------------------------------------------------------------------
	virtual CView* ReplaceView(int nRow, int nCol, CView* pNewView);
	virtual CView* ReplaceView(int nRow, int nCol, CRuntimeClass* pViewClass); //<COMBINE CXTSplitterWnd::ReplaceView@int@int@CView*>
	// -------------------------------------------------------------------------------
	// Summary:
	//     Call this member function to modify a splitter window's style.
	//     Styles to be added or removed can be combined by using the bitwise
	//     OR (|) operator.
	// Parameters:
	//     dwxStyle -  Specifies XT_SPLIT_ styles to be added during style
	//                 modification. See the Remarks section for a list of styles.
	// Remarks:
	//     The splitter window can be modified to use one or more of the
	//     following styles:
	//     * <b>XT_SPLIT_DOTTRACKER</b> The splitter window will use a
	//       dotted tracker rather than the splitter default.
	//     * <b>XT_SPLIT_NOFULLDRAG</b> Disable the "Show window contents
	//       while dragging" option even if it is set in Windows.
	//     * <b>XT_SPLIT_NOBORDER</b> The splitter window will not draw a
	//       border around the pane.
	//     * <b>XT_SPLIT_NOSIZE</b> Do not allow splitter window panes to
	//       be resized.
	// See Also:
	//     GetSplitterStyle
	// -------------------------------------------------------------------------------
	virtual void SetSplitterStyle(DWORD dwxStyle);
	//-----------------------------------------------------------------------
	// Summary:
	//     Call this method to set full drag state.
	// Parameters:
	//     bFullDrag -  TRUE to enable full drag.
	// Remarks:
	//     This member function will display the contents for child pane
	//     while the splitter is resized if bFullDrag is set to TRUE.
	// See Also:
	//     SetSplitterStyle
	//-----------------------------------------------------------------------
	void SetFullDrag(BOOL bFullDrag);
	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to return the current style for the splitter
	//     window.
	// Returns:
	//     The current style of the splitter window.
	// See Also:
	//     SetSplitterStyle
	//-----------------------------------------------------------------------
	virtual DWORD GetSplitterStyle();
	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to enable or disable flat splitters.
	// Parameters:
	//     bFlatSplitter -  TRUE to enable flat splitters.
	// See Also:
	//     SetSplitterStyle
	//-----------------------------------------------------------------------
	virtual void EnableFlatLook(BOOL bFlatSplitter);
	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to return the index of the column that is
	//     currently hidden.
	// Returns:
	//     The index of the hidden column or -1 if no columns are hidden.
	// See Also:
	//     GetHiddenRowIndex
	//-----------------------------------------------------------------------
	int GetHiddenColIndex();
	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to return the index of the row that is
	//     currently hidden.
	// Returns:
	//     The index of the hidden row; or -1, if no rows are hidden.
	// See Also:
	//     GetHiddenColIndex
	//-----------------------------------------------------------------------
	int GetHiddenRowIndex();
	//-----------------------------------------------------------------------
	// Summary:
	//     Sets a pane to be the active one in the frame.
	// Remarks:
	//     This member function is called by the framework to set a pane as
	//     active when the user changes the focus to a pane within the frame
	//     window. You may explicitly call SetActivePane to change the focus
	//     to the specified view.<p/>
	//
	//     Specify pane by providing either row and column, or by providing
	//     <i>pWnd</i>.
	// Parameters:
	//     row  -  If pWnd is NULL, specifies the row in the pane that will
	//             be active.
	//     col  -  If pWnd is NULL, specifies the column in the pane that
	//             will be active.
	//     pWnd -  A pointer to a CWnd object. If NULL, the pane specified
	//             by row and col is set active.  If not NULL, specifies the
	//             pane that is set active.
	// See Also:
	//     CSplitterWnd::GetActivePane, CSplitterWnd::GetPane, CFrameWnd::SetActiveView
	//-----------------------------------------------------------------------
	virtual void SetActivePane(int row, int col, CWnd* pWnd = NULL);
protected:
//{{AFX_CODEJOCK_PRIVATE
	DECLARE_MESSAGE_MAP()
	//{{AFX_VIRTUAL(CXTSplitterWnd)
	virtual void SetSplitCursor(int ht);
	virtual void OnInvertTracker(const CRect& rect);
	virtual void StartTracking(int ht);
	virtual void StopTracking(BOOL bAccept);
	virtual void DrawTracker(const CRect& rect, CBrush* pBrush);
	virtual void OnDrawSplitter(CDC* pDC, ESplitType nType, const CRect& rectArg);
	//}}AFX_VIRTUAL
	//{{AFX_MSG(CXTSplitterWnd)
	afx_msg void OnSettingChange(UINT uFlags, LPCTSTR lpszSection);
	afx_msg void OnMouseMove(UINT nFlags, CPoint point);
	afx_msg LRESULT OnNcHitTest(CPoint point);
	afx_msg void OnLButtonUp(UINT nFlags, CPoint point);
	afx_msg LRESULT OnPrintClient(WPARAM wParam, LPARAM /*lParam*/);
	//}}AFX_MSG
//}}AFX_CODEJOCK_PRIVATE
protected:
	int     m_nHiddenCol;       // Index of the hidden column.
	int     m_nHiddenRow;       // Index of the hidden row.
	BOOL    m_bFullDrag;        // TRUE if full window dragging is enabled.
	BOOL    m_bForceFullDrag;   // TRUE to use full drag always.
	BOOL    m_bFlatSplit;       // TRUE if the flat splitter style is used.
	DWORD   m_dwxStyle;         // The style of the splitter window. See SetSplitterStyle(...).
	CPoint  m_point;            // Previous cursor position.
	BOOL    m_bClipStyles;      // Clip styles before dragging.
};
//////////////////////////////////////////////////////////////////////
AFX_INLINE DWORD CXTSplitterWnd::GetSplitterStyle() {
	return m_dwxStyle;
}
AFX_INLINE int CXTSplitterWnd::GetHiddenColIndex() {
	return m_nHiddenCol;
}
AFX_INLINE int CXTSplitterWnd::GetHiddenRowIndex() {
	return m_nHiddenRow;
}
// ---------------------------------------------------------------------
// Summary:
//     CXTSplitterWndEx is a CXTSplitterWnd derived class.
//     It can be used with the CXTOutBarCtrl to display a gap
//     between the top of the splitter and the toolbar area.
// ---------------------------------------------------------------------
class _XTP_EXT_CLASS CXTSplitterWndEx : public CXTSplitterWnd
{
	DECLARE_DYNAMIC(CXTSplitterWndEx)
public:
	// -----------------------------------------------
	// Summary:
	//     Constructs a CXTSplitterWndEx object
	// -----------------------------------------------
	CXTSplitterWndEx();
	// ------------------------------------------------------------------
	// Summary:
	//     Destroys a CXTSplitterWndEx object, handles cleanup and
	//     deallocation
	// ------------------------------------------------------------------
	virtual ~CXTSplitterWndEx();
public:
	// ------------------------------------------------------------------------------
	// Summary:
	//     Call this member function to show a top border for the splitter
	//     window, similar to Outlook. Enabled by default.
	// Parameters:
	//     bShowTopBorder -  Call this member function to show a top border for the
	//                       splitter window, similar to Outlook. Enabled by default.
	//     cyTopBorderGap -  Call this member function to show a top border for the
	//                       splitter window, similar to Outlook. Enabled by default.
	// ------------------------------------------------------------------------------
	virtual void ShowTopBorder(bool bShowTopBorder = true, int cyTopBorderGap = 7);
protected:
	// -------------------------
	// Summary:
	//     Called to retrieve the client area minus the inside 3D borders.
	// Remarks:
	//     This member function is called by the splitter window to retrieve the
	//     size of the client area minus any 3D borders.
	// Parameters:
	//     rect -  Size of the client area minus borders.
	// -------------------------
	virtual void GetInsideRect(CRect& rect) const;
public:
	// -----------------
	// Summary:
	//     Call to redisplay the splitter window after adjusting row or column size.
	// Remarks:
	//     Call this member function to correctly redisplay the splitter window
	//     after you have adjusted row and column sizes with the SetRowInfo and
	//     SetColumnInfo member functions. If you change row and column sizes as
	//     part of the creation process before the splitter window is visible,
	//     it is not necessary to call this member function.<p/>
	//
	//     The framework calls this member function whenever the user resizes
	//     the splitter window or moves a split.
	// Example:
	//     See the example for CSplitterWnd::SetColumnInfo.
	// -----------------
	virtual void RecalcLayout();
	// ----------------------------
	// Summary:
	//     Renders an image of a split window.
	// Parameters:
	//     pDC     -  A pointer to the device context in which to draw. If pDC is NULL,
	//                then CWnd::RedrawWindow is called by the framework and no split
	//                window is drawn.
	//     nType   -  A value of the enum ESplitType. See remarks section for a list
	//                of values.
	//     rectArg -  A reference to a CRect object specifying the size and shape of
	//                the split windows.
	// Remarks:
	//     <i>nType</i> can be one of the following values:<p/>
	//
	//     * <b>splitBox</b>          The splitter drag box.
	//     * <b>splitBar</b>          The bar that appears between the two split windows.
	//     * <b>splitIntersection</b> The intersection of the split windows. This element
	//                                will not be called when running on Windows 95.
	//     * <b>splitBorder</b>       The split window borders.
	//
	//     This member function is called by the framework to draw and specify
	//     the exact characteristics of a splitter window.<p/>
	//
	//     Override OnDrawSplitter for advanced customization of the imagery for the
	//     various graphical components of a splitter window. The default imagery is
	//     similar to the splitter in Microsoft Works for Windows or Microsoft Windows
	//     95, in that the intersections of the splitter bars are blended together.<p/>
	//
	//     For more on dynamic splitter windows, see "Splitter Windows" in the
	//     articleMultiple Document Types, Views, and Frame Windows in Visual C++
	//     Programmer's Guide, Technical Note 29, and the CSplitterWnd class overview.
	// See Also:
	//      CSplitterWnd::OnInvertTracker
	// ----------------------------
	virtual void OnDrawSplitter(CDC* pDC, ESplitType nType, const CRect& rectArg);
private:
	static void AFX_CDECL DeferClientPos(AFX_SIZEPARENTPARAMS* lpLayout,
		CWnd* pWnd, int x, int y, int cx, int cy, BOOL bScrollBar);
	static  void AFX_CDECL LayoutRowCol(CSplitterWnd::CRowColInfo* pInfoArray,
		int nMax, int nSize, int nSizeSplitter);
protected:
//{{AFX_CODEJOCK_PRIVATE
	DECLARE_MESSAGE_MAP()
	//{{AFX_MSG(CXTSplitterWndEx)
	afx_msg void OnPaint();
	afx_msg BOOL OnEraseBkgnd(CDC* pDC);
	//}}AFX_MSG
//}}AFX_CODEJOCK_PRIVATE
protected:
	int  m_cyTopBorderGap; // Size in pixels of the top border.
	bool m_bShowTopBorder; // true to draw a top border line.
};
//////////////////////////////////////////////////////////////////////
AFX_INLINE void CXTSplitterWndEx::ShowTopBorder(bool bShowTopBorder, int cyTopBorderGap) {
	m_bShowTopBorder = bShowTopBorder; m_cyTopBorderGap = cyTopBorderGap;
}
const DWORD XT_SPLIT_DOTTRACKER    = 0x0001; //<ALIAS CXTSplitterWnd::SetSplitterStyle@DWORD>
const DWORD XT_SPLIT_NOFULLDRAG    = 0x0002; //<ALIAS CXTSplitterWnd::SetSplitterStyle@DWORD>
const DWORD XT_SPLIT_NOBORDER      = 0x0004; //<ALIAS CXTSplitterWnd::SetSplitterStyle@DWORD>
const DWORD XT_SPLIT_NOSIZE        = 0x0008; //<ALIAS CXTSplitterWnd::SetSplitterStyle@DWORD>
#endif // !defined(__XTSPLITTERWND_H__)

						