PCMSCALLBACKW-Rückruffunktion (icm.h)

Artikel
08/24/2023

*PCMSCALLBACKW* (oder ApplyCallbackFunction) ist eine Rückruffunktion, die Sie implementieren, die die WCS-Konfigurationsdaten aktualisiert, während das von der SetupColorMatchingW-Funktion angezeigte Dialogfeld ausgeführt wird. Der Name ApplyCallbackFunction ist ein Platzhalter. Der tatsächliche Name dieser Rückruffunktion wird von Ihrer Anwendung mithilfe von ICM angegeben.

Syntax

PCMSCALLBACKW Pcmscallbackw;

BOOL Pcmscallbackw(
  _tagCOLORMATCHSETUPW *unnamedParam1,
  LPARAM unnamedParam2
)
{...}

Parameter

unnamedParam1

Zeiger auf eine COLORMATCHSETUPW-Struktur , die WCS-Konfigurationsdaten enthält.

unnamedParam2

Enthält einen von der Anwendung bereitgestellten Wert.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE. Die Rückruffunktion kann die erweiterten Fehlerinformationen festlegen, indem SetLastError aufgerufen wird.

Hinweise

Die ApplyCallbackFunction-Funktion wird verwendet, um die WCS-Konfiguration für ein Gerät zu ändern, während das Dialogfeld Farbverwaltung angezeigt wird. Das Dialogfeld Farbverwaltung wird von der Funktion SetupColorMatchingW angezeigt.

Wenn die Rückruffunktion bereitgestellt wird, wird unten rechts im Dialogfeld die Schaltfläche Anwenden angezeigt. Wenn Sie die Schaltfläche Anwenden auswählen, aktualisiert die Rückruffunktion sofort die Konfiguration für das einzurichtende Gerät. Das Dialogfeld Farbverwaltung bleibt auf dem Bildschirm.

Eine Anwendung stellt eine Rückruffunktion für WCS bereit, indem die Adresse der Rückruffunktion in der COLORMATCHSETUPW-Struktur gespeichert wird, die an die SetupColorMatchingW-Funktion übergeben wird. Die Adresse wird im lPfnApplyCallback-Member der COLORMATCHSETUP-Struktur gespeichert. Das dwFlags-Element sollte auf CMS_USEAPPLYCALLBACK festgelegt werden, andernfalls wird die Rückruffunktion ignoriert.

Ein von der Anwendung bereitgestellter Wert kann an die Rückruffunktion übergeben werden. Vor dem Aufrufen der SetupColorMatchingW-Funktion kann die Anwendung einen Wert im lParamApplyCallback-Member der COLORMATCHSETUPW-Struktur speichern. Wenn die Rückruffunktion aufgerufen wird, wird der Wert im lParamApplyCallback-Strukturmember an die Rückruffunktion im lParam-Parameter übergeben.

Die Rückruffunktion ist vollständig optional. Wenn sie nicht angegeben wird, wird die Schaltfläche Anwenden im Dialogfeld Farbverwaltung nicht angezeigt. Microsoft empfiehlt dringend, dass Ihre Anwendung eine Rückruffunktion bereitstellt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	icm.h

Share via