/********************************************
** 工作室：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s 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__)