Partager via

CView::OnBeginPrinting

  • Article

 

Appelé par l’infrastructure au début d’un travail d’impression ou d’aperçu avant impression, après que OnPreparePrinting a été appelé.

Syntaxe

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

Paramètres

  • pDC
    Pointe vers le contexte de l’imprimante.

  • pInfo
    Pointe vers une structure CPrintInfo qui décrit le travail d’impression actif.

Notes

L’implémentation par défaut de cette fonction est sans effet. Remplacez cette fonction pour allouer des ressources GDI, telles que des stylets ou des polices, nécessaires précisément pour l’impression. Sélectionnez les objets GDI dans le contexte de périphérique de la fonction membre OnPrint pour chaque page qui les utilise. Si vous utilisez le même objet d’affichage pour l’affichage et l’impression d’écran, utilisez des variables distinctes pour les ressources GDI nécessaires à chaque affichage ; vous pourrez ainsi mettre à jour l’écran pendant l’impression.

Vous pouvez aussi utiliser cette fonction pour exécuter des initialisations qui dépendent des propriétés du contexte de l’imprimante. Par exemple, le nombre de pages nécessaires à l’impression du document peut dépendre des paramètres que l’utilisateur a spécifiés dans la boîte de dialogue d’impression (comme la longueur de page). En pareil cas, vous ne pouvez pas spécifier la longueur du document dans la fonction membre OnPreparePrinting comme vous le feriez normalement ; vous devez attendre que le contexte de l’imprimante ait été créé en fonction des paramètres de la boîte de dialogue.OnBeginPrinting est la première fonction substituable qui donne accès à l’objet CDC représentant le contexte de l’imprimante. Vous pouvez donc définir la longueur du document à partir de cette fonction. Notez que si la longueur du document n’est pas spécifiée à ce stade, aucune barre de défilement ne s’affiche pendant l’aperçu avant impression.

Configuration requise

En-tête : afxwin.h

Voir aussi

CView Class
Graphique hiérarchique
CView::OnEndPrinting
CView::OnPreparePrinting
CView::OnPrint