CPrintDialogEx Class

Artículo
06/10/2015

Encapsula los servicios proporcionados por la hoja de propiedades de impresión de Windows 2000.

class CPrintDialogEx : public CCommonDialog

Miembros

Constructores públicos

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

Métodos públicos

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

Miembros de datos públicos

Name	Descripción
CPrintDialogEx::m_pdex	Una estructura utilizada para personalizar un objeto de CPrintDialogEx .

Comentarios

Puede utilizar el marco para administrar muchos aspectos del proceso de impresión para la aplicació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 CPrintDialogEx “tal cual” con el constructor proporcionado, o puede derivar su propia clase de cuadro de diálogo de CPrintDialogEx 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 CPrintDialogEx , primero cree el objeto mediante el constructor de CPrintDialogEx . Una vez que se ha construido el cuadro de diálogo, puede establecer o modificar cualquier valor de la estructura de m_pdex para inicializar los valores de los controles del cuadro de diálogo. La estructura de m_pdex es de PRINTDLGEXescrito. Para obtener más información sobre esta estructura, vea Windows SDK.

Si no se proporciona sus propios identificadores en m_pdex 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.

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. Cuando DoModal cambia, puede determinar si el usuario seleccionó OK, aplica, o botón Cancelar.

Si el usuario presionó ACEPTAR, puede utilizar las funciones miembro de entity_CODECPrintDialogEx para recuperar la entrada de información del usuario.

La función miembro de CPrintDialogEx::GetDefaults es útil para recuperar los valores predeterminados actuales de la impresora sin mostrar un cuadro de diálogo. Este método 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.

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