MzGraphicAPI.h文件参考

#include <mzfc/mzfcdll.h>
#include <mzfc/MzControlDefs.h>

宏定义
#define	MZ_ANIMTYPE_FADE   15
	淡出
#define	MZ_ANIMTYPE_NONE   0
	无动画
#define	MZ_ANIMTYPE_SCROLL_BOTTOM_TO_TOP_1   4
	1往上滚动并消失, 2静止并出现
#define	MZ_ANIMTYPE_SCROLL_BOTTOM_TO_TOP_2   1
	2从下往上滚动出现, 1静止并消失
#define	MZ_ANIMTYPE_SCROLL_BOTTOM_TO_TOP_PUSH   9
	2从下至上推着1一起滚动并出现
#define	MZ_ANIMTYPE_SCROLL_LEFT_TO_RIGHT_1   8
	1往右滚动并消失, 2静止并出现
#define	MZ_ANIMTYPE_SCROLL_LEFT_TO_RIGHT_2   5
	2从左往右滚动出现, 1静止并消失
#define	MZ_ANIMTYPE_SCROLL_LEFT_TO_RIGHT_PUSH   11
	2从左至右推着1一起滚动并出现
#define	MZ_ANIMTYPE_SCROLL_RIGHT_TO_LEFT_1   6
	1往左滚动并消失, 2静止并出现
#define	MZ_ANIMTYPE_SCROLL_RIGHT_TO_LEFT_2   7
	2从右往左滚动出现, 1静止并消失
#define	MZ_ANIMTYPE_SCROLL_RIGHT_TO_LEFT_PUSH   12
	2从右至左推着1一起滚动并出现
#define	MZ_ANIMTYPE_SCROLL_TOP_TO_BOTTOM_1   2
	1往下滚动并消失, 2静止并出现
#define	MZ_ANIMTYPE_SCROLL_TOP_TO_BOTTOM_2   3
	2从上往下滚动出现, 1静止并消失
#define	MZ_ANIMTYPE_SCROLL_TOP_TO_BOTTOM_PUSH   10
	2从上至下推着1一起滚动并出现
#define	MZ_ANIMTYPE_ZOOM_IN   13
	2不断放大出现
#define	MZ_ANIMTYPE_ZOOM_OUT   14
	1不断缩小至不见
#define	MZ_COLORKEY_RGB   (RGB(255,0,255))
函数
MZFC_API void	AnimateBitmap (HBITMAP hBmp1, HBITMAP hBmp2, HDC hdcDst, RECT *prcDst, UINT animType, int nSpeedH=24, int nSpeedV=32)
	使用两个位图在目的DC上作指定的动画
MZFC_API void	FreeMzResModule ()
	卸载 mzres.dll
MZFC_API void	FreeMzResV2Module ()
	卸载 MzResV2.dll
MZFC_API HMODULE	GetMzResModuleHandle ()
	加载并返回 mzres.dll 的模块句柄
MZFC_API HMODULE	GetMzResV2ModuleHandle ()
	加载并返回 MzResV2.dll 的模块句柄
MZFC_API HBITMAP	GetPartofBitmap (HBITMAP hBmpSrc, const RECT *prcDst)
	获得指定位图的某一部分
MZFC_API HBITMAP	MzCreateCompatibleAlphaBitmap (int width, int height)
	创建32位带Alpha通道的兼容位图
MZFC_API BOOL	MzDrawControl (HDC hdcDst, RECT *prcDst, int nControlType, int nControlState, DWORD dwData=0)
	绘制系统定义的控件外观
BOOL MZFC_API	MzDrawDeleteItemBg (HDC hdcDst, RECT *prcDst)
	绘制准备被删除的列表项的背景
MZFC_API BOOL	MzDrawGridDlgBG (HDC hdcDst, RECT *prcDst, BOOL bDrawAngle=TRUE)
	绘制格子对话框的背景, 可指定是否直角（或圆角）.
MZFC_API BOOL	MzDrawGridLine (HDC hdcDst, int x1, int y1, int x2, int y2, UINT lineType, BOOL isHorizon)
MZFC_API BOOL	MzDrawGridPopupBG_RoundBottom (HDC hdcDst, RECT *prcDst)
	绘制弹出对话框的背景（带格子）, 底部是圆角的.
MZFC_API BOOL	MzDrawGridPopupBG_RoundTop (HDC hdcDst, RECT *prcDst)
	绘制弹出对话框的背景（带格子）, 顶部是圆角的.
MZFC_API BOOL	MzDrawGridPopupMenuBG2_480 (HDC hdcDst, RECT *prcDst)
	绘制弹出菜单的背景（带格子）, 宽480，顶部直角.
MZFC_API BOOL	MzDrawGridPopupMenuBG2_720 (HDC hdcDst, RECT *prcDst)
	绘制弹出菜单的背景（带格子）, 宽720，顶部直角.
MZFC_API BOOL	MzDrawGridPopupMenuBG_480 (HDC hdcDst, RECT *prcDst)
	绘制弹出菜单的背景（带格子）, 宽480，顶部圆角.
MZFC_API BOOL	MzDrawGridPopupMenuBG_720 (HDC hdcDst, RECT *prcDst)
	绘制弹出菜单的背景（带格子）, 宽720，顶部圆角.
MZFC_API BOOL	MzDrawInputBox_RoundShadow (HDC hdcDst, RECT *prcDst)
MZFC_API BOOL	MzDrawScrollbarH (HDC hdcDst, RECT *prcDst)
	绘制水平滚动条
MZFC_API BOOL	MzDrawScrollbarV (HDC hdcDst, RECT *prcDst, INT nResID)
	绘制竖直滚动条（使用指定的资源，资源ID为 nResID: resource ID of the scrollbar in mzres.dll）
MZFC_API BOOL	MzDrawScrollbarV (HDC hdcDst, RECT *prcDst)
	绘制竖直滚动条
BOOL MZFC_API	MzDrawSelectedBg (HDC hdcDst, RECT *prcDst)
	绘制选中（高亮）状态的列表项的背景
BOOL MZFC_API	MzDrawSelectedBg_NoLine (HDC hdcDst, RECT *prcDst)
	绘制选中（高亮）状态的列表项的背景（不绘制上下边缘的线）
MZFC_API int	MzDrawText (HDC hDC, LPCTSTR lpString, LPRECT lpRect, unsigned int uFormat)
	绘制文字，与 Win32 API DrawText()功能是相同的，但lpString可为空而不出异常.
MZFC_API HBITMAP	ScreenSnapshot (RECT *prcSrc=0)
	截屏。截取prcSrc所指定的屏幕图象, 0 表示截取全屏。

---

宏定义文档

#define MZ_ANIMTYPE_FADE   15

淡出

#define MZ_ANIMTYPE_NONE   0

无动画

#define MZ_ANIMTYPE_SCROLL_BOTTOM_TO_TOP_1   4

1往上滚动并消失, 2静止并出现

#define MZ_ANIMTYPE_SCROLL_BOTTOM_TO_TOP_2   1

2从下往上滚动出现, 1静止并消失

#define MZ_ANIMTYPE_SCROLL_BOTTOM_TO_TOP_PUSH   9

2从下至上推着1一起滚动并出现

#define MZ_ANIMTYPE_SCROLL_LEFT_TO_RIGHT_1   8

1往右滚动并消失, 2静止并出现

#define MZ_ANIMTYPE_SCROLL_LEFT_TO_RIGHT_2   5

2从左往右滚动出现, 1静止并消失

#define MZ_ANIMTYPE_SCROLL_LEFT_TO_RIGHT_PUSH   11

2从左至右推着1一起滚动并出现

#define MZ_ANIMTYPE_SCROLL_RIGHT_TO_LEFT_1   6

1往左滚动并消失, 2静止并出现

#define MZ_ANIMTYPE_SCROLL_RIGHT_TO_LEFT_2   7

2从右往左滚动出现, 1静止并消失

#define MZ_ANIMTYPE_SCROLL_RIGHT_TO_LEFT_PUSH   12

2从右至左推着1一起滚动并出现

#define MZ_ANIMTYPE_SCROLL_TOP_TO_BOTTOM_1   2

1往下滚动并消失, 2静止并出现

#define MZ_ANIMTYPE_SCROLL_TOP_TO_BOTTOM_2   3

2从上往下滚动出现, 1静止并消失

#define MZ_ANIMTYPE_SCROLL_TOP_TO_BOTTOM_PUSH   10

2从上至下推着1一起滚动并出现

#define MZ_ANIMTYPE_ZOOM_IN   13

2不断放大出现

#define MZ_ANIMTYPE_ZOOM_OUT   14

1不断缩小至不见

#define MZ_COLORKEY_RGB   (RGB(255,0,255))

---

函数文档

MZFC_API void AnimateBitmap	(	HBITMAP	hBmp1,
		HBITMAP	hBmp2,
		HDC	hdcDst,
		RECT *	prcDst,
		UINT	animType,
		int	nSpeedH = 24,
		int	nSpeedV = 32
	)

使用两个位图在目的DC上作指定的动画

两个位图的大小必需相同.

参数:

[in]	hdcDst	目的DC
[in]	prcDst	目的矩形
[in]	hBmp1	当前画面的位图
[in]	hBmp2	新画面的位图
[in]	animType	动画类型 (参见 MZ_ANIMTYPE_XXX 前缀的定义，如 MZ_ANIMTYPE_ZOOM_IN)
[in]	nSpeedH	水平速度，需要正数
[in]	nSpeedV	竖直速度，需要正数

MZFC_API void FreeMzResModule

(

)

卸载 mzres.dll

MZFC_API void FreeMzResV2Module

(

)

卸载 MzResV2.dll

MZFC_API HMODULE GetMzResModuleHandle

(

)

加载并返回 mzres.dll 的模块句柄

MZFC_API HMODULE GetMzResV2ModuleHandle

(

)

加载并返回 MzResV2.dll 的模块句柄

MZFC_API HBITMAP GetPartofBitmap	(	HBITMAP	hBmpSrc,
		const RECT *	prcDst
	)

获得指定位图的某一部分

MZFC_API HBITMAP MzCreateCompatibleAlphaBitmap	(	int	width,
		int	height
	)

创建32位带Alpha通道的兼容位图

MZFC_API BOOL MzDrawControl	(	HDC	hdcDst,
		RECT *	prcDst,
		int	nControlType,
		int	nControlState,
		DWORD	dwData = 0
	)

绘制系统定义的控件外观

参数:

	hdcDst	目的DC
	prcDst	目的矩形
	nControlType	控件类型 (参见 MzControlDefs.h 中的定义)
	nControlState	控件的状态(参见 MzControlDefs.h 中的定义)
	dwData	0. 保留.

BOOL MZFC_API MzDrawDeleteItemBg	(	HDC	hdcDst,
		RECT *	prcDst
	)

绘制准备被删除的列表项的背景

MZFC_API BOOL MzDrawGridDlgBG	(	HDC	hdcDst,
		RECT *	prcDst,
		BOOL	bDrawAngle = TRUE
	)

绘制格子对话框的背景, 可指定是否直角（或圆角）.

MZFC_API BOOL MzDrawGridLine	(	HDC	hdcDst,
		int	x1,
		int	y1,
		int	x2,
		int	y2,
		UINT	lineType,
		BOOL	isHorizon
	)

画分割线 lineType 分割线的样式类型, MzControlDefs.h中以MZC_GRIDLINE_开头的类型定义 isHorizon TRUE:水平分割线, FALSE: 竖直分割线

MZFC_API BOOL MzDrawGridPopupBG_RoundBottom	(	HDC	hdcDst,
		RECT *	prcDst
	)

绘制弹出对话框的背景（带格子）, 底部是圆角的.

MZFC_API BOOL MzDrawGridPopupBG_RoundTop	(	HDC	hdcDst,
		RECT *	prcDst
	)

绘制弹出对话框的背景（带格子）, 顶部是圆角的.

MZFC_API BOOL MzDrawGridPopupMenuBG2_480	(	HDC	hdcDst,
		RECT *	prcDst
	)

绘制弹出菜单的背景（带格子）, 宽480，顶部直角.

MZFC_API BOOL MzDrawGridPopupMenuBG2_720	(	HDC	hdcDst,
		RECT *	prcDst
	)

绘制弹出菜单的背景（带格子）, 宽720，顶部直角.

MZFC_API BOOL MzDrawGridPopupMenuBG_480	(	HDC	hdcDst,
		RECT *	prcDst
	)

绘制弹出菜单的背景（带格子）, 宽480，顶部圆角.

MZFC_API BOOL MzDrawGridPopupMenuBG_720	(	HDC	hdcDst,
		RECT *	prcDst
	)

绘制弹出菜单的背景（带格子）, 宽720，顶部圆角.

MZFC_API BOOL MzDrawInputBox_RoundShadow	(	HDC	hdcDst,
		RECT *	prcDst
	)

MZFC_API BOOL MzDrawScrollbarH	(	HDC	hdcDst,
		RECT *	prcDst
	)

绘制水平滚动条

MZFC_API BOOL MzDrawScrollbarV	(	HDC	hdcDst,
		RECT *	prcDst,
		INT	nResID
	)

绘制竖直滚动条（使用指定的资源，资源ID为 nResID: resource ID of the scrollbar in mzres.dll）

MZFC_API BOOL MzDrawScrollbarV	(	HDC	hdcDst,
		RECT *	prcDst
	)

绘制竖直滚动条

BOOL MZFC_API MzDrawSelectedBg	(	HDC	hdcDst,
		RECT *	prcDst
	)

绘制选中（高亮）状态的列表项的背景

BOOL MZFC_API MzDrawSelectedBg_NoLine	(	HDC	hdcDst,
		RECT *	prcDst
	)

绘制选中（高亮）状态的列表项的背景（不绘制上下边缘的线）

MZFC_API int MzDrawText	(	HDC	hDC,
		LPCTSTR	lpString,
		LPRECT	lpRect,
		unsigned int	uFormat
	)

绘制文字，与 Win32 API DrawText()功能是相同的，但lpString可为空而不出异常.

MZFC_API HBITMAP ScreenSnapshot

(

RECT *

prcSrc = 0

)

截屏。截取prcSrc所指定的屏幕图象, 0 表示截取全屏。