Funzione PrintWindow (winuser.h)

La funzione PrintWindow copia una finestra visiva nel contesto di dispositivo (DC) specificato, in genere un controller di dominio della stampante.

Sintassi

BOOL PrintWindow(
  HWND hwnd,
  HDC  hdcBlt,
  UINT nFlags
);

Parametri

hwnd

Handle per la finestra che verrà copiata.

hdcBlt

Handle per il contesto del dispositivo.

nFlags

Opzioni di disegno. Può essere uno dei valori seguenti.

Valore	Significato
PW_CLIENTONLY	Solo l'area client della finestra viene copiata in hdcBlt. Per impostazione predefinita, viene copiata l'intera finestra.

Valore restituito

Se la funzione ha esito positivo, restituisce un valore diverso da zero.

Se la funzione ha esito negativo, restituisce zero.

Commenti

Nota Si tratta di una funzione di blocco o sincrona e potrebbe non restituire immediatamente. La velocità di restituzione di questa funzione dipende da fattori di runtime, ad esempio lo stato della rete, la configurazione del server di stampa e l'implementazione del driver della stampante, fattori difficili da prevedere durante la scrittura di un'applicazione. Chiamando questa funzione da un thread che gestisce l'interazione con l'interfaccia utente, l'applicazione potrebbe sembrare non rispondente.

 

L'applicazione proprietaria della finestra a cui fa riferimento hWnd elabora la chiamata PrintWindow ed esegue il rendering dell'immagine nel contesto di dispositivo a cui fa riferimento hdcBlt. L'applicazione riceve un messaggio WM_PRINT o, se viene specificato il flag di PW_PRINTCLIENT , un messaggio di WM_PRINTCLIENT . Per altre informazioni, vedere WM_PRINT e WM_PRINTCLIENT.

Requisiti

Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-draw-l1-1-2 (introdotto in Windows 10 versione 10.0.10240)

Vedi anche

Disegno e disegno di messaggi

Panoramica di disegno e disegno

WM_PRINT

WM_PRINTCLIENT