Funzione EndPage (wingdi.h)

  • Articolo

La funzione EndPage notifica al dispositivo che l'applicazione ha completato la scrittura in una pagina. Questa funzione viene in genere usata per indirizzare il driver del dispositivo a passare a una nuova pagina.

Sintassi

int EndPage(
  [in] HDC hdc
);

Parametri

[in] hdc

Handle al contesto del dispositivo per il processo di stampa.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è maggiore di zero.

Se la funzione ha esito negativo, il valore restituito è minore o uguale a zero.

Commenti

Nota Si tratta di una funzione di blocco o sincrona e potrebbe non restituire immediatamente. La velocità con cui questa funzione restituisce dipende da fattori di runtime, ad esempio lo stato di rete, la configurazione del server di stampa e l'implementazione del driver della stampante, fattori difficili da prevedere durante la scrittura di un'applicazione. La chiamata a questa funzione da un thread che gestisce l'interazione con l'interfaccia utente potrebbe rendere l'applicazione non rispondente.
 
Usare la funzione ResetDC per modificare la modalità dispositivo, se necessario, dopo aver chiamato la funzione EndPage . Si noti che una chiamata a ResetDC reimposta tutti gli attributi del contesto del dispositivo ai valori predefiniti. Né EndPage né StartPage reimposta gli attributi del contesto del dispositivo. Gli attributi del contesto del dispositivo rimangono costanti nelle pagine successive. Non è necessario ri selezionare gli oggetti e configurare nuovamente la modalità di mapping prima di stampare la pagina successiva; In questo modo, tuttavia, produrrà gli stessi risultati e ridurrà le differenze di codice tra le versioni di Windows.

Quando una pagina in un file spooling supera circa 350 MB, potrebbe non riuscire a stampare e non inviare un messaggio di errore. Ad esempio, questo può verificarsi quando si stampano file EMF di grandi dimensioni. Il limite delle dimensioni della pagina dipende da molti fattori, tra cui la quantità di memoria virtuale disponibile, la quantità di memoria allocata dai processi chiamanti e la quantità di frammentazione nell'heap del processo.

Esempio

Per un programma di esempio che usa questa funzione, vedere Procedura: Stampa con l'API di stampa GDI.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wingdi.h (include Windows.h)
Libreria Gdi32.lib
DLL Gdi32.dll

Vedi anche

Funzioni dell'API spooler di stampa

Stampa

ResetDC

StartPage