_CPSUICALLBACK Rückruffunktion (compstui.h)

Der _CPSUICALLBACK Funktionstyp wird von CPSUI-Anwendungen (einschließlich Druckerschnittstellen-DLLs) verwendet, um eine Rückruffunktion zu definieren, die als CPSUI-Nachrichtenhandler verwendet werden soll.

Syntax

_CPSUICALLBACK Cpsuicallback;

LONG Cpsuicallback(
  PCPSUICBPARAM pCPSUICBParam
)
{...}

Parameter

pCPSUICBParam

Von CPSUI bereitgestellter Zeiger auf eine CPSUICBPARAM-Struktur .

Rückgabewert

Eine _CPSUICALLBACK typisierte 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	Der Reason-Member der CPSUICBPARAM-Struktur wurde auf CPSUICB_REASON_APPLYNOW festgelegt, und die Rückruffunktion hat die aktuellen Optionswerte erfolgreich verarbeitet.
CPSUICB_ACTION_NO_APPLY_EXIT	Der Reason-Member der CPSUICBPARAM-Struktur wurde auf CPSUICB_REASON_APPLYNOW festgelegt, aber die Rückruffunktion hat ungültige oder inkompatible Optionswerte erkannt. Die Rückruffunktion muss ein Dialogfeld anzeigen, das den Benutzer über das Problem informiert.
CPSUICB_ACTION_NONE	Es ist keine Aktion von CPSUI erforderlich.
CPSUICB_ACTION_OPTIF_CHANGED	Die Rückruffunktion hat das flag OPTIF_CHANGED in einer OPTITEM-Struktur festgelegt, um anzugeben, dass sich die ausgewählte Option geändert hat oder dass ein anderes Flag mit OPTIF-Präfix 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.

Hinweise

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 typisierte Rückruffunktion wird einer Eigenschaftenblattseite zugewiesen, indem ihre Adresse in eine COMPROPSHEETUI-Struktur eingeschlossen wird, die an die ComPropSheetSheet-Funktion von CPSUI übergeben wird, wenn der Funktionscode CPSFUNC_ADD_PCOMPROPSHEETUI ist.

Darüber hinaus können Rückruffunktionen erweiterten Pushtasten durch die Verwendung 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, durch das 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 aus Einstellungen) ungültig ist. Der Rückgabewert der Funktion gibt CPSUI an, ob die Seite erneut angezeigt oder neu initialisiert werden muss.

Mit diesem Funktionstyp angegebene Rückruffunktionen können nicht verwendet werden, wenn der DlgProc-Member der DLGPAGE-Struktur eine von der Anwendung bereitgestellte Dialogfeldprozedur angibt. Dies liegt daran, dass _CPSUICALLBACK typisierte Rückrufe aus den CpSUI-Dialogfeldprozeduren aufgerufen werden, die nicht verwendet werden, wenn die Anwendung eigene Prozeduren bereitstellt.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	compstui.h (include Compstui.h)