MzPopupProgress类参考

进度条对话框 更多...

#include <MzPopupProgress.h>

继承自UiWin。

所有成员的列表。

公有成员
BOOL	AddBottomButton (LPCTSTR lpszText, ImagingHelper *pImage=NULL, ImagingHelper *pImagePressed=NULL)
	在进度条的底部添加一个按钮，每次调用StartProgress之前调用，KillProgress后不再保持已添加的按钮
UINT	GetFirstButtonID (void)
ImagingHelper *	GetNoteImage (void)
ImagingHelper *	GetNoteImage2 (void)
BOOL	GetNoteText (CMzString &strText)
BOOL	GetNoteText2 (CMzString &strText)
UINT	GetSelectButton (void)
	取得进度窗口返回时的选择按钮，在窗口停止运行时调用。注意：当使用消息取得按钮状态时，不要使用这个方法取得选择的按钮ID，应用使用UINT uID = (LPARAM)wParam。
ImagingHelper *	GetTitleImage (void)
BOOL	GetTitleText (CMzString &strText)
BOOL	IsContinue (void)
BOOL	KillProgress (void)
	结束弹出进度条
	MzPopupProgress (void)
BOOL	SetBGImage (HBITMAP hbmpBG)
	指定弹出对话框的背景图，hbmpBG将自动被删除无需用户处理
BOOL	SetCurrentValue (INT64 nCur)
BOOL	SetFirstButtonID (UINT uID)
BOOL	SetNoteImage (ImagingHelper *pImage)
	设置进度条下方的显示内容，如果NoteText2为空则Note居中显示； 如果NoteText2不为空则Note和Note2在进度条下方左右两侧
BOOL	SetNoteImage2 (ImagingHelper *pImage)
BOOL	SetNoteText (LPCTSTR lpszText)
BOOL	SetNoteText2 (LPCTSTR lpszText)
BOOL	SetProgressType (BOOL bThin, INT nType)
	设置进度条的显示类型
BOOL	SetRange (INT64 nMin, INT64 nMax)
BOOL	SetTitleImage (ImagingHelper *pImage)
	设置进度条上方的显示内容，居中显示
BOOL	SetTitleText (LPCTSTR lpszText)
BOOL	StartProgress (HWND hWndOwner, BOOL bUseCanelButton=TRUE, BOOL bUseCommandMessage=FALSE, BOOL bBGTansparent=FALSE)
	运行弹出进度条
BOOL	UpdateProgress (BOOL bLazy=TRUE)
	刷新进度条页面显示
virtual	~MzPopupProgress (void)
保护成员
VOID	LockData (VOID)
virtual void	PaintWin (HDC hdcDst, RECT *prcWin, RECT *prcUpdate)
	绘制控件
VOID	UnlockData (VOID)

---

详细描述

进度条对话框

首先需要设置进度条的属性

---

构造及析构函数文档

MzPopupProgress::MzPopupProgress

(

void

)

virtual MzPopupProgress::~MzPopupProgress

(

void

)

[virtual]

---

成员函数文档

BOOL MzPopupProgress::AddBottomButton	(	LPCTSTR	lpszText,
		ImagingHelper *	pImage = NULL,
		ImagingHelper *	pImagePressed = NULL
	)

在进度条的底部添加一个按钮，每次调用StartProgress之前调用，KillProgress后不再保持已添加的按钮

参数:

@return

返回TRUE表示调用成功

UINT MzPopupProgress::GetFirstButtonID

(

void

)

ImagingHelper* MzPopupProgress::GetNoteImage

(

void

)

ImagingHelper* MzPopupProgress::GetNoteImage2

(

void

)

BOOL MzPopupProgress::GetNoteText

(

CMzString &

strText

)

BOOL MzPopupProgress::GetNoteText2

(

CMzString &

strText

)

UINT MzPopupProgress::GetSelectButton

(

void

)

取得进度窗口返回时的选择按钮，在窗口停止运行时调用。注意：当使用消息取得按钮状态时，不要使用这个方法取得选择的按钮ID，应用使用UINT uID = (LPARAM)wParam。

返回:

第一个按钮为1，第二个为2，第三个为3，如果没有选择按钮则返回0

ImagingHelper* MzPopupProgress::GetTitleImage

(

void

)

BOOL MzPopupProgress::GetTitleText

(

CMzString &

strText

)

BOOL MzPopupProgress::IsContinue

(

void

)

BOOL MzPopupProgress::KillProgress

(

void

)

结束弹出进度条

返回:

返回TRUE表示成功结束窗口

VOID MzPopupProgress::LockData

(

VOID

)

[protected]

virtual void MzPopupProgress::PaintWin	(	HDC	hdcDst,
		RECT *	prcWin,
		RECT *	prcUpdate
	)			[protected, virtual]

绘制控件

重载此函数可以自定义控件的绘制

参数:

	hdcDst	目的DC
	prcWin	控件所在区域（以HDC的左上角为原点）
	prcUpdate	需要更新的区域（以HDC的左上角为原点)

重载UiWin。

BOOL MzPopupProgress::SetBGImage

(

HBITMAP

hbmpBG

)

指定弹出对话框的背景图，hbmpBG将自动被删除无需用户处理

参数:

@return

返回TRUE表示调用成功

BOOL MzPopupProgress::SetCurrentValue

(

INT64

nCur

)

BOOL MzPopupProgress::SetFirstButtonID

(

UINT

uID

)

BOOL MzPopupProgress::SetNoteImage

(

ImagingHelper *

pImage

)

设置进度条下方的显示内容，如果NoteText2为空则Note居中显示； 如果NoteText2不为空则Note和Note2在进度条下方左右两侧

BOOL MzPopupProgress::SetNoteImage2

(

ImagingHelper *

pImage

)

BOOL MzPopupProgress::SetNoteText

(

LPCTSTR

lpszText

)

BOOL MzPopupProgress::SetNoteText2

(

LPCTSTR

lpszText

)

BOOL MzPopupProgress::SetProgressType	(	BOOL	bThin,
		INT	nType
	)

设置进度条的显示类型

参数:

	bThin	-- 是否为细进度条
	nType	-- 进度条的类型，如MZV2_PROGRESSBAR_TYPE_TURQUOISE，在UiProgressbar.h中定义

BOOL MzPopupProgress::SetRange	(	INT64	nMin,
		INT64	nMax
	)

BOOL MzPopupProgress::SetTitleImage

(

ImagingHelper *

pImage

)

设置进度条上方的显示内容，居中显示

BOOL MzPopupProgress::SetTitleText

(

LPCTSTR

lpszText

)

BOOL MzPopupProgress::StartProgress	(	HWND	hWndOwner,
		BOOL	bUseCanelButton = TRUE,
		BOOL	bUseCommandMessage = FALSE,
		BOOL	bBGTansparent = FALSE
	)

运行弹出进度条

参数:

	hWndOwner	-- 弹出窗口的父窗口句柄
	bUseCanelButton	-- 是否使用取消按钮
	bUseCommandMessage	-- 设为TRUE则用户点击按钮时hWndOwner窗口可以接收到MZ_WM_COMMAND消息，否则自动结束窗口
	bBGTansparent	-- 是否使用完全透明的背景

返回:

返回TRUE表示窗口启动成功

VOID MzPopupProgress::UnlockData

(

VOID

)

[protected]

BOOL MzPopupProgress::UpdateProgress

(

BOOL

bLazy = TRUE

)

刷新进度条页面显示

参数:

bLazy

-- 设为TRUE则不会立即刷新界面只是设置刷新标志，否则立即刷新。

返回:

返回TRUE表示刷新成功

---

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

• MzPopupProgress.h