CView:: OnPrepareDC

virtual privatevoid OnPrepareDC ( CDC * pDC, CPrintInfo * pInfo = Nulo );

Parâmetros

pDC

Aponta para o contexto dispositivo a ser usado para processar uma imagem do documento.

pInfo

Aponta para um estrutura de CPrintInfo que descreve o trabalho de impressão atual se OnPrepareDC está sendo chamado para visualizar de impressão ou impressão; o membro m_nCurPage especifica a página prestes a ser impresso. Este parâmetro é NULL se OnPrepareDC está sendo chamado Exibir de tela.

Observações

Chamado pela estrutura antes que a função de membro OnDraw é chamada Exibir de tela, e antes que a função de membro OnPrint é chamada para cada página durante a Visualizar de impressão ou impressão. A implementação padrão desta função não faz nada se a função for chamada para exibição na tela. No entanto, esta função é substituída em classes derivadas, como CScrollView, para ajustar atributos do contexto de dispositivo; Conseqüentemente, você sempre deve chamar a implementação da classe base no início de sua Substituir.

Se a função for chamada para impressão, a implementação padrão examina as informações de página armazenadas no parâmetro pInfo . Se o comprimento do documento não tiver sido especificado, OnPrepareDC pressupõe o documento a ser uma página longa e interrompe o loop de impressão após uma página foi impressa. A função pára o loop de imprimir por configuração o membro m_bContinuePrinting a estrutura para FALSE.

Substituir OnPrepareDC para qualquer um dos seguintes motivos:

• Para ajustar atributos do contexto de dispositivo conforme necessário para a página especificada. Por exemplo, se você precisar definir o modo de mapeamento ou outras características do contexto de dispositivo, fazê-lo nessa função.
  
  
• Para realizar a paginação Imprimir-hora. Normalmente você especifica o comprimento do documento quando a impressão começa, usando a função de membro OnPreparePrinting . No entanto, se você não sabe de antemão quanto tempo o documento está (por exemplo, ao imprimir um número indeterminado de registros de um banco de dados), substituir OnPrepareDC para testar para o final do documento enquanto ele está sendo impresso. Quando há não mais do documento a ser impresso, defina o membro m_bContinuePrinting a estrutura de CPrintInfo a FALSE.
  
  
• Para enviar códigos de escape para a impressora em uma base de página por página. Para enviar códigos de escape de OnPrepareDC, chame a função de membro de Escape do parâmetro pDC.

Chamar a versão de classe base de OnPrepareDC no início de sua Substituir.

Visão geral de CView |  Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CDC::Escape, CPrintInfo, CView::OnBeginPrinting, CView:: OnDraw, CView:: OnPreparePrinting, CView::OnPrint