CView::OnPreparePrinting

virtual BOOL OnPreparePrinting ( CPrintInfo * pInfo );

Valor devuelto

Distinto de cero para iniciar la impresión; 0 si se ha cancelado el trabajo de impresión.

Parámetros

pInfo

Puntos a una estructura CPrintInfo que describe el trabajo de impresión actual.

Observaciones

Llama el marco antes de un documento impreso o vista previa. La implementación predeterminada no hace nada.

Se debe reemplazar esta función para habilitar la vista previa de impresión e imprimir. Llame a la función miembro DoPreparePrinting , pasándole el parámetro pInfo y vuelva a su valor de retorno; DoPreparePrinting muestra el cuadro de diálogo Imprimir y crea un contexto de dispositivo de impresora. Si desea inicializar el cuadro de diálogo Imprimir con valores distintos de los predeterminados, asignar valores a los miembros de pInfo. Por ejemplo, si conoce la longitud del documento, pasar el valor a la función miembro SetMaxPage de pInfo antes de llamar a DoPreparePrinting. Este valor se muestra en el: cuadro en la parte de la gama del cuadro de diálogo Imprimir.

DoPreparePrinting no muestra el cuadro de diálogo Imprimir para un trabajo de vista previa. Si desea omitir el cuadro de diálogo Imprimir para un trabajo de impresión, compruebe que el miembro m_bPreview de pInfo es falsa y establecida en TRUE antes de pasar al DoPreparePrinting; restablecer en FALSE después.

Si necesita realizar inicializaciones que requieren acceso al objeto CDC que representa el contexto de dispositivo de impresora (por ejemplo, si necesita saber el tamaño de página antes de especificar la longitud del documento), reemplace la función miembro OnBeginPrinting.

Si desea establecer el valor de los miembros de m_nNumPreviewPages o m_strPageDesc del parámetro pInfo , hacerlo después de llamar a DoPreparePrinting. La función de miembro de DoPreparePrinting establece m_nNumPreviewPages en el valor que se encuentra en la aplicación.Archivo INI y establece su valor predeterminado m_strPageDesc.

Ejemplo

La siguiente es una anulación de OnPreparePrinting proporcionada por AppWizard si selecciona la opción de impresión cuando se crea un conjunto de archivos de arranque. Esta anulación es suficiente a menos que desee inicializar el cuadro de diálogo Imprimir.

BOOL CMyView::OnPreparePrinting (CPrintInfo * pInfo)
{
   volver a DoPreparePrinting (pInfo);
}

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

Vea tambié&nnbsp;CPrintInfo, CView::DoPreparePrinting, CView::OnBeginPrinting, CView::OnPrepareDC, CView::OnPrint

Index