startPage 函式 (wingdi.h)

StartPage 函式會準備印表機驅動程式以接受數據。

語法

int StartPage(
  [in] HDC hdc
);

參數

[in] hdc

列印作業之裝置內容的句柄。

傳回值

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

如果函式失敗，傳回值會小於或等於零。

備註

注意 這是封鎖或同步函式，可能不會立即傳回。 此函式傳回的速度取決於運行時間因素，例如網路狀態、列印伺服器設定和印表機驅動程序實作—撰寫應用程式時難以預測的因素。 從管理與使用者介面互動的線程呼叫此函式，可能會使應用程式看起來沒有回應。

 

系統會停用 StartPage 和 EndPage 函式呼叫之間的 ResetDC 函式。 這表示除了頁面界限以外，您無法變更裝置模式。 呼叫 EndPage 之後，您可以視需要呼叫 ResetDC 來變更裝置模式。 請注意，重 設DC 的呼叫會將所有裝置內容屬性重設為預設值。

EndPage 或 StartPage 都不會重設裝置內容屬性。 後續頁面的裝置內容屬性會維持不變。 在列印下一頁之前，您不需要重新選取物件並再次設定對應模式;不過，這麼做會產生相同的結果，並減少 Windows 版本之間的程式代碼差異。

範例

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

規格需求

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

另請參閱

EndPage

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

列印

ResetDC