Estructura COLORMATCHSETUPW (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 _tagCOLORMATCHSETUPW {
DWORD dwSize;
DWORD dwVersion;
DWORD dwFlags;
HWND hwndOwner;
PCWSTR pSourceName;
PCWSTR pDisplayName;
PCWSTR pPrinterName;
DWORD dwRenderIntent;
DWORD dwProofingIntent;
PWSTR pMonitorProfile;
DWORD ccMonitorProfile;
PWSTR pPrinterProfile;
DWORD ccPrinterProfile;
PWSTR pTargetProfile;
DWORD ccTargetProfile;
DLGPROC lpfnHook;
LPARAM lParam;
PCMSCALLBACKW lpfnApplyCallback;
LPARAM lParamApplyCallback;
} COLORMATCHSETUPW, *PCOLORMATCHSETUPW, *LPCOLORMATCHSETUPW;
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
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 que la casilla Corrección está activada. 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 De intención de representación. De lo contrario, el control tiene como valor predeterminado La 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 La 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 debe ser 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 de 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 de 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 la administración de colores se va a habilitar y el tamaño del búfer especificado 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 la administración de colores se va a habilitar 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 Icc Profile Format Specification 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 Image Source muestra el nombre del perfil de color predeterminado de Windows.
pDisplayName
Apunta a una cadena que asigna un nombre al monitor que se 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 deseado 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 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. Un búfer de MAX_PATH tamaño siempre funciona.
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. Un búfer de MAX_PATH tamaño siempre funciona.
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 muestre 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. Un búfer de MAX_PATH tamaño siempre funciona.
lpfnHook
Si se establece la marca CMS_USEHOOK, este miembro es la dirección de un procedimiento de diálogo (vea 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 al 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 CMS_USEHOOK, este miembro se pasa al procedimiento de enlace proporcionado por la aplicación como parámetro lParam cuando se procesa el mensaje 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 |
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de