Função EndPage (wingdi.h)

  • Artigo

A função EndPage notifica o dispositivo de que o aplicativo terminou de gravar em uma página. Essa função normalmente é usada para direcionar o driver de dispositivo para avançar para uma nova página.

Sintaxe

int EndPage(
  [in] HDC hdc
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo para o trabalho de impressão.

Valor retornado

Se a função obtiver êxito, o valor retornado será maior que zero.

Se a função falhar, o valor retornado será menor ou igual a 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 de 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.
 
Use a função ResetDC para alterar o modo de dispositivo, se necessário, depois de chamar a função EndPage . Observe que uma chamada para ResetDC redefine todos os atributos de contexto do dispositivo de volta para valores padrão. Nem EndPage nem StartPage redefinem os atributos de contexto do dispositivo. Os atributos de contexto do dispositivo permanecem constantes nas páginas subsequentes. Você não precisa selecionar novamente objetos e configurar o modo de mapeamento novamente antes de imprimir a próxima página; no entanto, isso produzirá os mesmos resultados e reduzirá as diferenças de código entre as versões do Windows.

Quando uma página em um arquivo em spool excede aproximadamente 350 MB, pode falhar ao imprimir e não enviar uma mensagem de erro. Por exemplo, isso pode ocorrer ao imprimir arquivos EMF grandes. O limite de tamanho da página depende de muitos fatores, incluindo a quantidade de memória virtual disponível, a quantidade de memória alocada por processos de chamada e a quantidade de fragmentação no heap do processo.

Exemplos

Para obter um programa de exemplo que usa essa função, consulte Como imprimir usando a API de impressão GDI.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wingdi.h (inclua Windows.h)
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também

Funções da API do Spooler de impressão

Impressão

Resetdc

StartPage