CMzWnd类参考

MZFC 窗口基类. 更多...

#include <MzWnd.h>

被CMzWndEx继承.

所有成员的列表。

公有成员
void	AnimateWindow (UINT nAnimType, bool bShow)
	作窗口动画
BOOL	Attach (HWND hWndNew)
	把窗口句柄关联到CMzWnd对象上
	CMzWnd (void)
virtual BOOL	Create (int xPos, int yPos, int width, int height, HWND hwndParent=NULL, int uID=NULL, DWORD style=WS_CHILD, DWORD exstyle=0)
	创建窗口 创建模态窗口建议使用 CreateModalDialog，创建子窗口建议使用 CreateChildWindow
virtual BOOL	CreateChildWindow (int xPos, int yPos, int width, int height, HWND hwndParent, int uID=NULL, DWORD exstyle=0)
	创建为子窗口
virtual BOOL	CreateModalDialog (int xPos, int yPos, int width, int height, HWND hwndParent, int uID=NULL, DWORD exstyle=0)
	创建为模态对话框窗口
void	DestroyWindow ()
	销毁窗口
HWND	Detach ()
	把窗口句柄从关联的CMzWnd对象上解除关联
void	Dock (DWORD dwFlags)
	停靠
virtual int	DoModal (BOOL bDisableOwner=TRUE)
	弹出模态窗口
void	EnableFillBgColor (bool bEnable)
	重画时是否填充背景色，窗口默认值为true
void	EndModal (int nRet)
	结束模态对话框
UINT	GetAnimateType_Hide ()
	获得窗口的结束动画类型
UINT	GetAnimateType_Show ()
	获得窗口的开始动画类型
BOOL	GetExtendedProperty_CMzWnd (int nPropertyType, void *pValue, int nBufSize)
	获取或设置对象的扩展属性值
int	GetHeight (void)
	获得窗口高度
HWND	GetParent (void)
	获得父窗口句柄
MZFC_INLINE int	GetShellHomekeyReturnValue ()
	获得当窗口收到Shell Home key 消息时的返回值
int	GetWidth (void)
	获得窗口宽度
virtual HBITMAP	GetWindowBitmap (__in const RECT *prcScreen)
	获得窗口的位图. prcScreen指定只获得窗口位图的某部分
virtual HBITMAP	GetWindowBitmap (void)
	获得窗口的位图.
POINT	GetWindowPos ()
	获得窗口位置.
int	GetWindowText (HWND hWnd, LPTSTR lpString, int nMaxCount)
	获得窗口文本，与 Win32 API 的含义相同
CMzString	GetWindowText ()
	获得窗口文本
int	GetWindowTextLength ()
	获得窗口文本的长度
BOOL	Invalidate (RECT *rcUpdate=NULL, BOOL bErase=FALSE)
	使窗口的某部分失效. 与 Win32 InvalidateRect() API 含义相同
MZFC_INLINE bool	IsEnableFillBgColor ()
	重画时是否填充背景色
bool	IsVisible ()
	窗口是否可见
virtual LRESULT	MzDefWndProc (UINT message, WPARAM wParam, LPARAM lParam)
RECT	MzGetClientRect (void)
	获得窗口客户区矩形
RECT	MzGetWindowRect (void)
	获得窗口矩形
virtual void	OnPaint (HDC hdc, LPPAINTSTRUCT ps)
	当窗口收到WM_PAINT消息时会调用此成员函数
virtual void	PaintWin (HDC hdc, RECT *prcUpdate=NULL)
	当窗口要绘制的时候会调用此成员函数.
BOOL	PostCommandMessage (int nID, int nNotifyCode, LPARAM lParam)
	给窗口发送 MZ_WM_COMMAND 消息. 参见 MZ_WM_COMMAND.
BOOL	PostCommandMessage (LPARAM lParam)
	给窗口发送 MZ_WM_COMMAND 消息. 参见 MZ_WM_COMMAND.
BOOL	PostCommandMessage (void)
	给窗口发送 MZ_WM_COMMAND 消息. 参见 MZ_WM_COMMAND.
BOOL	PostMessage (UINT message, WPARAM wParam, LPARAM lParam)
	给窗口发送指定的消息
void	ScrollWindow_So (RECT *prcDst, RECT *prcScroll, RECT *prcClipSrc, RECT *prcClipDst)
	滚动窗口（优化的）
LRESULT	SendMessage (UINT message, WPARAM wParam, LPARAM lParam)
	给窗口发送指定的消息
void	SetAnimateEdge (int nEdgeBottom, int nEdgeTop, int nEdgeLeft=0, int nEdgeRight=0)
void	SetAnimateType_Hide (UINT nAnimType)
	设置窗口的结束动画类型
void	SetAnimateType_Show (UINT nAnimType)
	设置窗口的开始动画类型
void	SetBgColor (COLORREF crBg)
	设置背景颜色
void	SetDrawTextFormat (DWORD dwFormat)
	设置 DrawText format，dwFormat的值与Win32 API DrawText()的对应参数含义相同
BOOL	SetExtendedProperty_CMzWnd (int nPropertyType, void *pValue, int nBufSize)
	获取或设置对象的扩展属性值
void	SetFontColor (COLORREF crFont)
	设置字体颜色
void	SetFontSize (int nSize)
	设置字体尺寸
void	SetForeground ()
	把窗口提到最前面（与Win32API的SetForegroundWindow()作用相同）
void	SetShellHomekeyReturnValue (int nValue)
	设置当窗口收到Shell Home key 消息时的返回值
BOOL	SetWindowPos (HWND hWndInsertAfter, int X, int Y, int cx, int cy, UINT uFlags=0)
	设置窗口位置，与 Win32 API: SetWindowPos() 含义相同
void	SetWindowText (LPCTSTR lpString)
	设置窗口文本
void	Show (bool bShow=true, bool bBringTop=true)
	显示、隐藏窗口.
BOOL	ShowWindow (int nCmdShow)
	显示、隐藏窗口，与 Win32 ShowWindow() API含义相同
BOOL	SubClassWindow (HWND hWnd)
	子类化窗口
HWND	UnSubClassWindow (void)
	反子类化窗口
void	UpdateWindow ()
	使窗口马上刷新. 与 Win32 UpdateWindow() API 含义相同
virtual	~CMzWnd (void)
静态公有成员
static CMzWnd *	FromHandle (HWND hWnd)
	获得窗口句柄对应的CMzWnd指针
公有属性
HWND	m_hWnd
	窗口句柄
保护成员
virtual BOOL	MzRegisterClass ()
	注册窗口类
virtual void	OnCommand (WORD wNotifyCode, WORD wID, HWND hwndCtl)
	当窗口收到 WM_COMMAND 消息时，会调用此成员函数
virtual BOOL	OnInitDialog (void)
	当MZFC窗口被创建时，会调用此成员函数以初始化窗口
virtual void	OnLButtonDblClk (UINT fwKeys, int xPos, int yPos)
	窗口在被双击时会调用此成员函数.
virtual void	OnLButtonDown (UINT fwKeys, int xPos, int yPos)
	窗口在鼠标左键按下时会调用此成员函数.
virtual void	OnLButtonUp (UINT fwKeys, int xPos, int yPos)
	窗口在鼠标左键放开时会调用此成员函数
virtual void	OnMouseMove (UINT fwKeys, int xPos, int yPos)
	窗口在鼠标移动时会调用此成员函数.
virtual void	OnMzCommand (WPARAM wParam, LPARAM lParam)
	当窗口收到 MZ_WM_COMMAND 消息，此成员函数会被调用
virtual void	OnSettingChange (DWORD wFlag, LPCTSTR pszSectionName)
	窗口收到 WM_SETTINGCHANGE 消息时会调用此成员函数
virtual int	OnShellHomeKey (UINT message, WPARAM wParam, LPARAM lParam)
	当SHELL HOME被按下时，会调用此成员函数
virtual void	OnSize (int nWidth, int nHeight)
	窗口收到 WM_SIZE 消息时会调用此成员函数
virtual void	OnTimer (UINT_PTR nIDEvent)
	窗口在Timer到达时会调用此成员函数.
virtual void	PreSubClassWindow (void)
保护属性
bool	m_bEnableFillBgColor
COLORREF	m_crBgColor
	bg color of the window
COLORREF	m_crFontColor
MemoryDC	m_dcMem
DWORD	m_dwDockFlags
	window docking flags
DWORD	m_dwDrawTextFormat
	DrawText format，used by DrawText().
int	m_nAnimationEdgeBottom
int	m_nAnimationEdgeLeft
int	m_nAnimationEdgeRight
int	m_nAnimationEdgeTop
int	m_nFontSize
WNDPROC	m_pfnSuper

---

详细描述

MZFC 窗口基类.

---

构造及析构函数文档

CMzWnd::CMzWnd

(

void

)

virtual CMzWnd::~CMzWnd

(

void

)

[virtual]

---

成员函数文档

void CMzWnd::AnimateWindow	(	UINT	nAnimType,
		bool	bShow
	)

作窗口动画

参见:

SetAnimateType_Show(), SetAnimateType_Hide()

BOOL CMzWnd::Attach

(

HWND

hWndNew

)

把窗口句柄关联到CMzWnd对象上

virtual BOOL CMzWnd::Create	(	int	xPos,
		int	yPos,
		int	width,
		int	height,
		HWND	hwndParent = NULL,
		int	uID = NULL,
		DWORD	style = WS_CHILD,
		DWORD	exstyle = 0
	)			[virtual]

创建窗口 创建模态窗口建议使用 CreateModalDialog，创建子窗口建议使用 CreateChildWindow

参数:

	style	0: 创建普通窗口; WS_CHILD: 创建子窗口; WS_POPUP:创建模态窗口(需要调用DoModal()以弹出的窗口)
	xPos	x 坐标
	yPos	y 坐标
	width	窗口宽度
	height	窗口高度
	hwndParent	父窗口句柄
	uID	窗口ID
	style	窗口的风格：Windows Styles
	exstyle	窗口的扩展风格：Extended Windows Styles

参见:

CreateModalDialog, CreateChildWindow

• hwndParent, uID, style, & exstyle 与 Win32 中 CreateWindow() API 的参数含义相同.

virtual BOOL CMzWnd::CreateChildWindow	(	int	xPos,
		int	yPos,
		int	width,
		int	height,
		HWND	hwndParent,
		int	uID = NULL,
		DWORD	exstyle = 0
	)			[virtual]

创建为子窗口

virtual BOOL CMzWnd::CreateModalDialog	(	int	xPos,
		int	yPos,
		int	width,
		int	height,
		HWND	hwndParent,
		int	uID = NULL,
		DWORD	exstyle = 0
	)			[virtual]

创建为模态对话框窗口

void CMzWnd::DestroyWindow

(

)

销毁窗口

HWND CMzWnd::Detach

(

)

把窗口句柄从关联的CMzWnd对象上解除关联

void CMzWnd::Dock

(

DWORD

dwFlags

)

停靠

virtual int CMzWnd::DoModal

(

BOOL

bDisableOwner = TRUE

)

[virtual]

弹出模态窗口

参数:

bDisableOwner

模态窗口弹出时是否把它的Owner窗口禁用

返回:

返回EndModal(nRet)的nRet值 ( 例如 ID_CASCADE_EXIT, ID_OK, ID_CANCEL 等)

void CMzWnd::EnableFillBgColor

(

bool

bEnable

)

重画时是否填充背景色，窗口默认值为true

void CMzWnd::EndModal

(

int

nRet

)

结束模态对话框

参数:

nRet

ID_CASCADE_EXIT, ID_OK, ID_CANCEL, 大于 ID_CANCEL 的值可用作自定义返回值.

返回:

static CMzWnd* CMzWnd::FromHandle

(

HWND

hWnd

)

[static]

获得窗口句柄对应的CMzWnd指针

UINT CMzWnd::GetAnimateType_Hide

(

)

获得窗口的结束动画类型

UINT CMzWnd::GetAnimateType_Show

(

)

获得窗口的开始动画类型

BOOL CMzWnd::GetExtendedProperty_CMzWnd	(	int	nPropertyType,
		void *	pValue,
		int	nBufSize
	)

获取或设置对象的扩展属性值

参数:

	nPropertyType	要获取或设置的属性类型
	pValue	要获取或设置的属性值的指针
	nBufSize	pValue所指向的变量的size大小（单位: 字节）

返回:

操作是否成功

int CMzWnd::GetHeight

(

void

)

获得窗口高度

被CPopupMenu重载。

HWND CMzWnd::GetParent

(

void

)

获得父窗口句柄

MZFC_INLINE int CMzWnd::GetShellHomekeyReturnValue

(

)

获得当窗口收到Shell Home key 消息时的返回值

获得当窗口收到Shell Home key 消息时的返回值

• SHK_RET_DEFAULT & SHK_RET_APPEXIT_SHELLTOP 是相同的
• SHK_RET_APPEXIT_SHELLTOP 应用程序会退出，SHELL被置顶
• SHK_RET_APPNOEXIT_SHELLNOTOP 应用程序不退出，SHELL不置顶
• SHK_RET_APPNOEXIT_SHELLTOP 应用程序不退出，SHELL置顶

  参见:

  OnShellHomeKey() , SetShellHomekeyReturnValue()

int CMzWnd::GetWidth

(

void

)

获得窗口宽度

virtual HBITMAP CMzWnd::GetWindowBitmap

(

__in const RECT *

prcScreen

)

[virtual]

获得窗口的位图. prcScreen指定只获得窗口位图的某部分

virtual HBITMAP CMzWnd::GetWindowBitmap

(

void

)

[virtual]

获得窗口的位图.

POINT CMzWnd::GetWindowPos

(

)

获得窗口位置.

int CMzWnd::GetWindowText	(	HWND	hWnd,
		LPTSTR	lpString,
		int	nMaxCount
	)

获得窗口文本，与 Win32 API 的含义相同

CMzString CMzWnd::GetWindowText

(

)

获得窗口文本

int CMzWnd::GetWindowTextLength

(

)

获得窗口文本的长度

BOOL CMzWnd::Invalidate	(	RECT *	rcUpdate = NULL,
		BOOL	bErase = FALSE
	)

使窗口的某部分失效. 与 Win32 InvalidateRect() API 含义相同

MZFC_INLINE bool CMzWnd::IsEnableFillBgColor

(

)

重画时是否填充背景色

bool CMzWnd::IsVisible

(

)

窗口是否可见

virtual LRESULT CMzWnd::MzDefWndProc	(	UINT	message,
		WPARAM	wParam,
		LPARAM	lParam
	)			[virtual]

MZFC窗口消息处理函数.

• 重载此成员函数对消息作处理, 处理完之后请根据需要调用继承类相应的此成员函数.

被CMzMenuDialog、CMzPopupDialog、MzSetDaily、CMzWndEx及CPopupMenu重载。

RECT CMzWnd::MzGetClientRect

(

void

)

获得窗口客户区矩形

RECT CMzWnd::MzGetWindowRect

(

void

)

获得窗口矩形

virtual BOOL CMzWnd::MzRegisterClass

(

)

[protected, virtual]

注册窗口类

virtual void CMzWnd::OnCommand	(	WORD	wNotifyCode,
		WORD	wID,
		HWND	hwndCtl
	)			[protected, virtual]

当窗口收到 WM_COMMAND 消息时，会调用此成员函数

参见:

WM_COMMAND

virtual BOOL CMzWnd::OnInitDialog

(

void

)

[protected, virtual]

当MZFC窗口被创建时，会调用此成员函数以初始化窗口

重载此成员函数来初始化窗口中的内容。 注意，在重载函数中，请先调用所继承类的此成员函数，再添加您的初始化代码。

返回:

FALSE: init failed, TRUE: init succeeded.

参见:

CMzWnd::Create()

被CMzMenuDialog、CMzPopupDialog、MzSetDaily、CMzWndEx、CNumPad、CNumPadEx及CPopupMenu重载。

virtual void CMzWnd::OnLButtonDblClk	(	UINT	fwKeys,
		int	xPos,
		int	yPos
	)			[protected, virtual]

窗口在被双击时会调用此成员函数.

virtual void CMzWnd::OnLButtonDown	(	UINT	fwKeys,
		int	xPos,
		int	yPos
	)			[protected, virtual]

窗口在鼠标左键按下时会调用此成员函数.

virtual void CMzWnd::OnLButtonUp	(	UINT	fwKeys,
		int	xPos,
		int	yPos
	)			[protected, virtual]

窗口在鼠标左键放开时会调用此成员函数

virtual void CMzWnd::OnMouseMove	(	UINT	fwKeys,
		int	xPos,
		int	yPos
	)			[protected, virtual]

窗口在鼠标移动时会调用此成员函数.

virtual void CMzWnd::OnMzCommand	(	WPARAM	wParam,
		LPARAM	lParam
	)			[protected, virtual]

当窗口收到 MZ_WM_COMMAND 消息，此成员函数会被调用

重载此函数以处理命令消息

参见:

MZ_WM_COMMAND

被CMzMenuDialog、CMzPopupDialog、MzSetDaily、CNumPad、CNumPadEx及CPopupMenu重载。

virtual void CMzWnd::OnPaint	(	HDC	hdc,
		LPPAINTSTRUCT	ps
	)			[virtual]

当窗口收到WM_PAINT消息时会调用此成员函数

virtual void CMzWnd::OnSettingChange	(	DWORD	wFlag,
		LPCTSTR	pszSectionName
	)			[protected, virtual]

窗口收到 WM_SETTINGCHANGE 消息时会调用此成员函数

被CPopupMenu重载。

virtual int CMzWnd::OnShellHomeKey	(	UINT	message,
		WPARAM	wParam,
		LPARAM	lParam
	)			[protected, virtual]

当SHELL HOME被按下时，会调用此成员函数

返回:

SHELL 会根据此函数的返回值作不同的处理:

• SHK_RET_DEFAULT & SHK_RET_APPEXIT_SHELLTOP 是相同的
• SHK_RET_APPEXIT_SHELLTOP 应用程序会退出，SHELL被置顶
• SHK_RET_APPNOEXIT_SHELLNOTOP 应用程序不退出，SHELL不置顶
• SHK_RET_APPNOEXIT_SHELLTOP 应用程序不退出，SHELL置顶

参见:

SetShellHomekeyReturnValue()

virtual void CMzWnd::OnSize	(	int	nWidth,
		int	nHeight
	)			[protected, virtual]

窗口收到 WM_SIZE 消息时会调用此成员函数

被CMzWndEx重载。

virtual void CMzWnd::OnTimer

(

UINT_PTR

nIDEvent

)

[protected, virtual]

窗口在Timer到达时会调用此成员函数.

被CMzPopupDialog重载。

virtual void CMzWnd::PaintWin	(	HDC	hdc,
		RECT *	prcUpdate = NULL
	)			[virtual]

当窗口要绘制的时候会调用此成员函数.

被CMzMenuDialog、CMzPopupDialog、MzSetDaily、CMzWndEx及CPopupMenu重载。

BOOL CMzWnd::PostCommandMessage	(	int	nID,
		int	nNotifyCode,
		LPARAM	lParam
	)

给窗口发送 MZ_WM_COMMAND 消息. 参见 MZ_WM_COMMAND.

BOOL CMzWnd::PostCommandMessage

(

LPARAM

lParam

)

给窗口发送 MZ_WM_COMMAND 消息. 参见 MZ_WM_COMMAND.

BOOL CMzWnd::PostCommandMessage

(

void

)

给窗口发送 MZ_WM_COMMAND 消息. 参见 MZ_WM_COMMAND.

BOOL CMzWnd::PostMessage	(	UINT	message,
		WPARAM	wParam,
		LPARAM	lParam
	)

给窗口发送指定的消息

virtual void CMzWnd::PreSubClassWindow

(

void

)

[protected, virtual]

void CMzWnd::ScrollWindow_So	(	RECT *	prcDst,
		RECT *	prcScroll,
		RECT *	prcClipSrc,
		RECT *	prcClipDst
	)

滚动窗口（优化的）

LRESULT CMzWnd::SendMessage	(	UINT	message,
		WPARAM	wParam,
		LPARAM	lParam
	)

给窗口发送指定的消息

void CMzWnd::SetAnimateEdge	(	int	nEdgeBottom,
		int	nEdgeTop,
		int	nEdgeLeft = 0,
		int	nEdgeRight = 0
	)

设定做窗口切换动画的时候，窗口上边缘及下边缘不参与动画的部分 两个都为零即整个窗口区域大小都做动画 默认值为0

void CMzWnd::SetAnimateType_Hide

(

UINT

nAnimType

)

设置窗口的结束动画类型

参数:

nAnimType

MZ_ANIMTYPE_NONE, MZ_ANIMTYPE_SCROLL_BOTTOM_TO_TOP_1, MZ_ANIMTYPE_ZOOM_OUT, 等.

void CMzWnd::SetAnimateType_Show

(

UINT

nAnimType

)

设置窗口的开始动画类型

参数:

nAnimType

MZ_ANIMTYPE_NONE, MZ_ANIMTYPE_SCROLL_BOTTOM_TO_TOP_2, MZ_ANIMTYPE_ZOOM_IN, 等.

void CMzWnd::SetBgColor

(

COLORREF

crBg

)

设置背景颜色

void CMzWnd::SetDrawTextFormat

(

DWORD

dwFormat

)

设置 DrawText format，dwFormat的值与Win32 API DrawText()的对应参数含义相同

BOOL CMzWnd::SetExtendedProperty_CMzWnd	(	int	nPropertyType,
		void *	pValue,
		int	nBufSize
	)

获取或设置对象的扩展属性值

参数:

	nPropertyType	要获取或设置的属性类型
	pValue	要设置的属性值的指针
	nBufSize	pValue所指向的变量的size大小（单位: 字节）

返回:

操作是否成功

void CMzWnd::SetFontColor

(

COLORREF

crFont

)

设置字体颜色

void CMzWnd::SetFontSize

(

int

nSize

)

设置字体尺寸

void CMzWnd::SetForeground

(

)

把窗口提到最前面（与Win32API的SetForegroundWindow()作用相同）

void CMzWnd::SetShellHomekeyReturnValue

(

int

nValue

)

设置当窗口收到Shell Home key 消息时的返回值

置当窗口收到Shell Home key 消息时的返回值

• SHK_RET_DEFAULT & SHK_RET_APPEXIT_SHELLTOP 是相同的
• SHK_RET_APPEXIT_SHELLTOP 应用程序会退出，SHELL被置顶
• SHK_RET_APPNOEXIT_SHELLNOTOP 应用程序不退出，SHELL不置顶
• SHK_RET_APPNOEXIT_SHELLTOP 应用程序不退出，SHELL置顶

  参见:

  OnShellHomeKey() , GetShellHomekeyReturnValue()

BOOL CMzWnd::SetWindowPos	(	HWND	hWndInsertAfter,
		int	X,
		int	Y,
		int	cx,
		int	cy,
		UINT	uFlags = 0
	)

设置窗口位置，与 Win32 API: SetWindowPos() 含义相同

参数:

	hWndInsertAfter	插入到指定的窗口的后面
	X	x 坐标
	Y	y 坐标
	cx	宽
	cy	高
	uFlags	与 Win32 API SetWindowPos() 的 uFlags 参数含义相同

void CMzWnd::SetWindowText

(

LPCTSTR

lpString

)

设置窗口文本

void CMzWnd::Show	(	bool	bShow = true,
		bool	bBringTop = true
	)

显示、隐藏窗口.

BOOL CMzWnd::ShowWindow

(

int

nCmdShow

)

显示、隐藏窗口，与 Win32 ShowWindow() API含义相同

BOOL CMzWnd::SubClassWindow

(

HWND

hWnd

)

子类化窗口

HWND CMzWnd::UnSubClassWindow

(

void

)

反子类化窗口

void CMzWnd::UpdateWindow

(

)

使窗口马上刷新. 与 Win32 UpdateWindow() API 含义相同

---

成员数据文档

bool CMzWnd::m_bEnableFillBgColor [protected]

COLORREF CMzWnd::m_crBgColor [protected]

bg color of the window

COLORREF CMzWnd::m_crFontColor [protected]

MemoryDC CMzWnd::m_dcMem [protected]

DWORD CMzWnd::m_dwDockFlags [protected]

window docking flags

DWORD CMzWnd::m_dwDrawTextFormat [protected]

DrawText format，used by DrawText().

HWND CMzWnd::m_hWnd

窗口句柄

int CMzWnd::m_nAnimationEdgeBottom [protected]

int CMzWnd::m_nAnimationEdgeLeft [protected]

int CMzWnd::m_nAnimationEdgeRight [protected]

int CMzWnd::m_nAnimationEdgeTop [protected]

int CMzWnd::m_nFontSize [protected]

WNDPROC CMzWnd::m_pfnSuper [protected]

---

该类的文档由以下文件生成：

• MzWnd.h