工作對話框是一個對話框,可用來顯示資訊,並從使用者接收簡單的輸入。 就像消息框一樣,它會根據您設定的參數,由作系統格式化。 不過,工作對話框具有比消息框更多的功能。
注意
工作對話框需要單個線程Apartment (STA) 模型。
工作對話框的元件
工作對話框包含數個元素,其中多數是可選的。 下圖顯示工作對話框的各個部分。
在下圖中,使用者已按下折迭控件文字旁邊的按鈕,導致替代文字顯示在該處和頁尾。
圖例顯示下列部分:
| 部分 | 描述 | TASKDIALOGCONFIG 成員 |
|---|---|---|
| 窗口標題 | 視窗的標題。 | pszWindowTitle |
| 主要圖示 | 表示工作對話框用途的大型圖示。 | hMainIcon 或 pszMainIcon |
| 主要指示 | 主體文字。 | pszMainInstruction |
| 內容 | 額外的文字。 | pszContent |
| 進度列 | 顯示某些工作進度的動畫列。 | dwFlags |
| 單選按鈕 | 應用程式定義的使用者選項。 | pRadioButtons |
| 自訂按鈕 | 不是常見的按鈕。 這可以是一般按鈕,或如圖所示的指令連結,最多顯示兩行文字。 | pButtons |
| 展開/折疊按鈕 | 具有按鈕功能的控制項,可以在應用程式定義的折疊控制文字(例如「查看更多詳細資料」)與展開控制文字之間切換,展開的文字可以顯示在兩行或更多行上。 當控件文字展開時,也會在內容文字之後顯示 pszExpandedInformation 中 的額外文字,或在頁尾中顯示(如第二個圖例所示)。 | pszCollapsedControlText 和 pszExpandedControlText |
| 驗證複選框 | 勾選框,伴隨著應用程式定義的文字,例如「不要再次顯示此對話框」等簡單選項。 | pszVerificationText |
| 頁尾圖示 | 表示頁尾文字用途的小型圖示。 | hFooterIcon 或 pszFooterIcon |
| 頁尾文字 | 其他文字。 在圖例中,文字包含超連結。 | pszFooter |
| 一般按鈕 | 標準按鈕;圖例中的 [確定] 按鈕。 | dwCommonButtons |