共用方式為

多頁文件

  • 發行項

本文描述 Windows 列印通訊協定並說明如何列印包含多個頁面的文件。 本文包括下列主題：

列印通訊協定

列印多頁文件時，架構會以下列方式與檢視互動。 首先，架構會顯示 [ 列印 ] 對話方塊、建立印表機的裝置內容，並呼叫 CDC 物件的 StartDoc 成員函式 。 然後，針對檔的每個頁面，架構會呼叫 物件的 StartPage 成員函 CDC 式、指示檢視物件列印頁面，以及呼叫 EndPage 成員函式。 如果印表機模式必須在啟動特定頁面之前變更，檢視會呼叫 ResetDC ，這會更新 包含新印表機模式資訊的 DEVMODE 結構。 列印整個檔時，架構會呼叫 EndDoc 成員函式。

覆寫檢視類別函式

CView 類別會定義數個成員函式，這些函式是由架構在列印期間呼叫。 藉由在檢視類別中覆寫這些函式，您可以提供架構的列印邏輯和檢視類別的列印邏輯之間的連接。 下表列出這些成員函式。

列印的 CView 可覆寫函式

名稱 覆寫的原因
OnPreparePrinting 在 [列印] 對話方塊中插入值，特別是文件的長度
OnBeginPrinting 配置字型或其他 GDI 資源
OnPrepareDC 為指定的頁面調整裝置內容的屬性，或在列印時分頁
OnPrint 列印指定頁面
OnEndPrinting 解除配置 GDI 資源

您也可以在其他函式中執行列印相關的處理，不過，這些函式可用來驅動列印處理序。

下圖說明列印處理序中包含的步驟，並顯示所呼叫的每個 CView 列印成員函式。 本文的其餘部分將詳細說明大部分的步驟。 列印程式的其他部分會在配置 GDI 資源 一文 中說明。

Printing loop process.
列印迴圈

分頁

架構會將列印工作的大部分資訊儲存在 CPrintInfo 結構中 。 CPrintInfo 中有多個值與分頁有關，這些值的存取方式如下表所示。

在 CPrintInfo 中儲存頁碼資訊。

成員變數或

函式名稱		 參考的頁碼
GetMinPage/SetMinPage 文件的第一頁
GetMaxPage/SetMaxPage 文件的最後一頁
GetFromPage 要列印的第一頁
GetToPage 要列印的最後一頁
m_nCurPage 目前列印的頁面

頁碼從 1 開始，第一頁為 1，而不是 0。 如需 CPrintInfo 和其他成員 的詳細資訊，請參閱 MFC 參考 。

在列印程式開始時，架構會呼叫檢視的 OnPreparePrinting 成員函式，並將指標傳遞至 CPrintInfo 結構。 應用程式精靈提供 的 OnPreparePrinting 實作，該實作會呼叫 DoPreparePrinting ，這是 的另一個成員函式 CView 。 DoPreparePrinting 是一個顯示 [列印] 對話方塊並建立印表機內容的函式。

此時應用程式不知道文件有多少頁。 它會使用預設值 1 和 0xFFFF 做為文件的第一頁及最後一頁。 如果您知道檔有多少頁，請先覆寫 OnPreparePrinting 並呼叫 [SetMaxPage]--brokenlink---（reference/cprintinfo-class.md#setmaxpage）結構， CPrintInfo 再將它傳送至 DoPreparePrinting 。 這可讓您指定文件的長度。

DoPreparePrinting 接著會顯示 [列印] 對話方塊。 當它傳回時，CPrintInfo 結構會包含使用者指定的值。 如果使用者只想要列印某個選取範圍的頁面，則可以在 [列印] 對話方塊中指定開始和結束頁碼。 架構會使用 GetFromPage CPrintInfo 的 和 GetToPage 函式來 擷取這些值。 如果使用者未指定列印範圍，架構會呼叫 GetMinPage 和 GetMaxPage，並使用傳回的值列印整份文件。

若要列印檔案的每個頁面，架構會呼叫檢視類別 OnPrepareDC 和 OnPrint 中的兩個成員函式，並傳遞每個函式兩個參數：CDC 物件的指標 和結構的指標 CPrintInfo 。 每次架構呼叫 OnPrepareDC 和 OnPrint 時，都會在 結構m_nCurPage 成員 CPrintInfo 中 傳遞不同的值。 在這種方式下，架構會指示檢視所要列印的頁面。

OnPrepareDC 成員函式也用於螢幕顯示。 在繪製之前，它會調整裝置內容。 OnPrepareDC 的功能與列印類似，不過其中有兩個差異：首先，CDC 物件代表印表機內容而非螢幕裝置內容，其次，CPrintInfo 物件會做為第二個參數傳遞 （此參數為 呼叫螢幕顯示時 OnPrepareDC 為 Null 。覆寫 OnPrepareDC 以根據要列印的頁面來調整裝置內容。 例如，您可以捲動檢視區原點和裁剪區域確定將會印出文件的適當部分。

OnPrint 成員函式會執行頁面的實際列印。 本文說明如何完成 預設列印，說明架構如何使用印表機裝置內容呼叫 OnDraw 來執行列印。 更明確地說，架構會以 OnPrint 結構和裝置內容呼叫 CPrintInfo，而 OnPrint 會傳遞裝置內容至 OnDraw。 覆寫 OnPrint 以執行應該只有在列印期間完成且不進行螢幕顯示的所有轉譯。 例如，若要列印頁首或頁尾（如需詳細資訊，請參閱頁首和頁尾 一文 ）。 接著再從 OnDraw 的覆寫呼叫 OnPrint 來轉譯螢幕顯示和列印的常用部分。

針對螢幕顯示和列印執行轉譯的事實 OnDraw ，表示您的應用程式是 WYSIWYG：「您看到的就是您得到的內容。不過，假設您未撰寫 WYSIWYG 應用程式。 例如，考慮一個使用以粗體字型來列印，但是在螢幕上顯示表示粗體文字之控制碼的文字編輯器。 在這種情況下，您只會使用 OnDraw 進行螢幕顯示。 當您覆寫 OnPrint 時，會使用不同繪圖函式的呼叫取代 OnDraw 的呼叫。 該函式會使用您未顯示在螢幕上的屬性，以在紙張上顯示的方式繪製文件。

印表機頁面與檔頁面

當您參考頁碼時，區別頁面的印表機概念與頁面的文件概念有時候是必要的。 從印表機檢視的角度來說，一個頁面就是一張紙。 不過，一張紙不一定等於文件的一個頁面。 例如，如果您列印的是會摺疊紙張的報紙，則一張紙可能同時包含文件的第一頁和最後一頁。 同樣地，如果您列印的是試算表，則文件根本不是由頁面所組成。 相反地，一張紙可能包含第 1 列到第 20 列，第 6 行至第 10 行。

CPrintInfo 結構中的所有 頁碼都會參考印表機頁面。 架構會在每張紙張通過印表機時呼叫 OnPrepareDC 和 OnPrint。 當您覆寫 OnPreparePrinting 函 式以指定檔的長度時，您必須使用印表機頁面。 如果其中具有一對一的對應關係 (也就是印表機頁面等於文件頁面)，則這是容易的。 另一方面，如果文件頁面和印表機頁面無法直接對應，您必須在兩者之間進行轉譯。 例如，請考慮列印試算表的情形。 當覆寫 OnPreparePrinting 時，您必須計算列印整份試算表需要多少紙張，並在呼叫 SetMaxPage 的 CPrintInfo 成員函式時使用該值。 同樣地，在覆寫 OnPrepareDC 時，您必須將 m_nCurPage轉譯 成出現在該特定工作表的資料列和資料行範圍，然後據以調整檢視區原點。

列印時間分頁

在某些狀況下，您的檢視類別在實際列印前無法事先知道文件的長度。 例如，假設您的應用程式不是 WYSIWYG，則螢幕上文件的長度與列印時的長度無法對應。

當您覆寫 檢視類別的 OnPreparePrinting 時發生問題：您無法將值傳遞至 SetMaxPage CPrintInfo 結構的函式，因為您不知道檔的長度。 如果使用者在使用 [列印] 對話方塊未指定停止的頁碼，架構就不知道應於何時停止列印迴圈。 唯一判斷何時停止列印迴圈的方式是印出文件然後看它何時結束。 您的檢視類別必須在列印時檢查文件的結尾，然後在到達尾端時告知架構。

架構依賴檢視類別的 OnPrepareDC 函式來告知其何時停止。 每次呼叫 OnPrepareDC 之後，架構會檢查名為 m_bContinuePrinting 的結構成員 CPrintInfo 。 其預設值為 TRUE。 只要維持不變，架構就會繼續列印迴圈。 如果設定為 FALSE ，架構就會停止。 若要執行列印時間分頁，請覆寫 OnPrepareDC 以檢查檔結尾是否已到達，並將m_bContinuePrinting 設定 為 FALSE 。

如果目前的頁面大於 1，則預設實作 OnPrepareDC 集 m_bContinuePrinting 為 FALSE 。 這表示，如果未指定文件的長度，架構會假設文件的長度為一頁。 這樣一來，您必須在呼叫 OnPrepareDC 的基底類別版本時特別小心。 請勿假設 在呼叫基類版本之後，m_bContinuePrinting 為 TRUE 。

您想要深入瞭解什麼

另請參閱

列印
CView 類別
CDC 類別