Compartilhar via


CView::OnBeginPrinting

Chamado pela estrutura no início de um trabalho de impressão ou de visualização de impressão, após OnPreparePrinting foi chamado.

virtual void OnBeginPrinting(
   CDC* pDC,
   CPrintInfo* pInfo 
);

Parâmetros

  • pDC
    Aponta para o contexto de dispositivos de impressão.

  • pInfo
    Os pontos a CPrintInfo estrutura que descreve o trabalho de impressão atual.

Comentários

A implementação padrão de essa função não fará nada.Substituir essa função para atribuir todos os recursos do GDI, como as canetas ou fontes, especificamente necessárias para impressão.Selecione os objetos de GDI no contexto do dispositivo de dentro da função de membro de OnPrint para cada página que os usa.Se você estiver usando o mesmo objeto de exibição para executar a exibição e a impressão, use variáveis separados para os recursos do GDI necessários para cada exibição; isso permite que você atualize a tela durante a impressão.

Você também pode usar essa função para executar as inicializações que dependem das propriedades do contexto de dispositivos de impressão.Por exemplo, o número de páginas necessárias para imprimir o documento pode depender de configurações que o usuário especificou a caixa de diálogo para impressão (como o comprimento da página).Em uma situação, você não pode especificar o comprimento de documento na função de membro de OnPreparePrinting , onde você faria normalmente o; você deve aguardar até que o contexto do dispositivo de impressora é criado com base nas configurações da caixa de diálogo.OnBeginPrinting é a primeira função substituíveis que fornece acesso ao objeto de CDC que representa o contexto do dispositivo de impressora, então você pode definir o comprimento de documento de essa função.Observe que se o comprimento de documento não é especificado entretanto, uma barra de rolagem não é exibida durante a visualização de impressão.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe de CView

Gráfico de hierarquia

CView::OnEndPrinting

CView::OnPreparePrinting

CView::OnPrint