CView::OnPrint

virtuel void OnPrint ( CDC * pDC, CPrintInfo * pInfo );

Paramètres

pDC

Pointe vers le contexte de périphérique imprimante.

pInfo

Pointe vers un objet CPrintInfo qui décrit le travail d'impression actuel.

Remarques

Appelé par le framework pour imprimer ou prévisualiser une page du document. Pour chaque page à imprimer, l'infrastructure appelle cette fonction immédiatement après l'appel de la fonction membre OnPrepareDC . La page à imprimer est spécifiée par le membre m_nCurPage de la CPrintInfo que pInfo souligne. L'implémentation par défaut appelle la fonction membre OnDraw et lui transmet le contexte de périphérique imprimante.

Substituez cette fonction pour l'une des raisons suivantes:

• Pour permettre l'impression des documents multipages. Rendre uniquement la partie du document qui correspond à la page actuellement en cours d'impression. Si vous utilisez OnDraw pour effectuer le rendu, vous pouvez ajuster l'origine de la fenêtre d'affichage pour que seule la portion appropriée du document est imprimée.
  
  
• Pour rendre l'image imprimée ressemble à l'image de l'écran (en d'autres termes, si votre application n'est pas WYSIWYG). Au lieu de passer l'imprimante contexte de périphérique à OnDraw, utiliser le contexte de périphérique pour restituer une image à l'aide d'attributs ne figure ne pas sur l'écran.

  Si vous avez besoin de ressources GDI pour l'impression que vous n'utilisez pas d'affichage à l'écran, sélectionnez-les dans le contexte de périphérique avant de dessin et de désélectionner les par la suite. Ces ressources GDI devraient être alloués en OnBeginPrinting l'affichage et sortis en OnEndPrinting.

• Pour mettre en œuvre les en-têtes ou pieds de page. Vous pouvez toujours utiliser OnDraw pour faire le rendu en limitant la zone qu'il peut imprimer sur.

Notez que le membre m_rectDraw du paramètre pInfo décrit la zone imprimable de la page dans les unités logiques.

N'appelez pas OnPrepareDC dans votre substitution surimpression; l'infrastructure appelle automatiquement les OnPrepareDC avant d'appeler la surimpression.

Exemple

Ce qui suit est un squelette pour une fonction substituée de surimpression:

vOID CMyView::OnPrint (CDC * pDC, CPrintInfo * pInfo)
{
   / / Imprimer des en-têtes ou pieds de pa&ge, si vous le souhaitez.
   / / Trouver la partie du document correspondant à pInfo-gt ; m_nCurPage.
   OnDraw (pDC) ;
}

Aperçu de CView |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CView::OnBeginPrinting, CView::OnEndPrinting, CView::OnPrepareDC, CView::OnDraw