#if !defined(AFX_TREEPROPSHEET_H__50695CFB_FCE4_4188_ADB4_BF05A5488E41__INCLUDED_)
#define AFX_TREEPROPSHEET_H__50695CFB_FCE4_4188_ADB4_BF05A5488E41__INCLUDED_

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


#include "PropPageFrame.h"

#include <afxtempl.h>



class  CTreePropSheet : public CPropertySheet
{
	DECLARE_DYNAMIC(CTreePropSheet)

// Construction/Destruction
public:
	CTreePropSheet();
	CTreePropSheet(UINT nIDCaption, CWnd* pParentWnd = NULL, UINT iSelectPage = 0);
	CTreePropSheet(LPCTSTR pszCaption, CWnd* pParentWnd = NULL, UINT iSelectPage = 0);
	virtual ~CTreePropSheet();


	//屬性頁

// Operations
public:
	//在DoModal()或者Create()之前調用此函數，
	//用于設置屬性頁的瀏覽方式：樹形控件或者Tab控件
	BOOL SetTreeViewMode(BOOL bTreeViewMode = TRUE, BOOL bPageCaption = FALSE, BOOL bTreeImages = FALSE);
	//在DoModal()或者Create()之前調用此函數，
	//指定樹形控件的寬度
	BOOL SetTreeWidth(int nWidth);

	//指定空頁的文本內容
	void SetEmptyPageText(LPCTSTR lpszEmptyPageText);
	//設置空頁文本的繪制方式：
	//DT_CENTER|DT_VCENTER|DT_NOPREFIX|DT_SINGLELINE
	DWORD SetEmptyPageTextFormat(DWORD dwFormat);
	//為沒有圖標的頁或者空的父節點指定圖像列表，標準大小為16x16像素
	BOOL SetTreeDefaultImages(CImageList *pImages);

// Public helpers
public:
	//設置屬性頁的圖標
	static BOOL SetPageIcon(CPropertyPage *pPage, HICON hIcon);
	static BOOL SetPageIcon(CPropertyPage *pPage, CImageList &Images, int nImage);

	//銷毀屬性頁的圖標
	static BOOL DestroyPageIcon(CPropertyPage *pPage);

// Overridable implementation helpers
protected:
	//創建空頁的文本
	virtual CString GenerateEmptyPageMessage(LPCTSTR lpszEmptyPageMessage, LPCTSTR lpszCaption);
	//在創建過程期間，創建樹控件對象
	virtual CTreeCtrl* CreatePageTreeObject();

	//在創建過程期間，負責創建框架對象
	virtual CPropPageFrame* CreatePageFrame();

// Implementation helpers
protected:
	//將所有的子窗口移動指定數目的像素
	void MoveChildWindows(int nDx, int nDy);

	//重新填充包含幾個屬性頁實體的樹
	void RefillPageTree();

	//在屬性頁樹上創建指定的路徑并返回它的句柄
	HTREEITEM CreatePageTreeItem(LPCTSTR lpszPath, HTREEITEM hParent = TVI_ROOT);

	//將給定的路徑分為頂層和其余部分：如給定“畫筆::粗細::具體”，
	//它將返回“畫筆”和“粗細::具體”兩部分
	CString SplitPageTreePath(CString &strRest);

	//切換當前活動頁
	BOOL KillActiveCurrentPage();

	//返回屬性頁樹項
	HTREEITEM GetPageTreeItem(int nPage, HTREEITEM hRoot = TVI_ROOT);

	//選擇并顯示指定的頁
	BOOL SelectPageTreeItem(int nPage);

	//為當前活動頁選擇并顯示樹項
	BOOL SelectCurrentPageTreeItem();

	//為當前選中的頁更新標題
	void UpdateCaption();

	//激活先前的頁
	void ActivatePreviousPage();

	//激活下一頁
	void ActivateNextPage();

// Overridings
protected:
	//{{AFX_VIRTUAL(CTreePropSheet)
	public:
	virtual BOOL OnInitDialog();
	//}}AFX_VIRTUAL

// Message handlers
protected:
	//{{AFX_MSG(CTreePropSheet)
	afx_msg void OnDestroy();
	//}}AFX_MSG
	afx_msg LRESULT OnAddPage(WPARAM wParam, LPARAM lParam);
	afx_msg LRESULT OnRemovePage(WPARAM wParam, LPARAM lParam);
	afx_msg LRESULT OnSetCurSel(WPARAM wParam, LPARAM lParam);
	afx_msg LRESULT OnIsDialogMessage(WPARAM wParam, LPARAM lParam);

	afx_msg void OnPageTreeSelChanging(NMHDR *pNotifyStruct, LRESULT *plResult);
	afx_msg void OnPageTreeSelChanged(NMHDR *pNotifyStruct, LRESULT *plResult);
	DECLARE_MESSAGE_MAP()

// Properties
private:
	//樹形屬性表開關
	BOOL m_bTreeViewMode;
	//樹控件
	CTreeCtrl *m_pwndPageTree;
	//屬性表中框架的指針
	CPropPageFrame *m_pFrame;
	BOOL m_bPageTreeSelChangedActive;
	//頁標題的顯示開關
	BOOL m_bPageCaption;
	//樹中顯示圖像的開關
	BOOL m_bTreeImages;
	//用于樹形控件的圖像列表
	CImageList m_Images;
	//缺省的圖像列表
	CImageList m_DefaultImages;
	//用于空頁顯示的文本
	CString m_strEmptyPageMessage;
	//樹形控件的寬度（象素單位）
	int m_nPageTreeWidth;

// Static Properties
private:
	//樹視控件的ID
	static const UINT s_unPageTreeId;
};




/////////////////////////////////////////////////////////////////////////////

//{{AFX_INSERT_LOCATION}}
// Microsoft Visual C++ f黦t unmittelbar vor der vorhergehenden Zeile zus鋞zliche Deklarationen ein.

#endif // AFX_TREEPROPSHEET_H__50695CFB_FCE4_4188_ADB4_BF05A5488E41__INCLUDED_