Platforms to show: All Mac Windows Linux Cross-Platform
WindowsICMSetupMBS class
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| class | Windows ICM | MBS Win Plugin | 11.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
This class contains information that the Setup function uses to initialize the ColorManagement dialog box. After the user closes the dialog box, Setup returns information about the user's selection in this class.
- 2 events
- 10 properties
- property DisplayName as String
- property Flags as Integer
- property MonitorProfile as String
- property Parent as Variant
- property PrinterName as String
- property PrinterProfile as String
- property ProofingIntent as Integer
- property RenderIntent as Integer
- property SourceName as String
- property TargetProfile as String
- method Setup as boolean
- 16 constants
Flag Constants
| Constant | Value | Description |
|---|---|---|
| CMS_DISABLEICM | 1 |
If set on entry, this flag indicates that the "Enable Color Management" check box is cleared, disabling all other controls. If set on exit, it means that the user does not wish color management performed. |
| CMS_DISABLEINTENT | 1024 | |
| CMS_DISABLERENDERINTENT | 2048 | |
| CMS_ENABLEPROOFING | 2 |
If set on entry, this flag indicates that the Proofing controls are to be enabled, and the Proofing check box is checked. If set on exit, it means that the user wishes to perform color management for a different target device than the selected printer. |
| CMS_SETMONITORPROFILE | 16 |
If set on entry, this flag indicates that the color management profile named in the MonitorProfile member is to be the initial selection in the monitor profile control. If the specified profile is not associated with the monitor, this flag is ignored, and the default profile for the monitor is used. |
| CMS_SETPRINTERPROFILE | 32 |
If set on entry, this flag indicates that the color management profile named in the PrinterProfile member is to be the initial selection in the printer profile control. If the specified profile is not associated with the printer, this flag is ignored, and the default profile for the printer is used. |
| CMS_SETPROOFINTENT | 5 |
Ignored unless CMS_ENABLEPROOFING is also set. If set on entry, and CMS_ENABLEPROOFING is also set, this flag indicates that the ProofingIntent member is to be used to initialize the Target Rendering Intent control. Otherwise, the control defaults to Picture rendering. This flag is set on exit if proofing is enabled. |
| CMS_SETRENDERINTENT | 4 |
If set on entry, this flag indicates that the RenderIntent member contains the value to use to initialize the Rendering Intent control. Otherwise, the control defaults to Picture rendering. This flag is set on exit if WCS is enabled. |
| CMS_SETTARGETPROFILE | 64 |
If set on entry, this flag indicates that the color profile named in the TargetProfile member is to be the initial selection in the target profile control. If the specified profile is not installed, this flag is ignored, and the default profile for the printer is used. If the printer has no default profile, then the first profile in alphabetical order will be displayed. |
| CMS_USEAPPLYCALLBACK | 256 |
If set on entry, this flag indicates that the SetupColorMatching function should call the Apply event. |
| CMS_USEDESCRIPTION | 512 |
If set on entry, this flag instructs the Setup function to retrieve the profile description contained in the profile description tags (See ICC Profile Format Specification v3.4). It will insert them into the Monitor Profile, Printer Profile, Emulated Device Profile edit boxes in the Color Management common dialog box. |
| CMS_USEHOOK | 128 |
The idle event is called regularly if this flag is set. |
Rendering Intent Constants
| Constant | Value | Description |
|---|---|---|
| INTENT_ABSOLUTE_COLORIMETRIC | 3 |
Maintain the white point. Match the colors to their nearest color in the destination gamut. |
| INTENT_PERCEPTUAL | 0 |
Maintain contrast. Used for photographs and natural images. |
| INTENT_RELATIVE_COLORIMETRIC | 1 |
Maintain colorimetric match. Used for graphic designs and named colors. |
| INTENT_SATURATION | 2 |
Maintain saturation. Used for business charts and other situations in which undithered colors are required. |
This class has no sub classes.
Some examples using this class:
Blog Entries
Release notes
- Version 22.0
- Changed window properties to variant, so you can use DesktopWindow there for WindowsShortCutMBS, WindowsPrintDialogMBS, WindowsPageSetupDialogMBS, WindowsICMSetupMBS, WindowsBlueToothSelectDeviceDialogMBS, TwainMBS, TaskDialogMBS, OpenDialogMBS, DirectShowVideoWindowMBS, WindowsStoreContextMBS, WindowsFileCopyMBS, WindowsFontDialogMBS, WindowsPreviewHandlerMBS, WindowsStoreContextMBS, ParentChromiumFrameMBS and ChromiumBrowserMBS classes.
The items on this page are in the following plugins: MBS Win Plugin.
WindowsICMProfileMBS - WindowsICMTransformMBS
