Estructura COLORMATCHSETUPA (icm.h)
La estructura COLORMATCHSETUP contiene información que la función SetupColorMatchingW usa para inicializar el cuadro de diálogo ColorManagement . Una vez que el usuario cierra el cuadro de diálogo, SetupColorMatching devuelve información sobre la selección del usuario en esta estructura.
Sintaxis
typedef struct _tagCOLORMATCHSETUPA {
DWORD dwSize;
DWORD dwVersion;
DWORD dwFlags;
HWND hwndOwner;
PCSTR pSourceName;
PCSTR pDisplayName;
PCSTR pPrinterName;
DWORD dwRenderIntent;
DWORD dwProofingIntent;
PSTR pMonitorProfile;
DWORD ccMonitorProfile;
PSTR pPrinterProfile;
DWORD ccPrinterProfile;
PSTR pTargetProfile;
DWORD ccTargetProfile;
DLGPROC lpfnHook;
LPARAM lParam;
PCMSCALLBACKA lpfnApplyCallback;
LPARAM lParamApplyCallback;
} COLORMATCHSETUPA, *PCOLORMATCHSETUPA, *LPCOLORMATCHSETUPA;
Members
dwSize
Tamaño de la estructura. Debe establecerse en sizeof ( COLORMATCHSETUP ).
dwVersion
Versión de la estructura COLORMATCHSETUP . Debe establecerse en COLOR_MATCH_VERSION.
dwFlags
Un conjunto de marcas de bits usadas para inicializar el cuadro de diálogo. Si se establece en 0 en la entrada, todos los controles asumen sus estados predeterminados.
Cuando se devuelve el cuadro de diálogo, estas marcas se establecen para indicar la entrada del usuario.
Este miembro se puede establecer mediante una combinación de las marcas siguientes.
| Marca | Significado |
|---|---|
| CMS_DISABLEICM | Si se establece en la entrada, esta marca indica que la casilla "Habilitar administración de colores" está desactivada, deshabilitando todos los demás controles. Si se establece al salir, significa que el usuario no desea que se realice la administración de colores. |
| CMS_ENABLEPROOFING | Si se establece en la entrada, esta marca indica que se van a habilitar los controles de corrección y se activa la casilla Corrección. Si se establece al salir, significa que el usuario desea realizar la administración de colores para un dispositivo de destino diferente al de la impresora seleccionada. |
| CMS_SETRENDERINTENT | Si se establece en la entrada, esta marca indica que el miembro dwRenderIntent contiene el valor que se va a usar para inicializar el control Intención de representación. De lo contrario, el control tiene como valor predeterminado Representación de imágenes. Esta marca se establece al salir si WCS está habilitado. |
| CMS_SETPROOFINTENT | Se omite a menos que también se establezca CMS_ENABLEPROOFING. Si se establece en la entrada y también se establece CMS_ENABLEPROOFING, esta marca indica que el miembro dwProofingIntent se usará para inicializar el control Intención de representación de destino. De lo contrario, el control tiene como valor predeterminado Representación de imágenes. Esta marca se establece al salir si la corrección está habilitada. |
| CMS_SETMONITORPROFILE | Si se establece en la entrada, esta marca indica que el perfil de administración de colores denominado en el miembro pMonitorProfile es la selección inicial en el control de perfil de monitor. Si el perfil especificado no está asociado al monitor, se omite esta marca y se usa el perfil predeterminado para el monitor. |
| CMS_SETPRINTERPROFILE | Si se establece en la entrada, esta marca indica que el perfil de administración de colores denominado en el miembro pPrinterProfile es la selección inicial en el control de perfil de impresora. Si el perfil especificado no está asociado a la impresora, se omite esta marca y se usa el perfil predeterminado para la impresora. |
| CMS_SETTARGETPROFILE | Si se establece en la entrada, esta marca indica que el perfil de color denominado en el miembro pTargetProfile es la selección inicial en el control de perfil de destino. Si el perfil especificado no está instalado, se omite esta marca y se usa el perfil predeterminado para la impresora. Si la impresora no tiene ningún perfil predeterminado, se mostrará el primer perfil en orden alfabético. |
| CMS_USEHOOK | Esta marca especifica que el miembro lpfnHook contiene la dirección de un procedimiento de enlace y el miembro lParam contiene un valor que se va a pasar al procedimiento de enlace cuando se envía el mensaje de WM_INITDIALOG. |
| CMS_MONITOROVERFLOW | Esta marca se establece al salir si se va a habilitar la administración de colores y el tamaño del búfer proporcionado en ccMonitorProfile no es suficiente para el nombre del perfil seleccionado. GetLastError devuelve ERROR_INSUFFICIENT_BUFFER en tal caso. |
| CMS_PRINTERROVERFLOW | Esta marca se establece al salir si se va a habilitar la administración de colores y el tamaño del búfer especificado en ccPrinterProfile no es suficiente para el nombre del perfil seleccionado. GetLastError devuelve ERROR_INSUFFICIENT_BUFFER en tal caso. |
| CMS_TARGETOVERFLOW | Esta marca se establece al salir si se va a habilitar la corrección y el tamaño del búfer especificado en ccTargetProfile no es suficiente para el nombre del perfil seleccionado. GetLastError devuelve ERROR_INSUFFICIENT_BUFFER en tal caso. |
| CMS_USEAPPLYCALLBACK | Si se establece en la entrada, esta marca indica que la función SetupColorMatching debe llamar a la función PCMSCALLBACKW. La dirección de la función de devolución de llamada se encuentra en lpfnApplyCallback. |
| CMS_USEDESCRIPTION | Si se establece en la entrada, esta marca indica a la función SetupColorMatching que recupere la descripción del perfil contenida en las etiquetas de descripción del perfil (vea Especificación de formato de perfil ICC v3.4). Los insertará en los cuadros de edición Perfil de monitor, Perfil de impresora, Perfil de dispositivo emulado en el cuadro de diálogo común Administración de colores . |
hwndOwner
Identificador de ventana para el propietario del cuadro de diálogo o NULL si el cuadro de diálogo no tiene propietario.
pSourceName
Puntero a una cadena especificada por la aplicación que describe el perfil de origen del elemento para el que se va a realizar la administración de colores. Si es NULL, el control Origen de la imagen muestra el nombre del perfil de color predeterminado de Windows.
pDisplayName
Apunta a una cadena que denomina el monitor que se va a usar para la administración de colores. Si no es el nombre de un monitor válido, se usa el primer monitor enumerado.
pPrinterName
Apunta a una cadena que asigna un nombre a la impresora en la que se va a representar la imagen. Si no es un nombre de impresora válido, se usa la impresora predeterminada y se denomina en el cuadro de diálogo.
dwRenderIntent
Tipo de administración de colores deseada. Los valores válidos son:
INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC
Para obtener más información, vea Rendering intents(Intenciones de representación).
dwProofingIntent
Tipo de administración de colores deseada para la imagen a prueba. Los valores válidos son:
INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC
Para obtener más información, vea Rendering intents(Intenciones de representación).
pMonitorProfile
Puntero a un búfer en el que se va a colocar el nombre del perfil de monitor seleccionado por el usuario. Si se usa la marca CMS_SETMONITORPROFILE, esta marca también se puede usar para seleccionar un perfil que no sea el valor predeterminado del monitor cuando se muestre el cuadro de diálogo por primera vez.
ccMonitorProfile
Tamaño del búfer al que apunta el miembro pMonitorProfile , en caracteres. Si el búfer no es lo suficientemente grande como para contener el nombre seleccionado, el nombre se trunca a este tamaño y se devuelve ERROR_INSUFFICIENT_BUFFER. Siempre funciona un búfer de MAX_PATH tamaño.
pPrinterProfile
Apunta a un búfer en el que se va a colocar el nombre del perfil de impresora seleccionado por el usuario. Si se usa la marca CMS_SETPRINTERPROFILE, esta marca también se puede usar para seleccionar un perfil distinto del predeterminado de la impresora cuando se muestre el cuadro de diálogo por primera vez.
ccPrinterProfile
Tamaño del búfer al que apunta el miembro pPrinterProfile , en caracteres. Si el búfer no es lo suficientemente grande como para contener el nombre seleccionado, el nombre se trunca a este tamaño y se devuelve ERROR_INSUFFICIENT_BUFFER. Siempre funciona un búfer de MAX_PATH tamaño.
pTargetProfile
Apunta a un búfer en el que se va a colocar el nombre del perfil de destino seleccionado por el usuario para la corrección. Si se usa la marca CMS_SETTARGETPROFILE, esta marca también se puede usar para seleccionar un perfil distinto del predeterminado de la impresora cuando se muestra el cuadro de diálogo por primera vez.
ccTargetProfile
Tamaño del búfer al que apunta el miembro pTargetProfile , en caracteres. Si el búfer no es lo suficientemente grande como para contener el nombre seleccionado, el nombre se trunca a este tamaño y se devuelve ERROR_INSUFFICIENT_BUFFER. Siempre funciona un búfer de MAX_PATH tamaño.
lpfnHook
Si se establece la marca CMS_USEHOOK, este miembro es la dirección de un procedimiento de diálogo (consulte DialogProc ) que puede filtrar o controlar los mensajes del diálogo. El procedimiento de enlace no recibe ningún mensaje emitido antes de WM_INITDIALOG. Se llama en el mensaje WM_INITDIALOG después de que el procedimiento de diálogo proporcionado por el sistema haya procesado el mensaje. En todos los demás mensajes, el procedimiento de enlace recibe el mensaje antes del procedimiento proporcionado por el sistema. Si el procedimiento de enlace devuelve TRUE a estos mensajes, no se llama al procedimiento proporcionado por el sistema.
El procedimiento de enlace puede llamar a la función EndDialog .
lParam
Si se establece la marca de CMS_USEHOOK, este miembro se pasa al procedimiento de enlace proporcionado por la aplicación como parámetro lParam cuando se procesa el mensaje de WM_INITDIALOG.
lpfnApplyCallback
Contiene un puntero a una función de devolución de llamada que se invoca cuando se selecciona el botón Aplicar del cuadro de diálogo Administración de colores. Si no se proporciona ninguna función de devolución de llamada, este miembro debe establecerse en NULL. Consulte PCMSCALLBACKW.
lParamApplyCallback
Contiene un valor que se pasará a la función ApplyCallbackFunction a través de su parámetro lParam . La aplicación especifica el significado y el contenido del valor.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado | icm.h |