COLORMATCHSETUPW-Struktur (icm.h)

Die COLORMATCHSETUP-Struktur enthält Informationen, die die SetupColorMatchingW-Funktion zum Initialisieren des Dialogfelds ColorManagement verwendet. Nachdem der Benutzer das Dialogfeld geschlossen hat, gibt SetupColorMatching Informationen zur Auswahl des Benutzers in dieser Struktur zurück.

Syntax

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;

Members

dwSize

Größe der -Struktur. Sollte auf sizeof ( COLORMATCHSETUP ) festgelegt werden.

dwVersion

Version der COLORMATCHSETUP-Struktur . Dies sollte auf COLOR_MATCH_VERSION festgelegt werden.

dwFlags

Eine Reihe von Bitflags, die zum Initialisieren des Dialogfelds verwendet werden. Wenn sie bei der Eingabe auf 0 festgelegt ist, nehmen alle Steuerelemente ihren Standardstatus an.

Wenn das Dialogfeld zurückgegeben wird, werden diese Flags so festgelegt, dass sie die Eingabe des Benutzers angeben.

Dieses Element kann mithilfe einer Kombination der folgenden Flags festgelegt werden.

hwndOwner

Das Fensterhandle für den Besitzer des Dialogfelds oder NULL , wenn das Dialogfeld keinen Besitzer hat.

pSourceName

Zeiger auf eine anwendungsspezifische Zeichenfolge, die das Quellprofil des Elements beschreibt, für das die Farbverwaltung ausgeführt werden soll. Wenn dies NULL ist, zeigt das Image Source-Steuerelement den Namen des Windows-Standardfarbprofils an.

pDisplayName

Verweist auf eine Zeichenfolge mit dem Namen des Monitors, der für die Farbverwaltung verwendet werden soll. Wenn dies nicht der Name eines gültigen Monitors ist, wird der erste aufgezählte Monitor verwendet.

pPrinterName

Verweist auf eine Zeichenfolge mit dem Namen des Druckers, auf dem das Bild gerendert werden soll. Wenn es sich nicht um einen gültigen Druckernamen handelt, wird der Standarddrucker verwendet und im Dialogfeld benannt.

dwRenderIntent

Der typ der gewünschten Farbverwaltung. Gültige Werte sind:

INTENT_PERCEPTUAL

INTENT_SATURATION

INTENT_RELATIVE_COLORIMETRIC

INTENT_ABSOLUTE_COLORIMETRIC

Weitere Informationen finden Sie unter Renderingabsichten.

dwProofingIntent

Der Typ der Farbverwaltung, die für das geprüfte Bild gewünscht wird. Gültige Werte sind:

INTENT_PERCEPTUAL

INTENT_SATURATION

INTENT_RELATIVE_COLORIMETRIC

INTENT_ABSOLUTE_COLORIMETRIC

Weitere Informationen finden Sie unter Renderingabsichten.

pMonitorProfile

Zeiger auf einen Puffer, in dem der Name des vom Benutzer ausgewählten Monitorprofils platziert werden soll. Wenn das flag CMS_SETMONITORPROFILE verwendet wird, kann dieses Flag auch verwendet werden, um ein anderes Profil als den Monitorstandard auszuwählen, wenn das Dialogfeld zum ersten Mal angezeigt wird.

ccMonitorProfile

Die Größe des Puffers, auf den der pMonitorProfile-Member in Zeichen verweist. Wenn der Puffer nicht groß genug ist, um den ausgewählten Namen zu enthalten, wird der Name auf diese Größe abgeschnitten, und ERROR_INSUFFICIENT_BUFFER wird zurückgegeben. Ein Puffer von MAX_PATH Größe funktioniert immer.

pPrinterProfile

Zeigt auf einen Puffer, in dem der Name des vom Benutzer ausgewählten Druckerprofils platziert werden soll. Wenn das flag CMS_SETPRINTERPROFILE verwendet wird, kann dieses Flag auch verwendet werden, um ein anderes Profil als den Druckerstandard auszuwählen, wenn das Dialogfeld zum ersten Mal angezeigt wird.

ccPrinterProfile

Die Größe des Puffers, auf den der pPrinterProfile-Member in Zeichen verweist. Wenn der Puffer nicht groß genug ist, um den ausgewählten Namen zu enthalten, wird der Name auf diese Größe abgeschnitten, und ERROR_INSUFFICIENT_BUFFER wird zurückgegeben. Ein Puffer von MAX_PATH Größe funktioniert immer.

pTargetProfile

Verweist auf einen Puffer, in dem der Name des vom Benutzer ausgewählten Zielprofils zur Korrekturprüfung platziert werden soll. Wenn das flag CMS_SETTARGETPROFILE verwendet wird, kann dieses Flag auch verwendet werden, um ein anderes Profil als den Druckerstandard auszuwählen, wenn das Dialogfeld zum ersten Mal angezeigt wird.

ccTargetProfile

Die Größe des Puffers, auf den das pTargetProfile-Element in Zeichen verweist. Wenn der Puffer nicht groß genug ist, um den ausgewählten Namen zu enthalten, wird der Name auf diese Größe abgeschnitten, und ERROR_INSUFFICIENT_BUFFER wird zurückgegeben. Ein Puffer von MAX_PATH Größe funktioniert immer.

lpfnHook

Wenn das CMS_USEHOOK-Flag festgelegt ist, ist dieses Element die Adresse einer Dialogprozedur (siehe DialogProc ), die Nachrichten für den Dialog filtern oder verarbeiten kann. Die Hookprozedur empfängt keine Nachrichten, die vor WM_INITDIALOG ausgegeben werden. Sie wird für die WM_INITDIALOG Meldung aufgerufen, nachdem die vom System bereitgestellte Dialogprozedur die Nachricht verarbeitet hat. Bei allen anderen Nachrichten empfängt die Hookprozedur die Nachricht vor der vom System bereitgestellten Prozedur. Wenn die Hookprozedur TRUE für diese Meldungen zurückgibt, wird die vom System bereitgestellte Prozedur nicht aufgerufen.

Die Hookprozedur kann die EndDialog-Funktion aufrufen.

lParam

Wenn das flag CMS_USEHOOK festgelegt ist, wird dieses Element an die von der Anwendung bereitgestellte Hookprozedur als lParam-Parameter übergeben, wenn die WM_INITDIALOG Nachricht verarbeitet wird.

lpfnApplyCallback

Enthält einen Zeiger auf eine Rückruffunktion, die aufgerufen wird, wenn die Schaltfläche Anwenden des Dialogfelds Farbverwaltung ausgewählt ist. Wenn keine Rückruffunktion bereitgestellt wird, sollte dieser Member auf NULL festgelegt werden. Siehe PCMSCALLBACKW.

lParamApplyCallback

Enthält einen Wert, der über den lParam-Parameter an die Funktion ApplyCallbackFunction übergeben wird. Die Bedeutung und der Inhalt des Werts werden von der Anwendung angegeben.

Anforderungen

Weitere Informationen

• Ein allgemeines Dialogfeld für die Farbverwaltung
• DialogProc
• EndDialog