Estructura DEVNAMES (commdlg.h)

Contiene cadenas que identifican los nombres de puerto de salida, dispositivo y controlador para una impresora. Estas cadenas deben ser cadenas ANSI cuando se usa la versión ANSI de PrintDlg o PrintDlgEx y deben ser cadenas Unicode cuando se usa la versión Unicode de PrintDlg o PrintDlgEx . Las funciones PrintDlgEx e PrintDlg usan estas cadenas para inicializar la hoja de propiedades de impresión definida por el sistema o el cuadro de diálogo Imprimir. Cuando el usuario cierra la hoja de propiedades o el cuadro de diálogo, se devuelve información sobre la impresora seleccionada en esta estructura.

Sintaxis

typedef struct tagDEVNAMES {
  WORD wDriverOffset;
  WORD wDeviceOffset;
  WORD wOutputOffset;
  WORD wDefault;
} DEVNAMES;

Miembros

wDriverOffset

Tipo: WORD

Desplazamiento, en caracteres, desde el principio de esta estructura a una cadena terminada en null que contiene el nombre de archivo (sin la extensión) del controlador de dispositivo. En la entrada, esta cadena se usa para determinar la impresora que se va a mostrar inicialmente en el cuadro de diálogo.

wDeviceOffset

Tipo: WORD

Desplazamiento, en caracteres, desde el principio de esta estructura hasta la cadena terminada en null que contiene el nombre del dispositivo.

wOutputOffset

Tipo: WORD

Desplazamiento, en caracteres, desde el principio de esta estructura hasta la cadena terminada en NULL que contiene el nombre del dispositivo para el medio de salida físico (puerto de salida).

wDefault

Tipo: WORD

Indica si las cadenas contenidas en la estructura DEVNAMES identifican la impresora predeterminada. Esta cadena se usa para comprobar que la impresora predeterminada no ha cambiado desde la última operación de impresión. Si alguna de las cadenas no coincide, se muestra un mensaje de advertencia que informa al usuario de que es posible que sea necesario volver a formatear el documento. En la salida, el miembro wDefault solo se cambia si se muestra el cuadro de diálogo Configurar impresión y el usuario eligió el botón Aceptar . La marca DN_DEFAULTPRN se usa si se seleccionó la impresora predeterminada. Si se selecciona una impresora específica, no se usa la marca . Todas las demás marcas de este miembro están reservadas para uso interno mediante el procedimiento del cuadro de diálogo para la hoja de propiedades Print o el cuadro de diálogo Imprimir .

Requisitos

Consulte también

Biblioteca de cuadros de diálogo comunes

Conceptual

PrintDlg

PrintDlgEx

Referencia