共用方式為


關於工作對話框

工作對話框是一個對話框,可用來顯示資訊,並從使用者接收簡單的輸入。 就像消息框一樣,它會根據您設定的參數,由作系統格式化。 不過,工作對話框具有比消息框更多的功能。

注意

工作對話框需要單個線程Apartment (STA) 模型。

 

工作對話框的元件

工作對話框包含數個元素,其中多數是可選的。 下圖顯示工作對話框的各個部分。

顯示各種按鈕的視窗螢幕快照,包括折疊控件文字旁的螢幕快照

在下圖中,使用者已按下折迭控件文字旁邊的按鈕,導致替代文字顯示在該處和頁尾。

上一個視窗的螢幕快照,但有兩行展開的控件文字

圖例顯示下列部分:

部分 描述 TASKDIALOGCONFIG 成員
窗口標題 視窗的標題。 pszWindowTitle
主要圖示 表示工作對話框用途的大型圖示。 hMainIconpszMainIcon
主要指示 主體文字。 pszMainInstruction
內容 額外的文字。 pszContent
進度列 顯示某些工作進度的動畫列。 dwFlags
單選按鈕 應用程式定義的使用者選項。 pRadioButtons
自訂按鈕 不是常見的按鈕。 這可以是一般按鈕,或如圖所示的指令連結,最多顯示兩行文字。 pButtons
展開/折疊按鈕 具有按鈕功能的控制項,可以在應用程式定義的折疊控制文字(例如「查看更多詳細資料」)與展開控制文字之間切換,展開的文字可以顯示在兩行或更多行上。 當控件文字展開時,也會在內容文字之後顯示 pszExpandedInformation 的額外文字,或在頁尾中顯示(如第二個圖例所示)。 pszCollapsedControlTextpszExpandedControlText
驗證複選框 勾選框,伴隨著應用程式定義的文字,例如「不要再次顯示此對話框」等簡單選項。 pszVerificationText
頁尾圖示 表示頁尾文字用途的小型圖示。 hFooterIconpszFooterIcon
頁尾文字 其他文字。 在圖例中,文字包含超連結。 pszFooter
一般按鈕 標準按鈕;圖例中的 [確定] 按鈕。 dwCommonButtons