chsmenu(pro)3.8 使用说明.txt

漂亮菜单

	uFlag 为 MF_BYCOMMAND 时 nItem 为菜单项 ID
说明    ：	为一个菜单项设置 ID。

+-------------------------------------------------------------------------------------------------------------------------------------+

BOOL SetMenuID( int nItem, UINT uID, UINT uFlag = MF_BYPOSITION );

返回值 ：	成功返回 TRUE 否则返回 FALSE
参数    ：	nItem  指定要设置 ID 的菜单项。
	uID 菜单项的新 ID 值。
	uFlag 为 MF_BYPOSITION  时 nItem 为菜单项位置（从 0 开始 ）
	uFlag 为 MF_BYCOMMAND 时 nItem 为菜单项 ID
说明    ：	为一个菜单项设置 ID。

+-------------------------------------------------------------------------------------------------------------------------------------+

BOOL SetMenuData( int nItem, ULONG ulData, UINT uFlag = MF_BYPOSITION );

返回值 ：	成功返回 TRUE 否则返回 FALSE
参数    ：	nItem  指定要设置附加数据的菜单项。
	ulData 指向附加数据的指针。
	uFlag 为 MF_BYPOSITION  时 nItem 为菜单项位置（从 0 开始 ）
	uFlag 为 MF_BYCOMMAND 时 nItem 为菜单项 ID
说明   ： 	为一个菜单项设置附加数据。

+-------------------------------------------------------------------------------------------------------------------------------------+

BOOL SetMenuString( int nItem, LPCTSTR lpszNewName, UINT uFlag = MF_BYPOSITION );

返回值 ：	成功返回 TRUE 否则返回 FALSE
参数    ：	nItem  指定要改标签的菜单项。
	lpszNewName 指向以 NULL 结尾要置为此菜单项标签的字符串。
	uFlag 为 MF_BYPOSITION  时 nItem 为菜单项位置（从 0 开始 ）
	uFlag 为 MF_BYCOMMAND 时 nItem 为菜单项 ID
说明    ：	为一个菜单项改标签。

+-------------------------------------------------------------------------------------------------------------------------------------+

BOOL SetSubMenu( int nItem, CHSMenu *pPopupMenu, UINT uFlag = MF_BYPOSITION );

返回值 ：	成功返回 TRUE 否则返回 FALSE
参数    ：	nItem  指定要改名的菜单项。
	pPopupMenu  指向 CHSMenu 子菜单的指针，为 NULL 时清除其自菜单指针
		      但不删除子菜单对象及其拥有的菜单项 。
 	uFlag 为 MF_BYPOSITION  时 nItem 为菜单项位置（从 0 开始 ）
	uFlag 为 MF_BYCOMMAND 时 nItem 为菜单项 ID
注释    ：	nItem 所指的菜单项不可为分隔条
说明    ：	为一个菜单项更改子菜单。

+-------------------------------------------------------------------------------------------------------------------------------------+

UINT TrackPopMenu( short x, short y, HWND hwndParent, UINT uFlag = 0 );							
返回值  ：	成功返回所选菜单ID, 否则返回0。
参数     ： x 显示菜单的 x 点屏幕坐标，即水平位置。
              y 显示菜单的 y 点屏幕坐标，即垂直位置。
	hwndParent 菜单拥有者，将收到WM_COMMAND消息。
              uFlag 保留。
注释　 ：	当有效菜单项被选择后，菜单的拥有者将收到 WM_COMMAND 消息。
说明    ：	在指定位置显示一个浮动的弹出式菜单，并跟踪菜单选项。

+-------------------------------------------------------------------------------------------------------------------------------------+

                                                                          
			         	       作者 : 韩 松                                 
                                                                          
		程序名称　：CHSMenu            
		程序类型　：菜单类		
		发布日期   ：02/10/01 
		邮箱地址　：[e-mail]
					
		作者声明　：此部分代码全是作者所写，可以随便传播，但要保持
			  文件的完整性,如果您有问题或有好的建议、意见请您
			  给我来信,非常感谢!			


+-------------------------------------------------------------------------------------------------------------------------------------+

				CHSMenuPro 类使用说明：

+-------------------------------------------------------------------------------------------------------------------------------------+

+-------------------+
|     CHSMenu         |
+-------------------+
           |                        +-------------------+      
           |---------------> |   CHSMenuPro       |
                                    +-------------------+	 

+-------------------------------------------------------------------------------------------------------------------------------------+

CHSMenuPro();

返回值：	无
参数   ：	无。
说明   ：	(构造函数)创建一个 CHSMenu 对象。

+-------------------------------------------------------------------------------------------------------------------------------------+

void AppendMenu( LPCTSTR pszName, UINT uID, int nIconID = 0, UINT uFlag = 0 );

返回值 ：	无
参数    ：	nIconID 要设置为此菜单项图标的 ID。 
注释　 ：	其它请参见 CHSMenu::AppendMenu
说明 　：	将一个新菜单项加到一个菜单尾部。　

+-------------------------------------------------------------------------------------------------------------------------------------+

BOOL AppendPopup( LPCTSTR pszName, CHSMenu *pPopup, UINT uID = 0, int nIconID = 0, UINT uFlag = 0 );

返回值 ：	成功返回真 TRUE，否则返回假 FALSE。
参数    ：	nIconID 要设置为此菜单项图标的 ID。 
注释　 ：	其它请参见 CHSMenu::AppendPopup
说明    ：	将一个新的弹出式单项加到一个菜单尾部。　

+-------------------------------------------------------------------------------------------------------------------------------------+

static COLORREF GetColor( int nIndex );

返回值 ：	特定颜色
参数    ：	nIndex 下列菜单特定颜色的标志
		CLR_BKGNDEDGE		菜单项标签默认背静
		CLR_SELSTART		渐进菜单项背静的起始颜色
		CLR_SELEND		渐进菜单项背静的终止颜色
注释　 ：	其它颜色请参见 CHSMenu::SetColor
说明    ：	获得菜单特定颜色。

+-------------------------------------------------------------------------------------------------------------------------------------+

static UINT GetMenuLook( UINT uMenuLook );

返回值 ：	菜单外观标志
参数    ：	请参见 SetMenuStyle
说明    ：	获得菜单外观。

+-------------------------------------------------------------------------------------------------------------------------------------+

BOOL InsertMenu( int nItem, LPCTSTR pszName, UINT uID, int nIconID = 0, UINT uFlags = 0, UINT uFlag = MF_BYPOSITION );

返回值 ：	成功返回真 TRUE，否则返回假 FALSE。
参数    ：	nIconID 要设置为此菜单项图标的 ID。 
注释　 ：	其它参数同 CHSMenu::AppendMenu。
说明 　：	将一个新菜单项插入到菜单的指定位置。　

+-------------------------------------------------------------------------------------------------------------------------------------+

BOOL InsertPopup( int nItem, LPCTSTR pszName, CHSMenu *pPopup, UINT uID = 0, int nIconID = 0, UINT uFlags = 0, UINT uFlag = MF_BYPOSITION);

返回值 ：	成功返回真 TRUE，否则返回假 FALSE。
参数    ：	nIconID 要设置为此菜单项图标的 ID。 
注释　 ：	其它参数同 CHSMenu::AppendPopup
说明 　：	将一个新弹出式菜单项插入到菜单的指定位置。　

+-------------------------------------------------------------------------------------------------------------------------------------+

static HICON LoadIcon( int nIconID );

返回值 ：	成功返回图标句柄 否则返回 NULL。
参数    ：	nIconID 要加载图标的 ID。 
说明 　：	加载图标。　

+-------------------------------------------------------------------------------------------------------------------------------------+

BOOL LoadMenu(UINT uIDResource, int nMenuPos = 0, int nIconPos = 1 );

返回值 ：	成功返回真 TRUE，否则返回假 FALSE。
参数    ：	uIDResource 指定要加载菜单资源的菜单ID。
            	nMenuPos 指定弹出式菜单的位置. 	
            	nIconPos 指定保存弹出式菜单的图标ID菜单的位置.
注释　 ：	nIconPos 菜单必须和nMenuPos菜单一致(菜单项的位置),将图标ID保存在与nMenuPos菜单项相对应的nIconPos的菜单ID中.
            	弹出式父菜单项的图标ID保存在其子菜单的第一项中.并且每个弹出父菜单项的子菜单中保留第一项(即nPosition=0)为冗余项.
            	菜单使用完毕后,调用FreeMenu函数释放资源. ( 详细使用方法请参照演示程序 CHSMenu2.5 )
说明 　：	从程序的可执行文件中加载一个菜单资源。　

+-------------------------------------------------------------------------------------------------------------------------------------+

BOOL SetMenuIcon( UINT nItem, int nNewIconID, UINT uFlag = MF_BYPOSITION );

返回值 ：	成功返回 TRUE 否则返回 FALSE
参数    ：	nNewIconID 菜单项的新图标 ID
注释　 ：	其它请参见 CHSMenu::SetMenuData
说明    ：	为一个菜单项改标签。

+-------------------------------------------------------------------------------------------------------------------------------------+

static void SetMenuStyle( UINT uMenuLook, BOOL bSet );

返回值 ：	无
参数    ：	uMenuLook 指定要更改的菜单外观标志，可以是以下标志的组合
		ML_SEPARATOR3D_HEAVE	立体外观的分隔条 （突出的） 
		ML_SEPARATOR3D_CONCAVE	立体外观的分隔条 （凹陷的） 
		ML_MENU3D	    	立体外观的菜单	
		ML_BKGNDEDGE		菜单项标签默认背静
		ML_ARROWROUND       	指定弹出式菜单项的箭头为圆形		
		ML_CLICK3D	　 	鼠标左键单击时，被选菜单项为凹陷立体外观	
		ML_SEL3D	　 	被选菜单项为突出立体外观
		ML_SELGRADIENT		被选菜单项为渐进外观（水平）
		ML_SELGRADIENT_V	被选菜单项为渐进外观（垂直）
	bSet 为 TRUE 设置指定的菜单外观，为 FALSE 清除指定外观
注释　：	其它请参见 CHSMenu::SetMenuData
说明   ：	更改菜单外观。

+-------------------------------------------------------------------------------------------------------------------------------------+

static void SetColor( int nIndex, COLORREF clrSet );

返回值 ：	无
参数    ：	nIndex 下列菜单特定颜色的标志
		CLR_BKGNDEDGE		菜单项标签默认背静
		CLR_SELSTART		渐进菜单项背静的起始颜色
		CLR_SELEND		渐进菜单项背静的终止颜色
注释　 ：	其它颜色请参见 CHSMenu::SetColor
说明    ： 	获得菜单特定颜色。

+-------------------------------------------------------------------------------------------------------------------------------------+

void SetMenuIconSize( int nSize );

返回值 ：	无
参数    ：	nSize 图标大小
注释　 ：	其它颜色请参见 CHSMenu::SetColor
说明    ：	设置当前菜单的图标大小。

+-------------------------------------------------------------------------------------------------------------------------------------+