Função PrintWindow (winuser.h)

A função PrintWindow copia uma janela visual para o DC (contexto de dispositivo) especificado, normalmente um DC de impressora.

Sintaxe

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

Parâmetros

hwnd

Um identificador para a janela que será copiada.

hdcBlt

Um identificador para o contexto do dispositivo.

nFlags

As opções de desenho. Pode ser um dos seguintes valores.

Valor	Significado
PW_CLIENTONLY	Somente a área do cliente da janela é copiada para hdcBlt. Por padrão, toda a janela é copiada.

Valor retornado

Se a função for bem-sucedida, ela retornará um valor diferente de zero.

Se a função falhar, ela retornará zero.

Comentários

Nota Essa é uma função de bloqueio ou síncrona e pode não retornar imediatamente. A rapidez com que essa função retorna depende de fatores de tempo de execução, como status de rede, configuração do servidor de impressão e implementação do driver de impressora— fatores difíceis de prever ao escrever um aplicativo. Chamar essa função de um thread que gerencia a interação com a interface do usuário pode fazer com que o aplicativo pareça não responder.

 

O aplicativo que possui a janela referenciada por hWnd processa a chamada PrintWindow e renderiza a imagem no contexto do dispositivo referenciado por hdcBlt. O aplicativo recebe uma mensagem WM_PRINT ou, se o sinalizador PW_PRINTCLIENT for especificado, uma mensagem WM_PRINTCLIENT . Para obter mais informações, consulte WM_PRINT e WM_PRINTCLIENT.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-draw-l1-1-2 (introduzido no Windows 10, versão 10.0.10240)

Confira também

Mensagens de pintura e desenho

Visão geral de pintura e desenho

WM_PRINT

WM_PRINTCLIENT