共用方式為

如何：顯示列印工作進度

  • 發行項

本主題描述如何向使用者顯示列印工作進度，並讓他們選擇取消目前正在執行的列印工作。

概觀

列印進度對話方塊程式通常會執行下列函式。

  • 向使用者顯示列印工作進度。
  • 啟動列印處理執行緒。
  • 顯示 [取消] 按鈕，讓使用者可以在列印工作完成之前停止列印工作。

嚴格來說，列印進度對話方塊程式必須執行的唯一動作是向使用者顯示列印工作進度。 不過，由於上述清單中的其他兩個函式非常相關，因此也已包含在本課程模組中。

顯示列印工作進度

列印進度對話方塊程式會處理下列視窗訊息。

  • WM_INITDIALOG

    初始化對話方塊使用的控制項。

  • WM_SETCURSOR

    當使用者能夠取消列印工作時，將游標設定為指標，並在列印工作位於無法取消的點時，將游標設定為等候游標。

  • USER_PRINT_START_PRINTING

    設定列印工作的進度列參數，並建立列印執行緒以開始處理列印工作。

    這是應用程式特定的視窗訊息。

  • WM_COMMAND - IDCANCEL

    設定 cancel 事件，告知列印處理執行緒取消列印工作。

  • USER_PRINT_STATUS_UPDATE

    更新進度列和狀態文字，以顯示列印工作的目前狀態。

    這是應用程式特定的視窗訊息。

  • USER_PRINT_CLOSING

    設定進度對話方塊中的關閉狀態文字，以指出列印工作正在關閉。

    這是應用程式特定的視窗訊息。

  • USER_PRINT_COMPLETE

    向使用者顯示「列印工作完成」訊息，並釋放此列印工作中使用的控制碼和事件。

    這是應用程式特定的視窗訊息。