/********************************************
** 工作室：S&P工作室
** 作者	 ：张东斌
** 日期  ：2007年6月
*********************************************/
#if !defined(__SPPROPERTYGRID_H__)
#define __SPPROPERTYGRID_H__
//}}AFX_CODEJOCK_PRIVATE

#if _MSC_VER > 1000
#pragma once
#endif // _MSC_VER > 1000

#include "SPPropertyGridPaintManager.h"
#include "SPDrawHelpers.h"

//-----------------------------------------------------------------------
// Summary:
//     SPPropertyGridSortOrder is an enumeration used by CSPPropertyGrid to
//     determine the grouping style.  This will specify how the items
//     in the grid are displayed, I.e. Alphabetical, not sort, and
//     grouped by category.
// See Also: CSPPropertyGrid::SetPropertySort, CSPPropertyGrid::GetPropertySort
// Example:
//     <code>SPPropertyGridSortOrder sort = m_wndPropertyGrid.GetPropertySort();</code>
//
// <KEYWORDS SPGridSortCategorized, SPGridSortAlphabetical, SPGridSortNoSort>
//-----------------------------------------------------------------------
enum SPPropertyGridSortOrder
{
	SPGridSortCategorized , 	// Group items by category.
	SPGridSortAlphabetical ,	// Sort items alphabetically.
	SPGridSortNoSort		   // Disable sorting and grouping, all items are displayed in
	// the order that they are added to the grid.
};

#include "SPPropertyGridView.h"

class	CSPPropertyGridView;
class	CSPPropertyGridPaintManager;
class	CSPPropertyGrid;


//===========================================================================
// Summary:
//     CSPPropertyGridUpdateContext is a CCmdTarget derived class used
//     to save the state of the property grid such as the currently
//     selected item, SPPropertyGridSortOrder preference, and the expanding state
//     of each item in the grid.  The property grid state information is
//     stored in the CSPPropertyGridUpdateContext object when
//     CSPPropertyGrid::BeginUpdate is called and after CSPPropertyGrid::EndUpdate
//     the expanding state of each item, selected item, and sort preference
//     will be restored.
// Remarks:
//     Each time you add a new item or category to the grid, The state
//     of the grid is updated the grid is redrawn.
//
//     If you want to delete all items in the grid and then add allot of
//     new items it will be quite slow. To do this, you would call
//     BeginUpdate, then delete all the items.  The property grid will be
//     locked until you call EndUpdate.
//
//     It might be useful to call BeginWaitCursor to indicate that the
//     grid is "busy" updating.
// See Also: CSPPropertyGrid::BeginUpdate, CSPPropertyGrid::EndUpdate
//===========================================================================
class CSPPropertyGridUpdateContext : public CCmdTarget
{
public:

	//-----------------------------------------------------------------------
	// Summary:
	//     Constructs a CSPPropertyGridUpdateContext object.
	//-----------------------------------------------------------------------
									CSPPropertyGridUpdateContext();

public:

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to determine if any items in the grid were
	//     expanded before CSPPropertyGrid::BeginUpdate was called.
	//     Only items with children can be expanded.
	// Returns:
	//     TRUE if no items were expanded before BeginUpdate, FALSE if
	//     at least one item was expanded.
	//-----------------------------------------------------------------------
	BOOL							IsEmpty();

protected:
	CMap< UINT, UINT, BOOL, BOOL&  >m_mapState;   // Stores the expanded state of each item in the grid before CSPPropertyGrid::BeginUpdate.
	UINT							m_nSelected;						   // Stores the Id of the currently selected item before CSPPropertyGrid::BeginUpdate.
	SPPropertyGridSortOrder			m_propertySort;    // Stores the currently used sort method of the grid before CSPPropertyGrid::BeginUpdate.


	friend class					CSPPropertyGrid;
};

//===========================================================================
// Summary:
//     CSPPropertyGridToolBar is a CToolBar derived class.
//     It is an internal class used by Property Grid control
//===========================================================================
class  CSPPropertyGridToolBar : public CToolBar
{
public:

	//-----------------------------------------------------------------------
	// Summary:
	//     Constructs a CSPPropertyGridToolBar object
	//-----------------------------------------------------------------------
			CSPPropertyGridToolBar();

protected:

	//{{AFX_CODEJOCK_PRIVATE
		//{{AFX_VIRTUAL(CSPPropertyGridToolBar)
		virtual void OnUpdateCmdUI(CFrameWnd* pTarget, BOOL bDisableIfNoHndler);
		//}}AFX_VIRTUAL


		//{{AFX_MSG(CSPPropertyGridToolBar)
		afx_msg BOOL OnEraseBkgnd(CDC*);
		afx_msg void OnNcCalcSize(BOOL bCalcValidRects, NCCALCSIZE_PARAMS* lpncsp);
		afx_msg void OnPaint();
		//}}AFX_MSG

		DECLARE_MESSAGE_MAP()
//}}AFX_CODEJOCK_PRIVATE
};

class	CSPPropertyGridVerbs;


//===========================================================================
// Summary:
//     CSPPropertyGridVerb is used to create a verb link similar to what is seen
//     in Visual Studio .NET.  For example, when the DataGrid control is selected at
//     design time in VS .NET, an AutoFormat link button appears in the Properties window
//     just below the property grid and above the help panel.
//     Verbs will be displayed in a separate panel just below the property grid.  Verbs
//     are links that can be used to perform actions in your application.  When a verb is
//     clicked, CSPPropertyGrid::OnVerbClick is called by the framework.
//     If both the verb panel and help panel are visible at the same time, the verb panel
//     is displayed above the help panel.
// See Also: CSPPropertyGrid::GetVerbs, CSPPropertyGridVerbs
//===========================================================================
class  CSPPropertyGridVerb : public CCmdTarget
{
public:
	//-----------------------------------------------------------------------
	// Summary:
	//     Constructs a CSPPropertyGridVerb object.
	//-----------------------------------------------------------------------
							CSPPropertyGridVerb();

public:

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to retrieve the text caption of this verb link.
	// Returns:
	//     Text caption of this verb link.
	//-----------------------------------------------------------------------
	CString					GetCaption();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to retrieve the Id assigned to this verb link.
	// Returns:
	//     The Id of this verb link.
	//-----------------------------------------------------------------------
	int						GetID();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to retrieve the Index of this verb link within the
	//     collection of verbs.
	// Returns:
	//     Index of this verb within the collection of verb links.
	//-----------------------------------------------------------------------
	int						GetIndex();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to determine if this verb link is currently focused.
	//     If focused, a focus rectangle is placed around the text caption of the verb.
	// Returns:
	//     TRUE if this verb is currently focused, FALSE if this verb is not focused.
	//-----------------------------------------------------------------------
	BOOL					IsFocused();

	//-----------------------------------------------------------------------
	// Summary:
	//     Used internally by PaintManager and PropertyGrid to set the
	//     bounding rectangle for verbs.  You do not need to call
	//     this member.
	// Parameters:
	//     rc - Bounding rectangle containing the verb text.
	//-----------------------------------------------------------------------
	void					SetPart( CRect rc );

	//-----------------------------------------------------------------------
	// Summary:
	//     Used internally by PaintManager and PropertyGrid to get the
	//     bounding rectangle for verbs.  You do not need to call
	//     this member.
	// Returns:
	//     Bounding rectangle of verb.
	//-----------------------------------------------------------------------
	CRect					GetPart();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to retrieve the last position that the user
	//     clicked.
	// Returns:
	//     Retrieves the last position the user clicked. If it was "clicked"
	//     by pressing the Enter key while a verb has focus, then the
	//     BottomLeft position of the "clicked" Verb is returned.
	//-----------------------------------------------------------------------
	CPoint					GetClickPoint();

protected:
	CString					m_strCaption;   			// Text caption of this verb link.
	int						m_nID;  						// Id assigned this verb link.
	int						m_nIndex;   					// Index of this verb link in the collection of verbs.
	CRect					m_rcPart;   				  // Bounding rectangle of verb.
	CPoint					m_ptClick;  				 // The last position the user clicked.
	CSPPropertyGridVerbs *	m_pVerbs;    // Collection of verb links.

	friend class			CSPPropertyGridVerbs;
	friend class			CSPPropertyGrid;
};



//===========================================================================
// Summary:
//     A collection of CSPPropertyGridVerb objects that are displayed in the
//     verb panel.  See CSPPropertyGridVerb for a description of verbs.
// See Also: CSPPropertyGridVerb
//===========================================================================
class  CSPPropertyGridVerbs : public CCmdTarget
{
public:

	//-------------------------------------------------------------------------
	// Summary:
	//     Constructs a CSPPropertyGridVerbs object.
	//-------------------------------------------------------------------------
														CSPPropertyGridVerbs();

	//-------------------------------------------------------------------------
	// Summary:
	//     Destroys a CSPPropertyGridVerbs object, handles cleanup and deallocation.
	//-------------------------------------------------------------------------
														~CSPPropertyGridVerbs();

public:

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to determine if any verbs have been added to the
	//     collection of verbs.
	// Returns:
	//     TRUE if there are no verbs in the collection, FALSE if there is at
	//     least one verb in the collection.
	//-----------------------------------------------------------------------
	BOOL												IsEmpty();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to remove all verbs from the collection of verbs.
	//-----------------------------------------------------------------------
	void												RemoveAll();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to get a pointer to a specific verb in the collection
	//     of verbs.
	// Parameters:
	//     nIndex - Index of the verb withing the collection of verbs.
	// Returns:
	//     Verb at the specified location in the collection of verbs.
	//-----------------------------------------------------------------------
	CSPPropertyGridVerb *								GetAt( int nIndex );

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to retrieve the total number of verb links in the
	//     collection of verbs.
	// Returns:
	//     Total number of verbs in the collection of verbs.
	//-----------------------------------------------------------------------
	int													GetCount();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to add a verb link to the verb panel.
	// Parameters:
	//     strCaption - Text caption of the verb link.
	//     nID  	  - Id to assign to the new verb link.
	// Remarks:
	//     This will add a CSPPropertyGridVerb object to the collection of
	//     verbs.  Verbs are displayed in the verb panel that is located just
	//     below the property grid and above the help panel.
	//-----------------------------------------------------------------------
	void												Add( LPCTSTR strCaption , UINT nID );

protected:
	CArray< CSPPropertyGridVerb*, CSPPropertyGridVerb * >															m_arrVerbs;    // Collection of verb links.
	CSPPropertyGrid *									m_pGrid;										  // Pointer to the property grid that the verbs are drawn on.

	friend class										CSPPropertyGrid;
	friend class										CSPPropertyGridVerb;
};

//-----------------------------------------------------------------------
// Summary:
//     SPPropertyGridUI is an enumeration used by CSPPropertyGrid
//     during navigation of the Property Grid, items, and verbs
//     that specifies which object should receive focus.
// Remarks:
//     After the Tab key or Shift+Tab key combinations are pressed,
//     focus will be given to the object specified in the SPPropertyGridUI
//     enumeration.  I.e. If SPGridUIViewNext is passed into
//     OnNaviagte when an item in the grid has focus, then the next
//     item will receive focus.
// See Also: CSPPropertyGrid::OnNavigate, CSPPropertyGrid::NavigateItems
//
// <KEYWORDS SPGridUIParentPrev, SPGridUIViewPrev, SPGridUIView, SPGridUIInplaceEdit, SPGridUIInplaceButton, SPGridUIViewNext, SPGridUIVerb, SPGridUIParentNext>
//-----------------------------------------------------------------------
enum SPPropertyGridUI
{
	SPGridUIParentPrev													= -2 ,  // Used to indicate that focus should be given to the previous object in the tab order.
	SPGridUIViewPrev													= -1 ,  // If m_bTabItems is TRUE, Used to indicate that focus should be given to the previous item in the grid.
	// This occurs when an item has focus and Shift+Tab is pressed.
	SPGridUIView														= 0 ,  // Used to indicate that focus should be given to the Property Grid.
	SPGridUIInplaceEdit													= 1 ,  // Used to indicate that the Tab key is pressed while in an in-place edit box has focus.
	SPGridUIInplaceButton												= 2 ,  // Used to indicate that the Tab key is pressed while an in-place button has focus.
	SPGridUIViewNext													= 3 ,  // If m_bTabItems is TRUE, Used to indicate that focus should be given to the next item in the grid.
	// This occurs when an item has focus and the Tab key is pressed.
	SPGridUIVerb														= 4 ,  // Used to indicate that the Tab key is pressed while in Verb has focus.
	SPGridUIParentNext													= 5 ,  // Used to indicate that focus should be given to the next object in the tab order.
};

//-----------------------------------------------------------------------
// Summary:
//     SPPropertyGridHitCode is an enumeration used by CSPPropertyGrid
//     to determine which part of the property grid is located at a
//     specific point. CSPPropertyGrid::HitTest is used to test
//     a point when the user clicks on the property grid.
// See Also:
//     CSPPropertyGrid::HitTest
// Example:
//     See CSPPropertyGrid::HitTest.
//
// <KEYWORDS SPGridHitError, SPGridHitHelpSplitter, SPGridHitVerbsSplitter, SPGridHitFirstVerb>
//-----------------------------------------------------------------------
enum SPPropertyGridHitCode
{
	SPGridHitError						= -1 ,   // Indicates that the help splitter, verb splitter
	// and verbs were not clicked.
	SPGridHitHelpSplitter				= 1 ,   // Indicates that the help splitter was clicked.
	SPGridHitVerbsSplitter				= 2 ,   // Indicates that the Verb splitter was clicked.
	SPGridHitFirstVerb					= 3 ,   // Determines if the item clicked upon is a verb.
};

//===========================================================================
// Summary:
//     CSPPropertyGrid is a CWnd derived class. It is used to create a property grid
//     control similar to the property window in VS.NET.
//     See the "PropertyGrid" demo for an example of its usage.
//===========================================================================
class  CSPPropertyGrid : public CWnd
{
									DECLARE_DYNAMIC( CSPPropertyGrid )

public:

	//-----------------------------------------------------------------------
	// Summary:
	//     Constructs a CSPPropertyGrid object
	//-----------------------------------------------------------------------
									CSPPropertyGrid();

	//-----------------------------------------------------------------------
	// Summary:
	//     Destroys a CSPPropertyGrid object, handles cleanup and deallocation
	//-----------------------------------------------------------------------
	virtual							~CSPPropertyGrid();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to create the Property Grid control.
	// Parameters:
	//     rect 	   - Size of the control.
	//     pParentWnd  - Parent of the control.
	//     nID  	   - Identifier of the Property Grid control.
	//     dwListStyle - List style of the items in the Property Grid.
	// Remarks:
	//     Available styles are listed below:
	//
	//  	   <p><b>LBS_OWNERDRAWFIXED</b> - The owner of the grid is
	//  		   responsible for drawing its contents; the items in the
	//  		   list box are the same height, should be used with
	//  		   LBS_NOINTEGRALHEIGHT.
	//  	   <p><b>LBS_OWNERDRAWVARIABLE</b> - The owner of the grid is
	//  		   responsible for drawing its contents; the items
	//  		   in the grid are variable in height, should be used with
	//  		   LBS_NOINTEGRALHEIGHT
	//  	   <p><b>SP_PGS_OWNERDRAW</b> - Apply this style to the property
	//  		   grid to use the owner draw feature. Catch SP_PGN_DRAWITEM
	//  		   to draw item. Recommended to use custom Paint Manager
	//  		   instead. (SetCustomTheme)
	// Returns:
	//     TRUE if successful, otherwise returns FALSE.
	// See Also: SetCustomTheme, SetTheme
	//-----------------------------------------------------------------------
	virtual BOOL					Create( const RECT & rect , CWnd * pParentWnd , UINT nID , DWORD dwListStyle = LBS_OWNERDRAWFIXED | LBS_NOINTEGRALHEIGHT );

public:

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to add a new category to the Property Grid control.
	// Parameters:
	//     strCaption - Name of the category to add.
	// Parameters:
	//     nID - Identifier of new category.
	// Returns:
	//     The pointer to the item object of the newly inserted category.
	//-----------------------------------------------------------------------
	CSPPropertyGridItem *			AddCategory( CString strCaption );
	CSPPropertyGridItem *			AddCategory( int nID );//<COMBINE CSPPropertyGrid::AddCategory@CString>

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to insert a new category to the Property Grid control.
	// Parameters:
	//     strCaption - Name of the category to add.
	// Parameters:
	//     nID    - Identifier of new category.
	//     nIndex - Index of category to be inserted
	// Returns:
	//     The pointer to the item object of the newly inserted category.
	//-----------------------------------------------------------------------
	CSPPropertyGridItem *			InsertCategory( int nIndex , CString strCaption );
	CSPPropertyGridItem *			InsertCategory( int nIndex , int nID );//<COMBINE CSPPropertyGrid::InsertCategory@int@CString>

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to modify the way items are grouped.
	// Parameters:
	//     sort - style of grouping. Can be any of the values listed in the Remarks section.
	// Remarks:
	//     sort parameter can be one of the following:
	//     * <b>SPGridSortCategorized</b> Group items by category.
	//     * <b>SPGridSortAlphabetical</b> Sort items alphabetically.
	//     * <b>SPGridSortNoSort</b> Disable sorting.
	// See Also: GetPropertySort
	//-----------------------------------------------------------------------
	void							SetPropertySort( SPPropertyGridSortOrder sort );

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to get the current grouping style for
	//     the Property Grid control.
	// Returns:
	//     An SPPropertyGridSortOrder value representing the current grouping style.
	// See Also: SetPropertySort
	//-----------------------------------------------------------------------
	SPPropertyGridSortOrder			GetPropertySort();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to show or hide the toolbar control
	//     in the Property Grid window.
	// Parameters:
	//     bShow - TRUE to show the toolbar control, or FALSE to hide it.
	//-----------------------------------------------------------------------
	void							ShowToolBar( BOOL bShow = TRUE );

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to show or hide the description pane
	//     in the Property Grid window.
	// Parameters:
	//     bShow - TRUE to show the description pane, or FALSE to hide it.
	//-----------------------------------------------------------------------
	void							ShowHelp( BOOL bShow = TRUE );

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to set the custom colors of the Property
	//     Grid control.
	// Parameters:
	//     clrHelpBack - An RGB value that represents the background color
	//  				 the of description pane.
	//     clrHelpFore - An RGB value that represents the text color of
	//  				 the description pane.
	//     clrViewLine - An RGB value that represents the color of separating
	//  				 lines in control.
	//     clrViewBack - An RGB value that represents the background color
	//  				 of the Property Grid control.
	//     clrViewFore - An RGB value that represents the text color of
	//  				 the Property Grid control.
	//     clrCategoryFore - An RGB value that represents the text color of
	//  				 the Category item text.
	//-----------------------------------------------------------------------
	void							SetCustomColors( COLORREF clrHelpBack , COLORREF clrHelpFore , COLORREF clrViewLine , COLORREF clrViewBack , COLORREF clrViewFore , COLORREF clrCategoryFore = ::GetSysColor( COLOR_GRAYTEXT ) );

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to set the default colors of the Property
	//     Grid control.
	//-----------------------------------------------------------------------
	void							SetStandardColors();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to find an item.
	// Parameters:
	//     strCaption - Caption for the item to find.
	//     nID  	  - Identifier for the item to find.
	// Returns:
	//     The pointer to the CSPPropertyGridItem object.
	//-----------------------------------------------------------------------
	CSPPropertyGridItem *			FindItem( CString strCaption );
	CSPPropertyGridItem *			FindItem( UINT nID ); // <COMBINE CSPPropertyGrid::FindItem@CString>

	//-----------------------------------------------------------------------
	// Summary:
	//     Removes all items from the list box of a property grid control.
	//-----------------------------------------------------------------------
	void							ResetContent();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to determine if the help pane is visible.
	// Returns:
	//     TRUE if the help pane is visible, otherwise returns FALSE.
	//-----------------------------------------------------------------------
	BOOL							IsHelpVisible() const;

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to determine if the toolbar is visible.
	// Returns:
	//     TRUE if the toolbar is visible, otherwise returns FALSE.
	//-----------------------------------------------------------------------
	BOOL							IsBarVisible() const;

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to return the height of the help pane
	//     when it is visible.
	// Returns:
	//     An integer value that represents the height in pixels.
	//-----------------------------------------------------------------------
	int								GetHelpHeight() const;

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to return the background color for
	//     the property grid.
	// Returns:
	//     An RGB value.
	//-----------------------------------------------------------------------
	COLORREF						GetHelpBackColor();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to return the foreground color for
	//     the property grid.
	// Returns:
	//     An RGB value.
	//-----------------------------------------------------------------------
	COLORREF						GetHelpForeColor();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to return the categories of the property
	//     grid.
	// Returns:
	//     The pointer to the CSPPropertyGridItems object that represents
	//     collection of the categories.
	//-----------------------------------------------------------------------
	CSPPropertyGridItems *			GetCategories();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to return a pointer to the collection of verbs that
	//     are displayed in the verb panel.
	// Returns:
	//     The pointer to the CSPPropertyGridVerbs object that represents
	//     the collection of verbs.
	//-----------------------------------------------------------------------
	CSPPropertyGridVerbs *			GetVerbs();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this method to retrieve reference to the view object.
	// Returns:
	//     A CSPPropertyGridView object
	//-----------------------------------------------------------------------
	CSPPropertyGridView				&GetGridView();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this method to retrieve reference to the toolbar for the
	//     property grid.
	// Returns:
	//     A reference to a CToolBar object
	//-----------------------------------------------------------------------
	CToolBar						&GetToolBar();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to get selected item.
	// Returns:
	//     The pointer to the CSPPropertyGridItems object currently selected.
	//-----------------------------------------------------------------------
	CSPPropertyGridItem *			GetSelectedItem();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to set the height of the help pane
	//     when visible.
	// Parameters:
	//     nHeight - The integer value represents the height in pixels.
	//-----------------------------------------------------------------------
	void							SetHelpHeight( int nHeight );

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to set the divider position of the grid view.
	// Parameters:
	//     dDivider - A value between 0 and 1 that represents the location of the divider as
	//  			  a percentage from the left side of the view.  For example, if you wanted
	//  			  the divider to divide at 25% you would pass in .25.
	//-----------------------------------------------------------------------
	void							SetViewDivider( double dDivider );

	//-----------------------------------------------------------------------
	// Summary:
	//     This method sets the grid抯 current font to the specified font.
	// Parameters:
	//     pFont - Pointer to a CFont object.
	//-----------------------------------------------------------------------
	void							SetFont( CFont * pFont );

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to set the grid theme.
	// Parameters:
	//     paintTheme - theme of property grid. Can be one of the values
	//  				listed in the Remarks section.
	// Remarks:
	//     paintTheme can be one of the following values:
	//  	* <b>SPGridThemeDefault</b> Enables default theme.
	//  	* <b>SPGridThemeNativeWinXP</b> Enables WinXP style theme.
	//  	* <b>SPGridThemeOffice2003</b> Enables Office 2003 style theme.
	//  	* <b>SPGridThemeCool</b> Enables Cool theme.
	//  	* <b>SPGridThemeSimple</b> Enables Visual Basic style theme.
	//  	* <b>SPGridThemeDelphi</b> Enables Delphi style theme.
	//  	* <b>SPGridThemeWhidbey</b> Enables Visual Studio 2005 "Whidbey" style theme.
	//-----------------------------------------------------------------------
	void							SetTheme( SPPropertyGridPaintTheme paintTheme );

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this method to set custom theme of the grid.
	// Parameters:
	//     pPaintManager - Points to a CSPPropertyGridPaintManager object
	//-----------------------------------------------------------------------
	void							SetCustomTheme( CSPPropertyGridPaintManager * pPaintManager );

	//-----------------------------------------------------------------------
	// Summary:
	//     Retrieves current theme of the grid.
	//-----------------------------------------------------------------------
	SPPropertyGridPaintTheme		GetCurrentTheme();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this method to refresh items in the list.
	//-----------------------------------------------------------------------
	void							Refresh();

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to "lock" the property grid.  This
	//     should be called when adding or deleting a large number of item.
	// Parameters:
	//     context - Pointer to a CSPPropertyGridUpdateContext object.
	// Remarks:
	//     Each time you add a new item or category to the grid, The state
	//     of the grid is updated the grid is redrawn.
	//
	//  		 If you want to delete all items in the grid and then add allot of
	//  		 new items it will be quite slow. To do this, you would call
	//  		 BeginUpdate, then delete all the items.  The property grid will be
	//  		 locked until you call EndUpdate.
	//
	//  		 It might be useful to call BeginWaitCursor to indicate that the
	//  		 grid is "busy" updating.
	// See Also: EndUpdate, CSPPropertyGridUpdateContext
	//-----------------------------------------------------------------------
	void							BeginUpdate( CSPPropertyGridUpdateContext & context );

	//-----------------------------------------------------------------------
	// Summary:
	//     This member should be called after BeginUpdate.  You need to call
	//     EndUpdate to "unlock" the grid after you have finished adding
	//     and deleting a large amount of items.
	// Parameters:
	//     context - Pointer to a CSPPropertyGridUpdateContext object.
	// See Also: BeginUpdate, CSPPropertyGridUpdateContext
	//-----------------------------------------------------------------------
	void							EndUpdate( CSPPropertyGridUpdateContext & context );

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to determine if the verb panel is currently visible.
	// Returns:
	//     TRUE if the verb panel is visible, FALSE otherwise.
	// See Also: CSPPropertyGridVerb, CSPPropertyGridVerbs
	//-----------------------------------------------------------------------
	BOOL							IsVerbsVisible();

	//-----------------------------------------------------------------------
	// Summary:
	//     Returns the currently used control's Paint Manager.
	// Remarks:
	//     Call this member function to get the paint manager object used
	//     for drawing a property grid control window.
	// Returns:
	//     Pointer to the paint manager object.
	//-----------------------------------------------------------------------
	CSPPropertyGridPaintManager *	GetPaintManager();

	//-----------------------------------------------------------------------
	// Summary:
	//     Creates View of Property grid. Override this member to use custom view.
	//-----------------------------------------------------------------------
	virtual CSPPropertyGridView *	CreateView();

	//-----------------------------------------------------------------------
	// Summary:
	//     This member is called when a user clicks on a verb or when a
	//     verb has focus and the enter key is pressed.  Override this
	//     member to perform custom actions such as displaying a dialog.
	// Parameters:
	//     nIndex - Index of the verb within the collection of verbs.
	//     pt     - Point on the screen that the user clicked.  This
	//  			will the position of the mouse cursor over a verb.  This
	//  			point is stored in the CSPPropertyGridVerb::m_ptClick
	//  			member which is a CPoint object.  Coordinates will be
	//  			relative to the screen and not the client.
	//-----------------------------------------------------------------------
	virtual void					OnVerbClick( int nIndex , CPoint pt );

	//-----------------------------------------------------------------------
	// Summary:
	//     This member is called when items in the property grid are navigated
	//     using key on the keyboard.  This includes navigating the built in
	//     toolbar, verbs, and items in the property grid.
	// Parameters:
	//     nUIElement - Indicates which object should receive focus.
	//  				Members of SPPropertyGridUI are used to indicate
	//  				which object receives focus.
	//     bForward   - TRUE if the Tab key is pressed and items are being
	//  				navigated in the forward direction, FALSE if Shift+Tab
	//  				is pressed and items are navigated backwards.
	//  				TRUE if the Right or Down arrow is used to navigate the items.
	//  				FALSE if the Up or Left arrow is used to navigate the items.
	//     pItem	  - Pointer to the currently selected item.
	// See Also: SPPropertyGridUI
	//-----------------------------------------------------------------------
	virtual void					OnNavigate( SPPropertyGridUI nUIElement , BOOL bForward , CSPPropertyGridItem * pItem );

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this method to enable navigate items using Tab key.
	// Parameters:
	//     bTabItems - TRUE to navigate items in the grid using the tab key.
	//  	   When TRUE, focus will move in this order:
	//  	   Caption, Item Value, Item InPlaceButton (if used), Next item Caption
	//  	   FALSE not to navigate the items in the grid with the tab key.
	//-----------------------------------------------------------------------
	void							NavigateItems( BOOL bTabItems );

	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to specify the height of the verb box when visible.
	// Parameters:
	//     nHeight - Height of the verb box.
	// See Also: CSPPropertyGridVerb, CSPPropertyGridVerbs, IsVerbsVisible
	//-----------------------------------------------------------------------
	void							SetVerbsHeight( int nHeight );

protected:

	//-----------------------------------------------------------------------
	// Summary:
	//     This method is called by the framework during resizing of splitters.
	// Parameters:
	//     rc - Specifies the reference to a CRect object specifying
	//  		the tracking rectangle.
	//-----------------------------------------------------------------------
	void							OnInvertTracker( CRect rc );

	//-----------------------------------------------------------------------
	// Summary:
	//     This member is called to determine if the help splitter,
	//     verb splitter, or a verb was clicked upon.
	// Parameters:
	//     pt - A point to test.
	// Returns:
	//     The HitTest method returns the following values which specify which
	//     part of the property grid located under the coordinates specified
	//     by <i>pt</i>.
	//
	//     * <b>SPGridHitError</b> Indicates something else was clicked.
	//     * <b>SPGridHitHelpSplitter</b> Indicates the help splitter was clicked.
	//     * <b>SPGridHitVerbsSplitter</b> Indicates the verb splitter was clicked.
	//     * <b>SPGridHitFirstVerb</b> If the return value is greater than or
	//  		 equal to SPGridHitFirstVerb then the item clicked upon is
	//  		 a verb. You can retrieve the verb index by subtracting
	//  		 SPGridHitFirstVerb from the return value, for example:
	// <code>
	// int iHit = m_wndPropertyGrid.HitTest(pt);
	// if (iHit >= SPGridHitFirstVerb)
	// {
	//     // Get the index of the verb.
	//     m_iVerbIndex = (iHit-SPGridHitFirstVerb);
	// }
	// </code>
	// See Also:
	//     SPPropertyGridHitCode
	//-----------------------------------------------------------------------
	virtual int						HitTest( CPoint pt );

	//-----------------------------------------------------------------------
	// Summary:
	//     This member is called when a new item is selected in the
	//     grid.  Or focus switched from one item to a different item.
	// Parameters:
	//     pItem - Item that the selection has changed too.  This is the
	//  		   item that just received focus.
	// See Also: GetSelectedItem
	//-----------------------------------------------------------------------
	virtual void					OnSelectionChanged( CSPPropertyGridItem * pItem );

	//-------------------------------------------------------------------------
	// Summary:
	//     This member is called when the sort order has changed.
	// See Also: SetPropertySort
	//-------------------------------------------------------------------------
	virtual void					OnSortChanged();

	//-----------------------------------------------------------------------
	// Summary:
	//     This member is called to recalculate the position and size of the
	//     property grid, then it resizes the grid to the specified size.
	//     New size is 0,0,cx,cy.
	//     This is the area that hold the toolbar and grid, this does not
	//     include the area for the verb and help panel.
	// Parameters:
	//     cx - New bottom-right x coordinate of the grid's bounding rectangle.
	//     cy - New bottom-right y coordinate of the grid's bounding rectangle.
	//-----------------------------------------------------------------------
	virtual void					Reposition( int cx , int cy );

	//-------------------------------------------------------------------------
	// Summary:
	//     This member is called when the "built-in" toolbar is created.
	//-------------------------------------------------------------------------
	void							CreateToolbar();

	//-------------------------------------------------------------------------
	// Summary:
	//     This member is called when the toolbar buttons need to be redrawn.
	// Remarks:
	//     This occurs when the sort order has changed, and when the toolbar
	//     is shown.  Sort order can be changed by code or by clicking on
	//     a button in the toolbar.
	//-------------------------------------------------------------------------
	void							RefreshToolBarButtons();

	//-------------------------------------------------------------------------
	// Summary:
	//     This member is called when a Verb receives focus, and when focus
	//     switches from one verb to a different verb.
	//-------------------------------------------------------------------------
	void							OnVerbsChanged();

private:
	CWnd *							GetNextGridTabItem( BOOL bForward );
	void							RestoreExpandingState( CSPPropertyGridItems * pItems , CMap< UINT, UINT, BOOL, BOOL&  > * pState );
	void							SaveExpandingState( CSPPropertyGridItems * pItems , CMap< UINT, UINT, BOOL, BOOL&  > * pState , UINT & nSelected );



public:
	int								m_nHelpHeight;  			// Height of the description area (help panel).
	int								m_nVerbsHeight; 			// Height of the verbs panel.
	CSPPaintManagerColor			m_clrHelpBack;  			// Color of the description background.
	CSPPaintManagerColor			m_clrHelpFore;  			// Color of the description text.

protected:
	BOOL							m_bHelpVisible; 			// TRUE if the help panel is visible.
	BOOL							m_bToolBarVisible;  		// TRUE if the built in toolbar is visible.
	CSPPropertyGridToolBar			m_wndToolbar;   			// Pointer to the "built-in" PropertyGrid toolbar.
	HCURSOR							m_hCursorSplit; 			// Handle to the cursor when positioned over a splitter.
	HCURSOR							m_hCursorHand;  			// Handle of the cursor.
	BOOL							m_bTabItems;				// TRUE to navigate items with the tab key.

	CSPPropertyGridVerbs *			m_pVerbs;   				// Collection of verbs (links) displayed in the verb panel when the panel is visible.
	BOOL							m_bVerbsVisible;			// TRUE if the verb panel is visible.

	SPPropertyGridPaintTheme		m_themeCurrent; 		  // Currently set theme.
	CSPPropertyGridPaintManager *	m_pPaintManager;		  // Current paint manager.
	int								m_nFocusedVerb; 		  // Index of the currently focused verb within the collection of verbs.

private:
	CRect							m_rectTracker;
	CSPPropertyGridView *			m_pView;
	BOOL							m_bVerbActivate;


protected:

	//{{AFX_CODEJOCK_PRIVATE
		//{{AFX_MSG(CSPPropertyGrid)
		afx_msg BOOL OnEraseBkgnd(CDC* pDC);
		afx_msg void OnPaint();
		afx_msg void OnSetFocus(CWnd* pOldWnd);
		afx_msg void OnKillFocus(CWnd* pNewWnd);
		afx_msg void OnSize(UINT nType, int cx, int cy);
		afx_msg BOOL OnSetCursor(CWnd* pWnd, UINT nHitTest, UINT message);
		afx_msg void OnLButtonDown(UINT nFlags, CPoint point);
		afx_msg void OnLButtonUp(UINT nFlags, CPoint point);
		afx_msg void OnSortAlphabetic();
		afx_msg void OnSortCategorized();
		afx_msg void OnSysColorChange();
		afx_msg void OnKeyDown(UINT nChar, UINT nRepCnt, UINT nFlags);
		afx_msg UINT OnGetDlgCode();
		//}}AFX_MSG

	private:
		BOOL Create(LPCTSTR lpszClassName, LPCTSTR lpszWindowName, DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID, CCreateContext* pContext = NULL);
		DECLARE_MESSAGE_MAP()

		friend class CSPPropertyGridView;
		friend class CPropertyGridCtrl;
		friend class CSPPropertyGridVerb;
		friend class CSPPropertyGridVerbs;
	//}}AFX_CODEJOCK_PRIVATE

};

//////////////////////////////////////////////////////////////////////
AFX_INLINE BOOL CSPPropertyGridUpdateContext::IsEmpty()
{
	return m_mapState.IsEmpty();
}

AFX_INLINE CString CSPPropertyGridVerb::GetCaption()
{
	return m_strCaption;
}
AFX_INLINE int CSPPropertyGridVerb::GetID()
{
	return m_nID;
}
AFX_INLINE int CSPPropertyGridVerb::GetIndex()
{
	return m_nIndex;
}
AFX_INLINE void CSPPropertyGridVerb::SetPart( CRect rc )
{
	m_rcPart = rc;
}
AFX_INLINE CRect CSPPropertyGridVerb::GetPart()
{
	return m_rcPart;
}
AFX_INLINE CPoint CSPPropertyGridVerb::GetClickPoint()
{
	return m_ptClick;
}
AFX_INLINE BOOL CSPPropertyGridVerb::IsFocused()
{
	return ( m_nIndex == m_pVerbs->m_pGrid->m_nFocusedVerb ) && ( ::GetFocus() == m_pVerbs->m_pGrid->GetSafeHwnd() );
}
AFX_INLINE CSPPropertyGridVerb * CSPPropertyGridVerbs::GetAt( int nIndex )
{
	return m_arrVerbs.GetAt( nIndex );
}
AFX_INLINE BOOL CSPPropertyGridVerbs::IsEmpty()
{
	return m_arrVerbs.GetSize() == 0;
}


AFX_INLINE CSPPropertyGridItem * CSPPropertyGrid::FindItem( CString strCaption )
{
	return GetGridView().m_pCategories->FindItem( strCaption );
}
AFX_INLINE CSPPropertyGridItem * CSPPropertyGrid::FindItem( UINT nID )
{
	return GetGridView().m_pCategories->FindItem( nID );
}
AFX_INLINE CSPPropertyGridItem * CSPPropertyGrid::AddCategory( CString strCaption )
{
	return GetGridView().AddCategory( strCaption );
}
AFX_INLINE CSPPropertyGridItem * CSPPropertyGrid::InsertCategory( int nIndex , CString strCaption )
{
	return GetGridView().InsertCategory( nIndex,strCaption );
}
AFX_INLINE void CSPPropertyGrid::SetPropertySort( SPPropertyGridSortOrder sort )
{
	GetGridView().SetPropertySort( sort );
}
AFX_INLINE SPPropertyGridSortOrder CSPPropertyGrid::GetPropertySort()
{
	return GetGridView().m_properetySort;
}
AFX_INLINE BOOL CSPPropertyGrid::IsHelpVisible() const
{
	return m_bHelpVisible;
}
AFX_INLINE BOOL CSPPropertyGrid::IsBarVisible() const
{
	return m_bToolBarVisible;
}
AFX_INLINE int CSPPropertyGrid::GetHelpHeight() const
{
	return m_nHelpHeight;
}
AFX_INLINE COLORREF CSPPropertyGrid::GetHelpBackColor()
{
	return m_clrHelpBack;
}
AFX_INLINE COLORREF CSPPropertyGrid::GetHelpForeColor()
{
	return m_clrHelpFore;
}
AFX_INLINE CToolBar & CSPPropertyGrid::GetToolBar()
{
	return m_wndToolbar;
}
AFX_INLINE SPPropertyGridPaintTheme CSPPropertyGrid::GetCurrentTheme()
{
	return m_themeCurrent;
}
AFX_INLINE CSPPropertyGridVerbs * CSPPropertyGrid::GetVerbs()
{
	return m_pVerbs;
}
AFX_INLINE BOOL CSPPropertyGrid::IsVerbsVisible()
{
	return !m_pVerbs->IsEmpty();
}
AFX_INLINE CSPPropertyGridPaintManager * CSPPropertyGrid::GetPaintManager()
{
	return m_pPaintManager;
}
AFX_INLINE BOOL CSPPropertyGrid::Create( LPCTSTR lpszClassName , LPCTSTR lpszWindowName , DWORD dwStyle , const RECT & rect , CWnd * pParentWnd , UINT nID , CCreateContext * pContext )
{
	return CWnd::Create( lpszClassName,lpszWindowName,dwStyle,rect,pParentWnd,nID,pContext );
}
AFX_INLINE void CSPPropertyGrid::NavigateItems( BOOL bTabItems )
{
	m_bTabItems = bTabItems;
}

#endif // #if !defined(__SPPROPERTYGRID_H__)