共用方式為


EndPage 函式 (wingdi.h)

EndPage函式會通知裝置應用程式已完成寫入頁面。 此函式通常用來指示設備磁碟機前進到新的頁面。

語法

int EndPage(
  [in] HDC hdc
);

參數

[in] hdc

列印工作之裝置內容的控制碼。

傳回值

如果函式成功,則傳回值大於零。

如果函式失敗,則傳回值小於或等於零。

備註

注意 這是封鎖或同步函式,可能不會立即傳回。 此函式傳回的速度取決於執行時間因素,例如網路狀態、列印伺服器組態和印表機驅動程式實作—撰寫應用程式時難以預測的因素。 從管理與使用者介面互動的執行緒呼叫此函式,可能會讓應用程式看起來沒有回應。
 
如有必要,請使用 ResetDC 函式在呼叫 EndPage 函式之後變更裝置模式。 請注意, ResetDC 呼叫會將所有裝置內容屬性重設為預設值。 EndPageStartPage都不會重設裝置內容屬性。 後續頁面的裝置內容屬性會維持不變。 您不需要重新選取物件,並在列印下一頁之前再次設定對應模式;不過,這樣做會產生相同的結果,並減少 Windows 版本之間的程式碼差異。

當多工緩衝處理檔案中的頁面超過大約 350 MB 時,它可能無法列印,而不會傳送錯誤訊息。 例如,列印大型 EMF 檔案時,可能會發生這種情況。 頁面大小限制取決於許多因素,包括可用的虛擬記憶體數量、呼叫進程所配置的記憶體數量,以及進程堆積中的片段數量。

範例

如需使用此函式的範例程式,請參閱 How To: Print Using the GDI Print API

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 wingdi.h (包含 Windows.h)
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱

列印多工緩衝處理器 API 函式

列印

ResetDC

StartPage