(icm.h) COLORMATCHSETUPW 結構

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，則所有控制項都會假設其預設狀態。

當對話方塊傳回時，這些旗標會設定為指出使用者的輸入。

您可以使用下列旗標的組合來設定此成員。

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旗標，當處理WM_INITDIALOG訊息時，此成員會傳遞至應用程式提供的勾點程式做為 lParam 參數。

lpfnApplyCallback

包含選取 [色彩管理] 對話方塊的 [ 套 用] 按鈕時所叫用回呼函式的指標。 如果未提供回呼函式，此成員應該設定為 Null。 請參閱 PCMSCALLBACKW。

lParamApplyCallback

包含值，該值會透過其 lParam參數傳遞至函式 ApplyCallbackFunction。 值的意義和內容是由應用程式指定。

需求

另請參閱

• 色彩管理的常見對話方塊
• DialogProc
• EndDialog