chsmenu(pro)3.8 使用说明.txt

漂亮菜单

参数    ：	nPosition 指定的菜单项位置（从 0 开始 ）。
说明    ：	得到菜单项 ID 值。

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

int GetMenuPosition( UINT uID ) const;

返回值 ：	成功返回菜单项位置（从 0 开始 ）否则返回 FINDNONE
参数    ：	uID 指定的菜单项 ID 值。
说明    ：	得到菜单项所在的位置。

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

UINT GetMenuState( int nItem, UINT uFlag = MF_BYPOSITION ) const;

返回值 ：	成功返回菜单项属性标志 否则返回 0
参数    ：	nItem  指定菜单项。
            	uFlag 为 MF_BYPOSITION  时 nItem 为菜单项位置（从 0 开始 ）
            	uFlag 为 MF_BYCOMMAND 时 nItem 为菜单项 ID
说明    ：	获得菜单项属性标志。

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

CHSMenu* GetSubMenu( int nItem, UINT uFlag = MF_BYPOSITION ) const;

返回值 ：	成功返回其子菜单指针 如无子菜单或失败则返回 NULL
参数    ：	nItem  指定菜单项。
            	uFlag 为 MF_BYPOSITION  时 nItem 为菜单项位置（从 0 开始 ）
            	uFlag 为 MF_BYCOMMAND 时 nItem 为菜单项 ID
说明    ：	获得菜单项属性标志。

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

BOOL GetMenuString( int nItem, CString& strName, UINT uFlag = MF_BYPOSITION ) const;
BOOL GetMenuString( int nItem, LPTSTR lpsName, int nCount, UINT uFlag = MF_BYPOSITION )const;

返回值 ：	成功返回 TRUE 否则返回 FALSE
参数    ：	nItem  指定菜单项。
            	strName 接收菜单项标签的 CString 对象。
	lpsName  接收菜单项标签的缓冲区指针。
	nCount 上述缓冲区的最大长度。
	uFlag 为 MF_BYPOSITION  时 nItem 为菜单项位置（从 0 开始 ）
	uFlag 为 MF_BYCOMMAND 时 nItem 为菜单项 ID
说明    ：	获得菜单项的标签。

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

BOOL GetMenuData( int nItem, ULONG *pulData, UINT uFlag = MF_BYPOSITION ) const;

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

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

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

返回值 ：	成功返回真 TRUE，否则返回假 FALSE。
参数    ：	nItem  指定新菜单项的插入位置。
	uFlag 为 MF_BYPOSITION  时 nItem 为菜单项位置（从 0 开始 ）
	uFlag 为 MF_BYCOMMAND 时 nItem 为菜单项 ID
注释　：	其它参数同 AppendMenu。
说明   ：	将一个新菜单项插入到菜单的指定位置。　

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

BOOL InsertPopup( int nItem, LPCTSTR pszName, CHSMenu *pPopupMenu, UINT uID = 0, ULONG ulData = 0, UINT uFlags = 0, UINT uFlag = MF_BYPOSITION );

返回值 ：	成功返回真 TRUE，否则返回假 FALSE。
参数    ：	nItem  指定新菜单项的插入位置。
	uFlag 为 MF_BYPOSITION  时 nItem 为菜单项位置（从 0 开始 ）
	uFlag 为 MF_BYCOMMAND 时 nItem 为菜单项 ID
注释　 ：	其它参数同 AppendPopup
说明 　：	将一个新弹出式菜单项插入到菜单的指定位置。　

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

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

返回值 ：	成功返回真 TRUE，否则返回假 FALSE。
参数    ：	uIDResource 指定要加载菜单资源的菜单ID。
            	nMenuPos 指定弹出式菜单的位置 	
注释　 ：	菜单使用完毕后,调用FreeMenu函数释放资源.
说明 　：	从程序的可执行文件中加载一个菜单资源。　

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

static void SetColor( int nIndex, COLORREF clrSet );

返回值 ：	无
参数    ：	nIndex 菜单特定颜色的标志参见 GetColor
	clrSet 颜色值
说明    ：	设置菜单特定颜色。

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

static void SetMenuPopDelay( UINT nDelay );

返回值 ：	无
参数    ：	nDelay 菜单弹出延时(毫秒).
说明    ：	设置菜单T弹出延时。

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

static void SetCustomMenu( PFNCUSTOMMENU pfnAddress );

返回值 ：	无
参数    ：	pfnAddress 自定义菜单的函数地址.
说明    ：	设置自定义菜单函数。
注释    ：	PFNCUSTOMMENU 定义 void (*PFNCUSTOMMENU)(HWND hMenu );

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

static void SetCustomMenuItem( PFNCUSTOMMENUITEM pfnAddress );

返回值 ：	无
参数    ：	pfnAddress 自定义菜单项的函数地址.
说明    ：	设置自定义菜单项函数。
注释    ：	PFNCUSTOMMENUITEM 定义 HRGN (*PFNCUSTOMMENUITEM)( const RECT* prcItem );

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

static void SetMenuAnimate( UINT nType, UINT nStep, UINT nDelay, BOOL bAnimateMenu = TRUE );

返回值 ：	无
参数    ：	nType 菜单动画类别
		ANIMATE_NONE			无动画
		ANIMATE_SLIDE_TTB		滑动效果-从上至下
		ANIMATE_SLIDE_LTR		滑动效果-从左至右
		ANIMATE_STRETCH_TTB		拉伸效果-从上至下
		ANIMATE_STRETCH_LTR		拉伸效果-从左至右
		ANIMATE_UNFOLD_TTB		打开效果-从上至下
		ANIMATE_UNFOLD_LTR		打开效果-从左至右
		ANIMATE_UNFOLD_LTTRB		打开效果-从左上至右下
		ANIMATE_UNFOLDSLIDE_LTTRB	打开滑动效果-从左上至右下
		ANIMATE_SHUTTER_TTB		百叶窗效果-从上至下
		ANIMATE_SHUTTER_LTR		百叶窗效果-从左至右
		ANIMATE_NOISE			雪花效果
		ANIMATE_FADE			淡出效果
		ANIMATE_RAND			随机效果(在上面动画类别中选择)
            	nStep 细节度 建议此值不要过大 0-100 	
            	nDelay 菜单动画延时.
	bAnimateMenu 等于TRUE时以上参数针对菜单显示时的效果 FALSE时针对菜单选项效果
说明    ：	设置菜单动画效果。
注释    ：	nStep 细节度的取值建议不要过大 0-100 	

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

static void SetMenuFont( HFONT hFont );

返回值 ：	无
参数    ：	hFont 要设置为菜单所用字体的句柄。
注释    ：	如果参数为 NULL 则使用系统默认字体
	字体只能在创建所有菜单（CreateMenu ）之前设置一次。
说明    ：	设置菜单字体。

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

static void SetMenuEdge( int nEdge );

返回值 ：	无
参数    ：	nEdge  宽度大小。
注释    ：	宽度只能在创建所有菜单（CreateMenu ）之前设置一次。。
说明    ：	设置菜单选项与菜单边界之间的宽度。

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

static void SetMenuPopDelay( int nDelay );

返回值 ：	无
参数    ：	nDelay  子菜单弹出延时。
说明    ：	设置子菜单弹出延时。

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

void SetSeparatorHeight( int nHeight );

返回值 ：	无
参数    ：	nHeight 分隔条高度
注释    ：	无
说明    ：	设置当前菜单的分隔条高度。

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

void SetMenuItemHeight( int nHeight );

返回值 ：	无
参数    ：	nHeight  菜单项高度
注释    ：	无
说明    ：	设置当前菜单的菜单项高度。

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

BOOL GetMenuItemRect(int nItem, RECT *prcItem, UINT uFlag = MF_BYPOSITION ) const

返回值 ：	成功返回 TRUE 否则返回 FALSE
参数    ：	nItem  指定要更改的菜单项。
            	prcItem 接收菜单项的RECT结构.	
            	uFlag 为 MF_BYPOSITION  时 nItem 为菜单项位置（从 0 开始 ）
            	uFlag 为 MF_BYCOMMAND 时 nItem 为菜单项 ID
说明    ：	为一个菜单项设置 ID。

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

BOOL ModifyMenu( int nItem, UINT uID, ULONG ulData, UINT uFlags, UINT uFlag = MF_BYPOSITION );

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

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

BOOL SetMenuState( int nItem, UINT uFlags, UINT uFlag =MF_BYPOSITION );

返回值 ：	成功返回 TRUE 否则返回 FALSE
参数    ：	nItem  指定要更改的菜单项。
	uFlags 菜单项新属性
	uFlag 为 MF_BYPOSITION  时 nItem 为菜单项位置（从 0 开始 ）