Структура COLORMATCHSETUPW (icm.h)
Структура COLORMATCHSETUP содержит сведения, которые функция SetupColorMatchingW использует для инициализации диалогового окна ColorManagement . После того как пользователь закроет диалоговое окно, SetupColorMatching возвращает сведения о выборе пользователя в этой структуре.
Синтаксис
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;
Члены
dwSize
Размер структуры. Для параметра должно быть задано значение sizeof ( COLORMATCHSETUP ).
dwVersion
Версия структуры COLORMATCHSETUP . Для этого параметра должно быть задано значение COLOR_MATCH_VERSION.
dwFlags
Набор битовых флагов, используемых для инициализации диалогового окна. Если для записи задано значение 0, все элементы управления принимают свои состояния по умолчанию.
Когда диалоговое окно возвращается, эти флаги задаются для указания входных данных пользователя.
Этот элемент можно задать с помощью сочетания следующих флагов.
| Flag | Значение |
|---|---|
| CMS_DISABLEICM | Если задано в записи, этот флаг указывает, что поле "Включить управление цветом" проверка снято, что отключает все остальные элементы управления. Если задано значение при выходе, это означает, что пользователь не хочет, чтобы управление цветом выполнялось. |
| CMS_ENABLEPROOFING | Если задано для записи, этот флаг указывает, что элементы управления правописания должны быть включены, и установлен флажок Правописания проверка. Если задано значение при выходе, это означает, что пользователь хочет управлять цветом для целевого устройства, отличного от выбранного принтера. |
| CMS_SETRENDERINTENT | Если задано для записи, этот флаг указывает, что элемент dwRenderIntent содержит значение, используемое для инициализации элемента управления Намерение отрисовки. В противном случае элемент управления по умолчанию использует отрисовку рисунка. Этот флаг устанавливается при выходе, если wcs включен. |
| CMS_SETPROOFINTENT | Игнорируется, если CMS_ENABLEPROOFING также не задано. Если задано для записи и CMS_ENABLEPROOFING также задано, этот флаг указывает, что элемент dwProofingIntent должен использоваться для инициализации элемента управления Target Rendering Intent. В противном случае элемент управления по умолчанию использует отрисовку рисунка. Этот флаг устанавливается при выходе, если правописания включена. |
| CMS_SETMONITORPROFILE | Если задано для записи, этот флаг указывает, что профиль управления цветом с именем в элементе pMonitorProfile должен быть начальным выбором в элементе управления профилем монитора. Если указанный профиль не связан с монитором, этот флаг игнорируется и используется профиль по умолчанию для монитора. |
| CMS_SETPRINTERPROFILE | Если задано для записи, этот флаг указывает, что профиль управления цветом с именем в элементе pPrinterProfile должен быть начальным выбором в элементе управления профилем принтера. Если указанный профиль не связан с принтером, этот флаг игнорируется и используется профиль по умолчанию для принтера. |
| CMS_SETTARGETPROFILE | Если задано для записи, этот флаг указывает, что цветовой профиль с именем в элементе pTargetProfile должен быть начальным выбором в элементе управления целевым профилем. Если указанный профиль не установлен, этот флаг игнорируется и используется профиль по умолчанию для принтера. Если у принтера нет профиля по умолчанию, отобразится первый профиль в алфавитном порядке. |
| CMS_USEHOOK | Этот флаг указывает, что элемент lpfnHook содержит адрес процедуры перехватчика, а элемент lParam — значение, передаваемое процедуре перехватчика при отправке сообщения WM_INITDIALOG. |
| CMS_MONITOROVERFLOW | Этот флаг устанавливается при выходе, если необходимо включить управление цветом и размер буфера, указанный в ccMonitorProfile , недостаточен для выбранного имени профиля. GetLastError возвращает ERROR_INSUFFICIENT_BUFFER в таком случае. |
| CMS_PRINTERROVERFLOW | Этот флаг устанавливается при выходе, если необходимо включить управление цветом и размер буфера, указанный в ccPrinterProfile , недостаточен для выбранного имени профиля. GetLastError возвращает ERROR_INSUFFICIENT_BUFFER в таком случае. |
| CMS_TARGETOVERFLOW | Этот флаг устанавливается при выходе, если необходимо включить проверку правописания, а размер буфера, указанный в ccTargetProfile , недостаточен для выбранного имени профиля. GetLastError возвращает ERROR_INSUFFICIENT_BUFFER в таком случае. |
| CMS_USEAPPLYCALLBACK | Если задано в записи, этот флаг указывает, что функция SetupColorMatching должна вызывать функцию PCMSCALLBACKW. Адрес функции обратного вызова содержится в lpfnApplyCallback. |
| CMS_USEDESCRIPTION | Если этот флаг задан в записи, функция SetupColorMatching получает описание профиля, содержащееся в тегах описания профиля (см. спецификацию формата профиля ICC версии 3.4). Они будут вставлены в поля редактирования "Профиль монитора", "Профиль принтера", " Эмулированный профиль устройства " в диалоговом окне "Управление цветом ". |
hwndOwner
Дескриптор окна для владельца диалогового окна или значение NULL , если у диалогового окна нет владельца.
pSourceName
Указатель на строку, указанную приложением, которая описывает исходный профиль элемента, для которого должно быть выполнено управление цветом. Если значение равно NULL, в элементе управления "Источник изображений" отображается имя цветового профиля Windows по умолчанию.
pDisplayName
Указывает на строковое имя монитора, используемого для управления цветом. Если это не имя допустимого монитора, используется первый перечислимый монитор.
pPrinterName
Указывает на строку, именующую принтер, на котором должно быть отрисовывается изображение. Если это недопустимое имя принтера, используется принтер по умолчанию и называется в диалоговом окне.
dwRenderIntent
Требуемый тип управления цветом. Допустимые значения:
INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC
Дополнительные сведения см. в разделе Намерения отрисовки.
dwProofingIntent
Тип управления цветом, требуемый для изображения с проверкой. Допустимые значения:
INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC
Дополнительные сведения см. в разделе Намерения отрисовки.
pMonitorProfile
Указатель на буфер, в который нужно поместить имя выбранного пользователем профиля монитора. Если используется флаг CMS_SETMONITORPROFILE, этот флаг также можно использовать для выбора профиля, отличного от стандартного монитора при первом отображении диалогового окна.
ccMonitorProfile
Размер буфера, на который указывает элемент pMonitorProfile , в символах. Если буфер недостаточно велик для хранения выбранного имени, имя усекается до этого размера и возвращается ERROR_INSUFFICIENT_BUFFER. Буфер MAX_PATH размера всегда работает.
pPrinterProfile
Указывает на буфер, в который помещалось имя выбранного пользователем профиля принтера. Если используется флаг CMS_SETPRINTERPROFILE, этот флаг также можно использовать для выбора профиля, отличного от используемого по умолчанию принтера при первом отображении диалогового окна.
ccPrinterProfile
Размер буфера, на который указывает элемент pPrinterProfile , в символах. Если буфер недостаточно велик для хранения выбранного имени, имя усекается до этого размера и возвращается ERROR_INSUFFICIENT_BUFFER. Буфер MAX_PATH размера всегда работает.
pTargetProfile
Указывает на буфер, в который помещать имя выбранного пользователем целевого профиля для проверки правописания. Если используется флаг CMS_SETTARGETPROFILE, этот флаг также можно использовать для выбора профиля, отличного от используемого по умолчанию принтера при первом отображении диалогового окна.
ccTargetProfile
Размер буфера, на который указывает элемент pTargetProfile , в символах. Если буфер недостаточно велик для хранения выбранного имени, имя усекается до этого размера и возвращается ERROR_INSUFFICIENT_BUFFER. Буфер MAX_PATH размера всегда работает.
lpfnHook
Если установлен флаг CMS_USEHOOK, этот элемент является адресом процедуры диалога (см. Раздел DialogProc ), который может фильтровать или обрабатывать сообщения для диалога. Процедура перехватчика не получает сообщений, выданных до WM_INITDIALOG. Он вызывается в сообщении WM_INITDIALOG после обработки сообщения, предоставленной системой. Во всех остальных сообщениях процедура перехватчика получает сообщение до предоставленной системой процедуры. Если процедура перехватчика возвращает к этим сообщениям значение TRUE , то предоставленная системой процедура не вызывается.
Процедура перехватчика может вызывать функцию EndDialog .
lParam
Если установлен флаг CMS_USEHOOK, этот элемент передается в предоставленную приложением процедуру перехватчика в качестве параметра lParam при обработке сообщения WM_INITDIALOG.
lpfnApplyCallback
Содержит указатель на функцию обратного вызова, которая вызывается при выборе кнопки Применить диалогового окна Управление цветом. Если функция обратного вызова не указана, для этого элемента должно быть задано значение NULL. См . раздел PCMSCALLBACKW.
lParamApplyCallback
Содержит значение, которое будет передано функции ApplyCallbackFunction через ее параметр lParam . Значение и содержимое значения определяется приложением.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | icm.h |