CView::OnPrepareDC

virtuelvoidOnPrepareDC (CDC *pDC,CPrintInfo *pInfoNULL=);

Paramètres

pDC

Pointe vers le contexte de périphérique à utiliser pour le rendu d'une image du document.

pInfo

Pointe vers un objet CPrintInfo qui décrit le travail d'impression actuel si OnPrepareDC est appelée pour l'aperçu avant impression ou imprimé ; le membre m_nCurPage spécifie la page sur le point d'être imprimé. Ce paramètre est NULL si OnPrepareDC est appelée pour affichage à l'écran.

Remarques

Appelée par le cadre avant la fonction membre OnDraw pour affichage à l'écran, et avant que la fonction de membre OnPrint est appelée pour chaque page, aperçu avant impression ou impression. L'implémentation par défaut de cette fonction ne fait rien si la fonction est appelée pour affichage à l'écran. Cependant, cette fonction est substituée dans les classes dérivées, telles que CScrollView, d'ajuster les attributs du contexte de périphérique ; par conséquent, vous devez toujours appeler l'implémentation de la classe de base au début de votre substitution.

Si la fonction est appelée pour l'impression, la mise en œuvre par défaut examine la page l'information stockée dans le paramètre pInfo . Si la longueur du document n'a pas été spécifiée, OnPrepareDC suppose que le document soit une page longue et arrête la boucle d'impression après qu'une page a été imprimée. La fonction s'arrête la boucle d'impression en affectant false à la membre membre m_bContinuePrinting de la structure.

Substituez OnPrepareDC pour l'une des raisons suivantes:

• Pour ajuster les attributs du contexte de périphérique nécessaire pour la page spécifiée. Par exemple, si vous avez besoin définir le mode de mappage ou d'autres caractéristiques du contexte de périphérique, le faire dans cette fonction.
  
  
• Pour exécuter la pagination du moment de l'impression. Normalement, vous spécifiez la longueur du document lorsqu'une impression commence, à l'aide de la fonction membre OnPreparePrinting . Toutefois, si vous ne savez pas à l'avance combien de temps le document est (par exemple, lors de l'impression un nombre indéterminé d'enregistrements d'une base de données), substituez OnPrepareDC pour tester pour la fin du document, alors qu'il est imprimé. Quand il n'y a pas plus du document à imprimer, définissez le membre membre m_bContinuePrinting de la CPrintInfo false.
  
  
• Pour envoyer des codes d'échappement à l'imprimante sur une base de page par page. Pour envoyer des codes d'échappement d'OnPrepareDC, appelez la fonction membre de s'échapper du paramètre pDC.

Appeler la version de classe de base de OnPrepareDC au début de votre substitution.

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

Voir aussi  ;CDC::Escape, CPrintInfo, CView::OnBeginPrinting, CView::OnDraw, CView::OnPreparePrinting, CView::OnPrint