Поделиться через


Структура 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

См. также раздел