CTaskDialog 類別

的運作方式訊息方塊，但的快顯對話方塊可以顯示其他資訊給使用者。 CTaskDialog 也包含收集的資訊功能從使用者。

class CTaskDialog : public CObject

成員

建構函式

CTaskDialog::CTaskDialog

建構 CTaskDialog 物件。

方法

CTaskDialog::AddCommandControl	將命令按鈕控制項加入至 CTaskDialog。
CTaskDialog::AddRadioButton	將選項按鈕加入至 CTaskDialog。
CTaskDialog::ClickCommandControl	按一下 命令按鈕控制項或一般按鈕以程式設計的方式設定屬性。
CTaskDialog::ClickRadioButton	按一下 選項按鈕的方式。
CTaskDialog::DoModal	顯示CTaskDialog。
CTaskDialog::GetCommonButtonCount	擷取可用常用的按鈕數目。
CTaskDialog::GetCommonButtonFlag	轉換標準 Windows 按鈕通用按鈕類型與 CTaskDialog 類別。
CTaskDialog::GetCommonButtonId	一般按鈕類型的轉換無法對應與 CTaskDialog 類別至標準 Windows 按鈕。
CTaskDialog::GetOptions	傳回這 CTaskDialog的選項旗標。
CTaskDialog::GetSelectedCommandControlID	傳回所選取命令的按鈕控制項。
CTaskDialog::GetSelectedRadioButtonID	傳回所選取的選項按鈕。
CTaskDialog::GetVerificationCheckboxState	擷取驗證核取方塊的狀態。
CTaskDialog::IsCommandControlEnabled	決定命令按鈕控制項或一般按鈕是否已啟用。
CTaskDialog::IsRadioButtonEnabled	判斷選項按鈕是否已啟用。
CTaskDialog::IsSupported	判斷執行應用程式的電腦是否支援 CTaskDialog。
CTaskDialog::LoadCommandControls	若要將命令按鈕控制項會使用資料來自字串資料表。
CTaskDialog::LoadRadioButtons	將選項按鈕使用資料來自字串資料表。
CTaskDialog::NavigateTo	會將焦點傳送至另一個 CTaskDialog。
CTaskDialog::OnCommandControlClick	當使用者按一下命令按鈕控制項時，架構會呼叫這個方法。
CTaskDialog::OnCreate	在建立 CTaskDialog之後，架構會呼叫這個方法。
CTaskDialog::OnDestroy	其 CTaskDialog終結之前，架構會呼叫這個方法。
CTaskDialog::OnExpandButtonClick	當使用者按一下展開按鈕時，架構會呼叫這個方法。
CTaskDialog::OnHelp	以使用者要求說明時，架構會呼叫這個方法。
CTaskDialog::OnHyperlinkClick	當使用者按一下超連結時，架構會呼叫這個方法。
CTaskDialog::OnInit	當 CTaskDialog 初始化時，架構會呼叫這個方法。
CTaskDialog::OnNavigatePage	當使用者將焦點有關在 CTaskDialog控制項時，架構會呼叫這個方法。
CTaskDialog::OnRadioButtonClick	在使用者選取選項按鈕控制項時，架構會呼叫這個方法。
CTaskDialog::OnTimer	當計時器過期時，架構會呼叫這個方法。
CTaskDialog::OnVerificationCheckboxClick	當使用者按一下驗證核取方塊時，架構會呼叫這個方法。
CTaskDialog::RemoveAllCommandControls	從移除所有 CTaskDialog排列控制項。
CTaskDialog::RemoveAllRadioButtons	從 CTaskDialog移除所有選項按鈕。
CTaskDialog::SetCommandControlOptions	更新在 CTaskDialog的命令按鈕控制項。
CTaskDialog::SetCommonButtonOptions	更新會啟用一般按鈕的子集 UAC 需要提高權限。
CTaskDialog::SetCommonButtons	將一般的按鈕加入至 CTaskDialog。
CTaskDialog::SetContent	CTaskDialog更新的內容。
CTaskDialog::SetDefaultCommandControl	指定預設命令按鈕控制項。
CTaskDialog::SetDefaultRadioButton	指定預設選項按鈕。
CTaskDialog::SetDialogWidth	調整 CTaskDialog的寬度。
CTaskDialog::SetExpansionArea	更新 CTaskDialog展開的區域。
CTaskDialog::SetFooterIcon	更新 CTaskDialog尾圖示。
CTaskDialog::SetFooterText	更新在 CTaskDialog的頁尾文字。
CTaskDialog::SetMainIcon	更新 CTaskDialog的主要圖示。
CTaskDialog::SetMainInstruction	更新 CTaskDialog主要的指示。
CTaskDialog::SetOptions	設定 CTaskDialog的選項。
CTaskDialog::SetProgressBarMarquee	設定 CTaskDialog 之跑馬燈並將其加入至 對話方塊。
CTaskDialog::SetProgressBarPosition	調整進度列的位置。
CTaskDialog::SetProgressBarRange	調整進度列的範圍。
CTaskDialog::SetProgressBarState	設定進度列的狀態並將它顯示在 CTaskDialog。
CTaskDialog::SetRadioButtonOptions	啟用或停用選項按鈕。
CTaskDialog::SetVerificationCheckbox	設定驗證核取方塊的選取狀態。
CTaskDialog::SetVerificationCheckboxText	在驗證核取方塊的右邊設定文字。
CTaskDialog::SetWindowTitle	設定 CTaskDialog的標題。
CTaskDialog::ShowDialog	建立和顯示 CTaskDialog。
CTaskDialog::TaskDialogCallback	架構會呼叫這個回應各種 Windows 訊息。

資料成員

m_aButtons	陣列 CTaskDialog的命令按鈕控制項。
m_aRadioButtons	CTaskDialog的選項按鈕控制項。
m_bVerified	TRUE 表示驗證核取方塊被選取， FALSE 表示未啟用。
m_footerIcon	在 CTaskDialog的頁尾的圖示。
m_hWnd	的控制代碼 CTaskDialog的視窗。
m_mainIcon	CTaskDialog的主要圖示。
m_nButtonDisabled	表示遮罩的一般按鈕已停用。
m_nButtonElevation	表示遮罩的一般按鈕 UAC 要求提高權限。
m_nButtonId	將選取的命令按鈕控制項的 ID。
m_nCommonButton	表示遮罩的一般按鈕在 CTaskDialog隨即顯示。
m_nDefaultCommandControl	選取命令按鈕控制項的 ID，當 CTaskDialog 隨即顯示。
m_nDefaultRadioButton	選取選項按鈕控制項的 ID，當 CTaskDialog 隨即顯示。
m_nFlags	表示 CTaskDialog選項的遮罩。
m_nProgressPos	進度列的目前位置。 這個值必須介於 m_nProgressRangeMin 和 m_nProgressRangeMax 之間。
m_nProgressRangeMax	進度列的最大值。
m_nProgressRangeMin	進度列的最小值。
m_nProgressState	進度列的狀態。 如需詳細資訊，請參閱 CTaskDialog::SetProgressBarState。
m_nRadioId	選項按鈕控制項的 ID。
m_nWidth	CTaskDialog 的寬度 (以像素為單位)。
m_strCollapse	在 CTaskDialog 展開方塊右側顯示的字串，在展開隱藏的資訊。
m_strContent	CTaskDialog內容的字串。
m_strExpand	在 CTaskDialog 展開方塊右側顯示的字串，在展開的相關資訊隨即顯示。
m_strFooter	CTaskDialog的頁尾。
m_strInformation	CTaskDialog的展開的資訊。
m_strMainInstruction	CTaskDialog主要的指示。
m_strTitle	CTaskDialog 的標題。
m_strVerification	在 CTaskDialog 驗證核取方塊的右邊顯示的字串。

備註

CTaskDialog 類別取代標準的 Windows 訊息方塊並具有其他功能 (例如向使用者收集資訊的新控制項。 這個類別會在 Visual Studio 2010的 MFC 程式庫。 CTaskDialog 可用開始 Windows Vista。 舊版 Windows 無法顯示 CTaskDialog 物件。 使用 CTaskDialog::IsSupported 在執行階段判斷目前使用者是否可以顯示工作對話方塊。 標準 Windows 訊息方塊中 Visual Studio 2010仍支援。

您可以使用 Unicode 程式庫時，，，只有當您建置應用程式 CTaskDialog 可用。

CTaskDialog 有兩個不同的建構函式。 建構函式可讓您指定兩個命令按鈕和最多六個標準按鈕控制項。 在建立 CTaskDialog之後，您可以將多個命令按鈕。 第二個建構函式不支援任何命令按鈕，不過，您可以加入不限數目的標準按鈕控制項。 如需建構函式的詳細資訊，請參閱 CTaskDialog::CTaskDialog。

下圖示範一個範例 CTaskDialog 說明一些控制項的位置。

CTaskDialog 範例

需求

**最小必要的作業系統:**Windows Vista

標題: afxtaskdialog.h

請參閱

工作

逐步解說： 在應用程式中加入 CTaskDialog

參考

CObject 類別

階層架構圖

其他資源

MFC 類別