Share via


SetupColorMatching

The SetupColorMatching function creates a Color Management dialog box that lets the user choose whether to enable color management, and if so, provides control over the color profiles used and over the rendering intent.

BOOL WINAPI SetupColorMatching(
  PCOLORMATCHSETUP pcms);

Parameters

  • pcms
    Pointer to a COLORMATCHSETUP structure that on entry contains information used to initialize the dialog box.

    When SetupColorMatching returns, if the user clicked the OK button, this structure contains information about the user's selection. Otherwise, if an error occurred or the user canceled the dialog box, the structure is left unchanged.

Return Values

If this function succeeds, the return value is TRUE indicating that no errors occurred and the user clicked the OK button.

If this function fails, the return value is FALSE indicating that an error occurred or the dialog was canceled. For extended error information, call GetLastError.

Requirements

**  Windows NT/2000/XP/Vista:** Included in Windows 2000 and later.
**  Windows 95/98/Me:** Included in Windows 98 and later.
**  Header:** Declared in Icm.h.
**  Library:** Use Icmui.lib.
**  Unicode:** Implemented as Unicode and ANSI versions on Windows 2000/XP/Vista.

See Also

Basic Color Management Concepts, Functions