Estructura PRINTDLGA (commdlg.h)

Contiene información que la función PrintDlg usa para inicializar el cuadro de diálogo Imprimir. Una vez que el usuario cierra el cuadro de diálogo, el sistema usa esta estructura para devolver información sobre las selecciones del usuario.

Sintaxis

typedef struct tagPDA {
  DWORD           lStructSize;
  HWND            hwndOwner;
  HGLOBAL         hDevMode;
  HGLOBAL         hDevNames;
  HDC             hDC;
  DWORD           Flags;
  WORD            nFromPage;
  WORD            nToPage;
  WORD            nMinPage;
  WORD            nMaxPage;
  WORD            nCopies;
  HINSTANCE       hInstance;
  LPARAM          lCustData;
  LPPRINTHOOKPROC lpfnPrintHook;
  LPSETUPHOOKPROC lpfnSetupHook;
  LPCSTR          lpPrintTemplateName;
  LPCSTR          lpSetupTemplateName;
  HGLOBAL         hPrintTemplate;
  HGLOBAL         hSetupTemplate;
} PRINTDLGA, *LPPRINTDLGA;

Miembros

lStructSize

Tipo: DWORD

Tamaño de la estructura, en bytes.

hwndOwner

Tipo: HWND

Identificador de la ventana que posee el cuadro de diálogo. Este miembro puede ser cualquier identificador de ventana válido o puede ser NULL si el cuadro de diálogo no tiene propietario.

hDevMode

Tipo: HGLOBAL

Identificador de un objeto de memoria global móvil que contiene una estructura DEVMODE . Si hDevMode no es NULL en la entrada, debe asignar un bloque de memoria móvil para la estructura DEVMODE e inicializar sus miembros. La función PrintDlg usa los datos de entrada para inicializar los controles en el cuadro de diálogo. Cuando PrintDlg devuelve, los miembros DEVMODE indican la entrada del usuario.

Si hDevMode es NULL en la entrada, PrintDlg asigna memoria para la estructura DEVMODE , inicializa sus miembros para indicar la entrada del usuario y devuelve un identificador que lo identifica.

Si el controlador de dispositivo de la impresora especificada no admite modos de dispositivo extendidos, hDevMode es NULL cuando PrintDlg devuelve.

Si el nombre del dispositivo (especificado por el miembro dmDeviceName de la estructura DEVMODE ) no aparece en la sección [devices] de WIN.INI, PrintDlg devuelve un error.

Para obtener más información sobre los miembros hDevMode y hDevNames , vea la sección Comentarios al final de este tema.

hDevNames

Tipo: HGLOBAL

Identificador de un objeto de memoria global móvil que contiene una estructura DEVNAMES . Si hDevNames no es NULL en la entrada, debe asignar un bloque de memoria extraíble para la estructura DEVNAMES e inicializar sus miembros. La función PrintDlg usa los datos de entrada para inicializar los controles en el cuadro de diálogo. Cuando se devuelve PrintDlg , los miembros DEVNAMES contienen información para la impresora elegida por el usuario. Puede usar esta información para crear un contexto de dispositivo o un contexto de información.

El miembro hDevNames puede ser NULL, en cuyo caso PrintDlg asigna memoria para la estructura DEVNAMES , inicializa sus miembros para indicar la entrada del usuario y devuelve un identificador que lo identifica.

Para obtener más información sobre los miembros hDevMode y hDevNames , vea la sección Comentarios al final de este tema.

hDC

Tipo: HDC

Identificador de un contexto de dispositivo o un contexto de información, en función de si el miembro Flags especifica la marca PD_RETURNDC o PC_RETURNIC . Si no se especifica ninguna marca, el valor de este miembro no está definido. Si se especifican ambas marcas, PD_RETURNDC tiene prioridad.

Flags

Tipo: DWORD

Inicializa el cuadro de diálogo Imprimir . Cuando se devuelve el cuadro de diálogo, establece estas marcas para indicar la entrada del usuario. Este miembro puede ser uno o varios de los valores siguientes.

Para asegurarse de que PrintDlg o PrintDlgEx devuelven los valores correctos en los miembros dmCopies y dmCollate de la estructura DEVMODE , establezca PD_RETURNDC = TRUE y PD_USEDEVMODECOPIESANDCOLLATE = TRUE. Al hacerlo, el miembro nCopies de la estructura PRINTDLG siempre es 1 y PD_COLLATE siempre es FALSE.

Para asegurarse de que PrintDlg o PrintDlgEx devuelve los valores correctos en nCopies y PD_COLLATE, establezca PD_RETURNDC = TRUE y PD_USEDEVMODECOPIESANDCOLLATE = FALSE. Al hacerlo, dmCopies siempre es 1 y dmCollate siempre es FALSE.

En Windows Vista y Windows 7, cuando se llama a PrintDlg o PrintDlgEx con PD_RETURNDC establecido en TRUE y PD_USEDEVMODECOPIESANDCOLLATE establecido en FALSE, la función PrintDlg o PrintDlgEx establece el número de copias en el miembro nCopies de la estructura PRINTDLG y establece el número de copias en la estructura representada por el miembro hDC de la estructura PRINTDLG .

Al realizar llamadas a GDI, debe omitir el valor de nCopies, tener en cuenta el valor como 1 y usar el hDC devuelto para evitar imprimir copias duplicadas.

nFromPage

Tipo: WORD

Valor inicial del control de edición de página inicial.

Cuando PrintDlg devuelve, nFromPage es la página inicial especificada por el usuario. Si se selecciona el botón de radio Pages cuando el usuario hace clic en el botón Aceptar , PrintDlg establece la marca PD_PAGENUMS y no vuelve hasta que el usuario escribe un valor de página inicial que se encuentra dentro del intervalo de página mínimo a máximo.

Si el valor de entrada de nFromPage o nToPage está fuera del intervalo mínimo o máximo, PrintDlg devuelve un error solo si se especifica la marca PD_PAGENUMS ; de lo contrario, muestra el cuadro de diálogo, pero cambia el valor fuera del intervalo al valor mínimo o máximo.

nToPage

Tipo: WORD

Valor inicial del control de edición de página final. Cuando PrintDlg devuelve, nToPage es la página final especificada por el usuario. Si se selecciona el botón de radio Pages cuando el uso hace clic en el botón Ok , PrintDlg establece la marca PD_PAGENUMS y no vuelve hasta que el usuario escribe un valor de página final que está dentro del intervalo de página mínimo al máximo.

nMinPage

Tipo: WORD

Valor mínimo para el intervalo de páginas especificado en los controles de edición de página Desde y Para . Si nMinPage es igual a nMaxPage, se deshabilitan el botón de radio Pages y los controles de edición de página inicial y final.

nMaxPage

Tipo: WORD

Valor máximo del intervalo de páginas especificado en los controles de edición de página Desde y To .

nCopies

Tipo: WORD

Número inicial de copias para el control de edición Copias si hDevMode es NULL; de lo contrario, el miembro dmCopies de la estructura DEVMODE contiene el valor inicial. Cuando PrintDlg devuelve, nCopies contiene el número real de copias que se van a imprimir. Este valor depende de si la aplicación o el controlador de impresora son responsables de imprimir varias copias. Si la marca PD_USEDEVMODECOPIESANDCOLLATE se establece en el miembro Flags , nCopies siempre es 1 en devolución y el controlador de impresora es responsable de imprimir varias copias. Si no se establece la marca, la aplicación es responsable de imprimir el número de copias especificadas por nCopies. Para obtener más información, vea la descripción de la marca PD_USEDEVMODECOPIESANDCOLLATE .

hInstance

Tipo: HINSTANCE

Si la marca PD_ENABLEPRINTTEMPLATE o PD_ENABLESETUPTEMPLATE está establecida en el miembro Flags , hInstance es un identificador de la instancia de aplicación o módulo que contiene la plantilla de cuadro de diálogo denominada por el miembro lpPrintTemplateName o lpSetupTemplateName .

lCustData

Tipo: LPARAM

Datos definidos por la aplicación que el sistema pasa al procedimiento de enlace identificado por el miembro lpfnPrintHook o lpfnSetupHook . Cuando el sistema envía el mensaje WM_INITDIALOG al procedimiento de enlace, el parámetro lParam del mensaje es un puntero a la estructura PRINTDLG especificada cuando se creó el cuadro de diálogo. El procedimiento de enlace puede usar este puntero para obtener el valor lCustData .

lpfnPrintHook

Tipo: LPPRINTHOOKPROC

Puntero a un procedimiento de enlace PrintHookProc que puede procesar mensajes destinados al cuadro de diálogo Imprimir . Este miembro se omite a menos que la marca PD_ENABLEPRINTHOOK esté establecida en el miembro Flags .

lpfnSetupHook

Tipo: LPSETUPHOOKPROC

Puntero a un procedimiento de enlace SetupHookProc que puede procesar mensajes destinados al cuadro de diálogo Configurar impresión . Este miembro se omite a menos que la marca PD_ENABLESETUPHOOK esté establecida en el miembro Flags .

lpPrintTemplateName

Tipo: LPCTSTR

Nombre del recurso de plantilla del cuadro de diálogo en el módulo identificado por el miembro hInstance . Esta plantilla reemplaza la plantilla predeterminada del cuadro de diálogo Imprimir . Este miembro se omite a menos que la marca PD_ENABLEPRINTTEMPLATE esté establecida en el miembro Flags .

lpSetupTemplateName

Tipo: LPCTSTR

Nombre del recurso de plantilla del cuadro de diálogo en el módulo identificado por el miembro hInstance . Esta plantilla reemplaza la plantilla del cuadro de diálogo Configurar impresión predeterminada. Este miembro se omite a menos que la marca PD_ENABLESETUPTEMPLATE esté establecida en el miembro Flags .

hPrintTemplate

Tipo: HGLOBAL

Si la marca PD_ENABLEPRINTTEMPLATEHANDLE se establece en el miembro Flags , hPrintTemplate es un identificador de un objeto de memoria que contiene una plantilla de cuadro de diálogo. Esta plantilla reemplaza la plantilla predeterminada del cuadro de diálogo Imprimir .

hSetupTemplate

Tipo: HGLOBAL

Si la marca PD_ENABLESETUPTEMPLATEHANDLE se establece en el miembro Flags , hSetupTemplate es un identificador de un objeto de memoria que contiene una plantilla de cuadro de diálogo. Esta plantilla reemplaza la plantilla del cuadro de diálogo Configurar impresión predeterminada.

Comentarios

Si hDevMode y hDevNames son NULL, PrintDlg inicializa el cuadro de diálogo con la impresora predeterminada actual. Para inicializar el cuadro de diálogo para una impresora diferente, utilice el miembro wDeviceOffset de la estructura DEVNAMES para especificar el nombre de la impresora.

Tenga en cuenta que el miembro dmDeviceName de la estructura DEVMODE también especifica un nombre de impresora. Sin embargo, dmDeviceName está limitado a 32 caracteres y el nombre wDeviceOffset no lo es. Si los nombres wDeviceOffset y dmDeviceName no son los mismos, PrintDlg inicializa el cuadro de diálogo con la impresora especificada por wDeviceOffset.

Si se establece la marca PD_RETURNDEFAULT y hDevMode y hDevNames son NULL, PrintDlg usa los miembros hDevNames y hDevMode para devolver información sobre la impresora predeterminada actual sin mostrar el cuadro de diálogo.

Requisitos

Consulte también

Biblioteca de cuadros de diálogo comunes

Conceptual

DEVMODE

DEVNAMES

PrintDlg

Referencia

WM_INITDIALOG