Função StartPage (wingdi.h)

  • Artigo

A função StartPage prepara o driver de impressora para aceitar dados.

Sintaxe

int StartPage(
  [in] HDC hdc
);

Parâmetros

[in] hdc

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

Retornar valor

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.
 
O sistema desabilita a função ResetDC entre chamadas para as funções StartPage e EndPage . Isso significa que você não pode alterar o modo de dispositivo, exceto nos limites da página. Depois de chamar EndPage, você pode chamar ResetDC para alterar o modo de dispositivo, se necessário. 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.

Exemplos

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

Requisitos

Requisito Valor
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

EndPage

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

Impressão

Resetdc