Posted on 2008-12-07 20:01
牧云人 閱讀(702)
評(píng)論(0) 編輯 收藏 引用 所屬分類:
C/C++
翻譯：viiv（viiv at 163.com）
原文：http://blogs.msdn.com/vcblog/archive/2008/12/04/ctaskdialog-an-alternative-to-the-simple-message-box.aspx
大家好：
首先讓我自我介紹一下，我是Lukasz Chodorski，Visual C++ Libraries團(tuán)隊(duì)中的一名新軟件設(shè)計(jì)工程師（SDE）。這次我給大家?guī)淼氖荕FC庫中的CTaskDialog消息框類，它包裝了一組新的Windows API。CTaskDialog究竟是什么？
它是一個(gè)能根據(jù)您的需求易于客制化的類/組件。您可以在CTaskDialog中添加如下的元素：
- 窗體的標(biāo)題
- 應(yīng)用程序圖標(biāo)
- 應(yīng)用程序提示
- 內(nèi)容
- 進(jìn)度條
- 單選按鈕
- 自定義按鈕
- 展開/折疊按鈕
- 可驗(yàn)證的復(fù)選框
- 頁腳圖標(biāo)
- 頁腳文本
- 普通按鈕
正如你所看到的，這里有很多的配置選項(xiàng)可供選擇。使用最簡(jiǎn)單的配置時(shí)，它的行為就像一個(gè)經(jīng)典的消息框，但是在更多高級(jí)應(yīng)用中它有進(jìn)度條，自定義按鈕或者單選按鈕。它甚至可以在其上設(shè)置超鏈接或是建立簡(jiǎn)單的向?qū)?yīng)用。當(dāng)然，開發(fā)者可以使用MFC通常的執(zhí)行機(jī)制來響應(yīng)對(duì)話框中的事件。
CTaskDialog提供了像往常一樣的方法用以創(chuàng)建和初始化控件。例如：
|
CTaskDialog dlg(_T("A CTaskDialog presents information in a clear and consistent way."),
???????????????????? _T("How much do you like CTaskDialog?"), _T("Sample CTaskDialog"), 0,
???????????????????? TDF_ENABLE_HYPERLINKS | TDF_USE_COMMAND_LINKS , _T("I hope you like it!"));
?
?
?????? dlg.AddCommandControl( 10, _T("&Use it!\nIt's the best dialog you can have!"));
?????? dlg.AddCommandControl( 20, _T("&Maybe?\nDon't you want to try it?"));
?????? dlg.AddCommandControl( 25, _T("&No way!\nI'm not going to use it!"));
??????
?
?????? dlg.AddRadioButton( 3, _T("Lots"));
?????? dlg.AddRadioButton( 7, _T("A little"));
?????? dlg.AddRadioButton( 4, _T("Not at all"));
??????
?
??? dlg.SetMainIcon(TD_SHIELD_ICON);
?????? dlg.SetFooterIcon(TD_INFORMATION_ICON);
??????
?
?????? INT_PTR nResult = dlg.DoModal();
|
它創(chuàng)建了如下樣式的窗體：
或者您也可以使用如下的函數(shù)進(jìn)行創(chuàng)建：
|
INT_PTR nResult = CTaskDialog::ShowDialog(
???????????????????? _T("Don't spend to much time on code, write only one line and get your CTaskDialog!"),
???????????????????? _T("Where do you like to go?"),
???????????????????? _T("One line command"), IDS_RADIO_START, IDS_RADIO_START + 3, TDCBF_CANCEL_BUTTON);
|
????注意這些新特性在Windows Vista系統(tǒng)才被引入，所以在編程時(shí)需要將_WIN32_WINNT宏定義為0x0600（標(biāo)識(shí)Windows Vista）或更高。
????當(dāng)然，在targetver.h文件中默認(rèn)值已經(jīng)為Windows Vista。您應(yīng)該注意到Windows提供了兩個(gè)comctl32.dll庫（版本5.x.x.x和6.x.x.x）。CTaskDialog需要版本6.x.x.x或更高，所以VC10需要在manifest文件中加入該配置。
????當(dāng)您運(yùn)行時(shí)得到這樣的錯(cuò)誤："不能定位xxx在動(dòng)態(tài)鏈接庫COMCTL32.DLL中"。這意味著您的操作系統(tǒng)在運(yùn)行應(yīng)用程序時(shí)使用了錯(cuò)誤的動(dòng)態(tài)鏈接庫，通常是由于在manifest文件中使用了錯(cuò)誤的assemblies配置（外部設(shè)置或內(nèi)部設(shè)置中的一個(gè)）。
????強(qiáng)制讓W(xué)indows使用適合版本的動(dòng)態(tài)庫的方法是將如下的配置段加入到manifest文件中：
|
<dependency>
??? <dependentAssembly>
????? <assemblyIdentity
????????? type="win32"
????????? name="Microsoft.Windows.Common-Controls"
????????? version="6.0.0.0"
????????? processorArchitecture="x86"
????????? publicKeyToken="6595b64144ccf1df"
????????? language="*"
??????? />
??? </dependentAssembly>
? </dependency>
|
????由于版本低于Windows Vista的操作系統(tǒng)不支持TaskDialog的API，所以您需要使用CTaskDialog::IsSupported()方法來檢查是否可以使用CTaskDialog對(duì)話框。通常是這樣的結(jié)構(gòu)：
|
if (CTaskDialog::IsSupported())?
{
?????? ... //call CTaskDialog
}
else MessageBox();? //調(diào)用經(jīng)典的消息對(duì)話框
|
????這里描述的特性是微軟預(yù)發(fā)布軟件Visual Studio 2010及.NET Framework 4.0社區(qū)技術(shù)預(yù)覽版(CTP)中的一部分，您可以通過如下的網(wǎng)址進(jìn)行下載和體驗(yàn)：http://www.microsoft.com/downloads/details.aspx?FamilyId=922B4655-93D0-4476-BDA4-94CF5F8D4814
????這個(gè)使用了CTaskDialog的樣例工程被放置在了Visual Studio 2010的樣例文件夾中，希望通過這些介紹您能積極的使用CTaskDialog，同時(shí)歡迎您的反饋信息?
謝謝！
Lukasz