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.
| Flag | Bedeutung |
|---|---|
| CMS_DISABLEICM | Wenn dieser Eintrag festgelegt ist, gibt dieses Flag an, dass das Kontrollkästchen "Farbverwaltung aktivieren" deaktiviert ist, wodurch alle anderen Steuerelemente deaktiviert werden. Wenn die Einstellung beim Beenden festgelegt ist, bedeutet dies, dass der Benutzer die Farbverwaltung nicht ausführen möchte. |
| CMS_ENABLEPROOFING | Wenn für den Eintrag festgelegt ist, gibt dieses Flag an, dass die Proofing-Steuerelemente aktiviert und das Kontrollkästchen Proofing aktiviert ist. Wenn die Einstellung beim Beenden festgelegt ist, bedeutet dies, dass der Benutzer die Farbverwaltung für ein anderes Zielgerät als den ausgewählten Drucker durchführen möchte. |
| CMS_SETRENDERINTENT | Wenn dieses Flag für den Eintrag festgelegt ist, gibt dieses Flag an, dass der dwRenderIntent-Member den Wert enthält, der zum Initialisieren des Rendering Intent-Steuerelements verwendet werden soll. Andernfalls wird das Steuerelement standardmäßig auf Bildrendering festgelegt. Dieses Flag wird beim Beenden festgelegt, wenn WCS aktiviert ist. |
| CMS_SETPROOFINTENT | Wird ignoriert, es sei denn, CMS_ENABLEPROOFING ebenfalls festgelegt ist. Wenn für den Eintrag festgelegt und CMS_ENABLEPROOFING ebenfalls festgelegt ist, gibt dieses Flag an, dass der dwProofingIntent-Member zum Initialisieren des Zielrenderingabsicht-Steuerelements verwendet werden soll. Andernfalls wird das Steuerelement standardmäßig auf Bildrendering festgelegt. Dieses Flag wird beim Beenden festgelegt, wenn die Korrekturhilfe aktiviert ist. |
| CMS_SETMONITORPROFILE | Wenn für den Eintrag festgelegt ist, gibt dieses Flag an, dass das Farbverwaltungsprofil mit dem Namen im pMonitorProfile-Element die anfängliche Auswahl im Monitorprofilsteuerelement sein soll. Wenn das angegebene Profil nicht dem Monitor zugeordnet ist, wird dieses Flag ignoriert, und das Standardprofil für den Monitor wird verwendet. |
| CMS_SETPRINTERPROFILE | Bei Festlegung auf eintrag gibt dieses Flag an, dass das Farbverwaltungsprofil mit dem Namen im pPrinterProfile-Element die anfängliche Auswahl im Druckerprofilsteuerelement sein soll. Wenn das angegebene Profil nicht dem Drucker zugeordnet ist, wird dieses Flag ignoriert, und das Standardprofil für den Drucker wird verwendet. |
| CMS_SETTARGETPROFILE | Wenn für den Eintrag festgelegt ist, gibt dieses Flag an, dass das Farbprofil mit dem Namen im pTargetProfile-Element die anfängliche Auswahl im Zielprofilsteuerelement sein soll. Wenn das angegebene Profil nicht installiert ist, wird dieses Flag ignoriert, und das Standardprofil für den Drucker wird verwendet. Wenn der Drucker kein Standardprofil hat, wird das erste Profil in alphabetischer Reihenfolge angezeigt. |
| CMS_USEHOOK | Dieses Flag gibt an, dass der lpfnHook-Member die Adresse einer Hookprozedur enthält und das lParam-Element einen Wert enthält, der an die Hookprozedur übergeben werden soll, wenn die WM_INITDIALOG Nachricht gesendet wird. |
| CMS_MONITOROVERFLOW | Dieses Flag wird beim Beenden festgelegt, wenn die Farbverwaltung aktiviert werden soll und die in ccMonitorProfile angegebene Puffergröße für den ausgewählten Profilnamen nicht ausreicht. GetLastError gibt in einem solchen Fall ERROR_INSUFFICIENT_BUFFER zurück. |
| CMS_PRINTERROVERFLOW | Dieses Flag wird beim Beenden festgelegt, wenn die Farbverwaltung aktiviert werden soll und die in ccPrinterProfile angegebene Puffergröße für den ausgewählten Profilnamen nicht ausreicht. GetLastError gibt in einem solchen Fall ERROR_INSUFFICIENT_BUFFER zurück. |
| CMS_TARGETOVERFLOW | Dieses Flag wird beim Beenden festgelegt, wenn die Korrekturhilfe aktiviert werden soll und die in ccTargetProfile angegebene Puffergröße für den ausgewählten Profilnamen nicht ausreicht. GetLastError gibt in einem solchen Fall ERROR_INSUFFICIENT_BUFFER zurück. |
| CMS_USEAPPLYCALLBACK | Wenn dieser Eintrag festgelegt ist, gibt dieses Flag an, dass die SetupColorMatching-Funktion die Funktion PCMSCALLBACKW aufrufen soll. Die Adresse der Rückruffunktion ist in lpfnApplyCallback enthalten. |
| CMS_USEDESCRIPTION | Wenn dieses Flag für den Eintrag festgelegt ist, weist dieses Flag die SetupColorMatching-Funktion an, die Profilbeschreibung abzurufen, die in den Profilbeschreibungstags enthalten ist (siehe ICC-Profilformatspezifikation v3.4). Sie werden in die Bearbeitungsfelder Monitorprofil, Druckerprofil, Emuliertes Geräteprofil im Dialogfeld Allgemeine Farbverwaltung eingefügt. |
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
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile | icm.h |
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für