Clase de CPrintDialog

Artículo
04/10/2013

encapsula los servicios proporcionados por el cuadro de diálogo común de Windows para imprimir.

class CPrintDialog : public CCommonDialog

Miembros

Constructores públicos

Name	Descripción
CPrintDialog::CPrintDialog	Crea un objeto CPrintDialog.

Métodos públicos

Name	Descripción
CPrintDialog::CreatePrinterDC	Crear un contexto de dispositivo de la impresora sin mostrar el cuadro de diálogo imprimir.
CPrintDialog::DoModal	Muestra el cuadro de diálogo y permite que el usuario realice una selección.
CPrintDialog::GetCopies	recupera el número de copias solicitadas.
CPrintDialog::GetDefaults	Valores predeterminados del dispositivo de recupera sin mostrar un cuadro de diálogo.
CPrintDialog::GetDeviceName	Recupera el nombre actualmente de dispositivo de impresora seleccionada.
CPrintDialog::GetDevMode	Recupera la estructura de DEVMODE .
CPrintDialog::GetDriverName	Recupera el nombre actualmente del controlador de impresora seleccionada.
CPrintDialog::GetFromPage	Recupera la página inicial del intervalo de impresión.
CPrintDialog::GetPortName	Recupera el nombre actualmente del puerto de impresora seleccionada.
CPrintDialog::GetPrinterDC	Recupera un identificador al contexto de dispositivo de impresora.
CPrintDialog::GetToPage	Recupera la página del final del intervalo de impresión.
CPrintDialog::PrintAll	Determina si imprimir todas las páginas del documento.
CPrintDialog::PrintCollate	Determina si las copias intercaladas se solicitadas.
CPrintDialog::PrintRange	Determina si imprimir sólo un intervalo especificado de páginas.
CPrintDialog::PrintSelection	Determina si imprimir sólo actualmente los elementos seleccionados.

Miembros de datos públicos

Name	Descripción
CPrintDialog::m_pd	Una estructura utilizada para personalizar un objeto de CPrintDialog .

Comentarios

Los cuadros de diálogo comunes de impresión proporcionan una manera fácil de implementar los cuadros de diálogo de impresión y configuración de impresión de una manera coherente con las normas de Windows.

[!NOTA]

La clase de CPrintDialogEx encapsula los servicios proporcionados por la hoja de propiedades de impresión de Windows 2000.Para obtener más información vea información general de CPrintDialogEx .

La funcionalidad de entity_CODECPrintDialog se reemplaza por la de CPageSetupDialog, diseñada para proporcionarle con un cuadro de diálogo común para la instalación y la configuración de página de impresión.

Puede utilizar el marco para administrar muchos aspectos del proceso de impresión para la aplicación.En este caso, el marco muestra automáticamente el cuadro de diálogo común de Windows para imprimir.También puede tener la impresión del identificador del marco para la aplicación pero reemplazar el cuadro de diálogo común de impresión con su propio cuadro de diálogo de impresión.Para obtener más información sobre cómo usar el marco para administrar tareas de impresión, vea el artículo el imprimir.

Si desea que la aplicación controle la impresión sin la implicación del marco, puede utilizar la clase de CPrintDialog “tal cual” con el constructor proporcionado, o puede derivar su propia clase de cuadro de diálogo de CPrintDialog y escribir un constructor para satisfacer sus necesidades.En cualquier caso, estos cuadros de diálogo se comportarán como cuadros de diálogo estándar de MFC dado que se derivan de la clase CCommonDialog.

Para utilizar un objeto de CPrintDialog , primero cree el objeto mediante el constructor de CPrintDialog .Una vez que se ha construido el cuadro de diálogo, puede establecer o modificar cualquier valor de la estructura de m_pd para inicializar los valores de los controles del cuadro de diálogo.La estructura de m_pd es de PRINTDLGescrito.Para obtener más información sobre esta estructura, vea Windows SDK.

Si no se proporciona sus propios identificadores en m_pd para los miembros de hDevMode y de hDevNames , asegúrese de llamar a la función de Windows GlobalFree para estos identificadores cuando se hace con el cuadro de diálogo.Al utilizar la implementación de la configuración de impresión de marco proporcionada por CWinApp::OnFilePrintSetup, no es necesario liberar estos identificadores.Los identificadores atiende CWinApp y liberados en el destructor de entity_CODECWinApp.Solo es necesario liberar estos identificadores al utilizar CPrintDialog independiente.

Después de inicializar los controles de cuadro de diálogo, llame a la función miembro de DoModal para mostrar el cuadro de diálogo y permitir al usuario a las opciones de impresión seleccionadas.DoModal devuelve si el usuario ha seleccionado del botón ACEPTAR (IDOK) o delete (IDCANCEL).

Si DoModal devuelve IDOK, puede utilizar una de las funciones miembro de entity_CODECPrintDialog para recuperar la entrada de información del usuario.

La función miembro de CPrintDialog::GetDefaults es útil para recuperar los valores predeterminados actuales de la impresora sin mostrar un cuadro de diálogo.Esta función miembro no requiere ninguna interacción con el usuario.

Puede utilizar la función de Windows CommDlgExtendedError para determinar si se ha producido un error durante la inicialización del cuadro de diálogo y para obtener más información sobre el error.Para obtener más información sobre esta función, vea Windows SDK.

CPrintDialog se basa en el archivo de COMMDLG.DLL que envía con las versiones de Windows 3,1 y versiones posteriores.

Para personalizar el cuadro de diálogo, derive una clase de CPrintDialog, proporcionar una plantilla personalizada del cuadro de diálogo, y agregar un mapa de mensajes para procesar mensajes de notificación de controles extendidos.Cualquier mensaje sin procesar se debe pasar en la clase base.Personalizar la función de enlace no es necesario.

Para procesar el mismo mensaje de manera diferente dependiendo de si el cuadro de diálogo es imprimir o configuración de impresión, debe derivar una clase para cada cuadro de diálogo.También debe reemplazar la función de Windows AttachOnSetup , que controla la creación de un nuevo cuadro de diálogo cuando el botón de la configuración de impresión se selecciona dentro de un cuadro de diálogo imprimir.

Para obtener más información sobre cómo utilizar CPrintDialog, vea Clases comunes de diálogo.