_CPSUICALLBACK Rückruffunktion (compstui.h)

Der _CPSUICALLBACK Funktionstyp wird von CPSUI-Anwendungen (einschließlich Druckerschnittstellen-DLLs) zum Definieren einer Rückruffunktion verwendet, die als CPSUI-Nachrichtenhandlerverwendet werden soll.

Syntax

_CPSUICALLBACK Cpsuicallback;

LONG Cpsuicallback(
  PCPSUICBPARAM pCPSUICBParam
)
{...}

Parameter

pCPSUICBParam

CPSUI-bereitgestellter Zeiger auf eine CPSUICBPARAM- Struktur.

Rückgabewert

Eine _CPSUICALLBACK-Typ-Rückruffunktion muss einen der in der folgenden Tabelle aufgeführten Werte zurückgeben. Jeder Wert gibt eine Aktion an, die CPSUI ausführen soll.

Rückgabecode	Beschreibung
CPSUICB_ACTION_ITEMS_APPLIED	Die CPSUICBPARAM Struktur Reason Member wurde auf CPSUICB_REASON_APPLYNOW festgelegt, und die Rückruffunktion hat die aktuellen Optionswerte erfolgreich verarbeitet.
CPSUICB_ACTION_NO_APPLY_EXIT	Die CPSUICBPARAM Struktur Reason Member wurde auf CPSUICB_REASON_APPLYNOW festgelegt, aber die Rückruffunktion hat ungültige oder inkompatible Optionswerte erkannt. Die Rückruffunktion muss ein Dialogfeld anzeigen, in dem der Benutzer über das Problem informiert wird.
CPSUICB_ACTION_NONE	Es ist keine Aktion von CPSUI erforderlich.
CPSUICB_ACTION_OPTIF_CHANGED	Die Rückruffunktion hat das OPTIF_CHANGED Flag in einer OPTITEM- Struktur festgelegt, um anzugeben, dass sich die ausgewählte Option geändert hat oder ein anderes OPTIF-Präfix-Flag geändert wurde.
CPSUICB_ACTION_REINIT_ITEMS	Die Rückruffunktion hat das OPTIF_CHANGED Flag in einer OPTITEM- Struktur festgelegt, um anzugeben, dass Flags oder pData Member der zugeordneten OPTTYPE oder OPTPARAM- Struktur geändert wurden.

Bemerkungen

Rückruffunktionen, die mithilfe des funktionstyps _CPSUICALLBACK angegeben werden, werden von Anwendungen bereitgestellt, die CPSUI- zum Verwalten von Eigenschaftenblattseiten verwenden. Wenn eine dieser Rückruffunktionen einer Eigenschaftenblattseite zugeordnet ist, ruft CPSUI sie auf, wenn Benutzeraktivitäten (z. B. ändern des Steuerelementfokus der Seite, Ändern von Optionswerten oder Klicken auf OK) erkannt werden.

Eine _CPSUICALLBACK-Typ-Rückruffunktion wird einer Eigenschaftenblattseite zugewiesen, indem sie ihre Adresse in eine COMPROPSHEETUI- Struktur einbezieht, die an die ComPropSheet--Funktion von CPSUI übergeben wird, wenn der Funktionscode CPSFUNC_ADD_PCOMPROPSHEETUIist.

Darüber hinaus können Rückruffunktionen erweiterten Pushtasten mithilfe von EXTPUSH- Strukturen zugewiesen werden.

Wenn eine dieser Rückruffunktionen aufgerufen wird, empfängt sie einen Zeiger auf eine CPSUICBPARAM- Struktur. Diese Struktur beschreibt die aktuellen Optionseinstellungen für die Seite und gibt das Benutzerereignis an, das dazu führte, dass die Funktion aufgerufen wurde. Die Rückruffunktion ist für die Überprüfung und Verarbeitung der Einstellungen verantwortlich. Es sollte ein Dialogfeld angezeigt werden, wenn eine Einstellung (oder eine Kombination von Einstellungen) ungültig ist. Der Rückgabewert der Funktion gibt cpSUI an, ob die Seite erneut angezeigt oder neu initialisiert werden muss.

Rückruffunktionen, die mit diesem Funktionstyp angegeben sind, können nicht verwendet werden, wenn das DlgProc Member der DLGPAGE- Struktur eine vom Anwendung bereitgestellte Dialogfeldprozedur angibt. Dies liegt daran, dass _CPSUICALLBACK typgesteuerte Rückrufe aus den Dialogfeldprozeduren von CPSUI aufgerufen werden, die nicht verwendet werden, wenn die Anwendung eigene Prozeduren bereitstellt.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	compstui.h (include Compstui.h)