OEMCUIPCALLBACK-Rückruffunktion (printoem.h)

  • Artikel

Der OEMCUIPCALLBACK-Funktionstyp wird verwendet, um Rückruffunktionen zu definieren, die durch die IPrintOemUI::CommonUIProp-Methode eines Benutzeroberflächen-Plug-Ins angegeben werden. Die -Struktur ist in printoem.h definiert.

Syntax

OEMCUIPCALLBACK Oemcuipcallback;

LONG Oemcuipcallback(
  PCPSUICBPARAM unnamedParam1,
  POEMCUIPPARAM unnamedParam2
)
{...}

Parameter

unnamedParam1

Zeiger auf eine CPSUICBPARAM-Struktur .

unnamedParam2

Zeiger auf eine OEMCUIPPARAM-Struktur .

Rückgabewert

Weitere Informationen finden Sie im abschnitt "Hinweise".

Hinweise

Eine Rückruffunktion, die von einer IPrintOemUI::CommonUIProp-Methode angegeben wird, wird aufgerufen, wenn ein Benutzer ein Druckereigenschaftenblatt ändert. Der Zweck der Rückruffunktion besteht darin, Benutzeränderungen an benutzerdefinierten Optionselementen zu verarbeiten.

Wenn ein Eigenschaftenblattelement geändert wird, ruft CPSUI die Druckerschnittstellen-DLL des Druckertreibers auf. Diese DLL enthält eine eigene Rückruffunktion vom Typ _CPSUICALLBACK, die Optionswerte verarbeitet, die in ihren eigenen OPTITEM-Strukturen enthalten sind. Anschließend ruft die Rückruffunktion der Druckerschnittstellen-DLL die Rückruffunktion des Benutzeroberflächen-Plug-Ins auf. Wenn mehrere Benutzeroberflächen-Plug-Ins bereitgestellt werden, wird die Rückruffunktion jedes Plug-Ins wiederum in der Reihenfolge aufgerufen, in der die Plug-Ins installiert wurden.

Die Rückruffunktion empfängt einen Zeiger auf eine CPSUICBPARAM-Struktur . Der Reason-Member der Struktur identifiziert das Ereignis, das den Aufruf der Rückruffunktion verursacht hat. Die Funktion empfängt auch einen Zeiger auf dieselbe OEMCUIPPARAM-Struktur , die verwendet wurde, als die IPrintOemUI::CommonUIProp-Methode die Adresse der Rückruffunktion angegeben hat.

Die pOptItem- und pCurItem-Elemente der CPSUICBPARAM-Struktur identifizieren die geänderte Option. Die Rückruffunktion kann diese Zeiger zusammen mit den pOEMOptItems - und cOEMOptItem-Membern der OEMCUIPPARAM-Struktur verwenden, um zu bestimmen, ob die geänderte Option im Besitz des Benutzeroberflächen-Plug-Ins ist.

Wenn eine Rückruffunktion aufgerufen wird, muss sie bestimmen, ob eine ihrer angepassten OPTITEM-Strukturen vom angegebenen Reason-Wert betroffen ist. Wenn dies der Grund ist, sollte die Funktion die betroffenen Optionen verarbeiten und einen der rückgabewerte mit CPSUI_ACTION Präfix zurückgeben, die für den funktionstyp _CPSUICALLBACK beschrieben sind. Andernfalls sollte CPSUICB_ACTION_NONE zurückgegeben werden.

Die folgenden zusätzlichen Regeln gelten für Rückgabewerte der Rückruffunktion:

  • Wenn Reason CPSUICB_REASON_APPLYNOW enthält, muss der Rückruf entweder CPSUICB_ACTION_ITEMS_APPLIED oder CPSUICB_ACTION_NO_APPLY_EXIT zurückgeben. Im letzteren Fall kehrt die Druckertreiberschnittstelle sofort zu CPSUI zurück, ohne die Rückruffunktion eines anderen Benutzeroberflächen-Plug-Ins aufzurufen.

  • Wenn Reason einen Wert außer CPSUICB_REASON_APPLYNOW enthält, muss der Rückgabewert einer der folgenden Sein:

    • CPSUICB_ACTION_REINIT_ITEMS

    • CPSUICB_ACTION_OPTIF_CHANGED

    • CPSUICB_ACTION_NONE

      Diese Rückgabewerte werden in der Reihenfolge der abnehmenden Priorität aufgeführt. Wenn mehrere Benutzeroberflächen-Plug-Ins vorhanden sind, ruft die Dll der Druckerschnittstelle die Rückruffunktion jedes Einzelnen auf und speichert den Rückgabewert mit der höchsten Priorität und übergibt ihn zurück an CPSUI.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile printoem.h (include Printoem.h, Compstui.h)