StartPage-Funktion (wingdi.h)

Artikel
03/13/2024

Die StartPage-Funktion bereitet den Druckertreiber auf die Annahme von Daten vor.

Syntax

int StartPage(
  [in] HDC hdc
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext für den Druckauftrag.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert größer als 0 (null).

Wenn die Funktion fehlschlägt, ist der Rückgabewert kleiner oder gleich 0.

Hinweise

Hinweis Dies ist eine blockierende oder synchrone Funktion, die möglicherweise nicht sofort zurückgegeben wird. Wie schnell diese Funktion zurückgibt, hängt von Laufzeitfaktoren wie Netzwerk-status, Druckerserverkonfiguration und Druckertreiberimplementierung ab– Faktoren, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Das Aufrufen dieser Funktion aus einem Thread, der die Interaktion mit der Benutzeroberfläche verwaltet, könnte dazu führen, dass die Anwendung nicht mehr reagiert.

Das System deaktiviert die ResetDC-Funktion zwischen Aufrufen der Funktionen StartPage und EndPage . Dies bedeutet, dass Sie den Gerätemodus nur an Seitengrenzen ändern können. Nachdem Sie EndPage aufgerufen haben, können Sie ResetDC aufrufen, um den Gerätemodus bei Bedarf zu ändern. Beachten Sie, dass bei einem Aufruf von ResetDC alle Gerätekontextattribute auf die Standardwerte zurückgesetzt werden.

Weder EndPage noch StartPage setzen die Gerätekontextattribute zurück. Gerätekontextattribute bleiben auf nachfolgenden Seiten konstant. Sie müssen Objekte nicht erneut auswählen und den Zuordnungsmodus erneut einrichten, bevor Sie die nächste Seite drucken. Dies führt jedoch zu den gleichen Ergebnissen und verringert die Codeunterschiede zwischen den Versionen von Windows.

Beispiele

Ein Beispielprogramm, das diese Funktion verwendet, finden Sie unter Vorgehensweise: Drucken mithilfe der GDI-Druck-API.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll