CView::OnPrepareDC

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

Parámetros

pDC

Puntos al contexto de dispositivo que se utilizará para representar una imagen del documento.

pInfo

Puntos a una estructura CPrintInfo que describe el trabajo de impresión actual si se llama OnPrepareDC para vista previa de impresión o impresión; el miembro m_nCurPage especifica la página a imprimir. Este parámetro es NULL si se llama OnPrepareDC de pantalla.

Observaciones

Llamado por el marco antes de llama a la función miembro OnDraw de pantalla y antes de llama a la función de miembro OnPrint para cada página durante la vista previa de impresión o impresión. La implementación predeterminada de esta función no hace nada si se llama a la función de pantalla. Sin embargo, esta función se reemplaza en las clases derivadas, tales como CScrollView, para ajustar los atributos del contexto de dispositivo; en consecuencia, siempre debe llamar a la implementación de la clase base al comienzo de su anulación.

Si se llama a la función de impresión, la implementación predeterminada examina la información de la página almacenada en el parámetro pInfo . Si la longitud del documento no se ha especificado, OnPrepareDC asume el documento a una página de larga y se detiene el bucle de impresión después de que una página se ha impreso. La función detiene el bucle de impresión estableciendo el miembro m_bContinuePrinting de la estructura en FALSE.

Reemplace OnPrepareDC por cualquiera de los siguientes motivos:

• Para ajustar los atributos del contexto de dispositivo según sea necesario para la página especificada. Por ejemplo, si necesita establecer el modo de asignación u otras características del contexto de dispositivo, hacerlo en esta función.
  
  
• Para realizar la paginación de tiempo de impresión. Normalmente especifica la longitud del documento cuando comienza la impresión, utilizando la función de miembro OnPreparePrinting . Sin embargo, si usted no sabe de antemano cuánto el documento (por ejemplo, al imprimir un número indeterminado de registros desde una base de datos), reemplazar OnPrepareDC para probar el final del documento mientras se está imprimiendo. Cuando hay no más del documento que desea imprimir, establecer al miembro m_bContinuePrinting de la estructura CPrintInfo en FALSE.
  
  
• Para enviar códigos de escape a la impresora sobre una base de página por página. Para enviar códigos de escape de OnPrepareDC, llame a la función de miembro de Escape del parámetro pDC.

Llamar a la versión de la clase base de OnPrepareDC al comienzo de su anulación.

Visió&n General de CView |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;CDC::Escape, CPrintInfo, CView::OnBeginPrinting, CView::OnDraw, CView::OnPreparePrinting, CView::OnPrint