Funzione callback LPFNPSPCALLBACKA (prsht.h)

Articolo
08/25/2023

Specifica una funzione di callback definita dall'applicazione che un foglio di proprietà chiama quando viene creata una pagina e quando sta per essere distrutto. Un'applicazione può usare questa funzione per eseguire operazioni di inizializzazione e pulizia per la pagina.

Sintassi

LPFNPSPCALLBACKA Lpfnpspcallbacka;

UINT Lpfnpspcallbacka(
            HWND hwnd,
  [in]      UINT uMsg,
  [in, out] _PROPSHEETPAGEA *ppsp
)
{...}

Parametri

hwnd

Tipo: HWND

Riservati; deve essere NULL.

[in] uMsg

Tipo: UINT

Flag di azione. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
PSPCB_ADDREF	Versione 5.80 o successiva. Viene creata una pagina. Il valore restituito non viene usato.
PSPCB_CREATE	Viene creata una finestra di dialogo per una pagina. Restituisce un valore diverso da zero per consentire la creazione o zero per impedirlo.
PSPCB_RELEASE	Una pagina viene eliminata. Il valore restituito viene ignorato.

[in, out] ppsp

Tipo: LPPROPSHEETPAGE

Puntatore a una struttura PROPSHEETPAGE che definisce la pagina creata o eliminata. Per altre discussioni, vedere la sezione Osservazioni.

Valore restituito

Tipo: UINT

Il valore restituito dipende dal valore del parametro uMsg .

Commenti

Un'applicazione deve specificare l'indirizzo di questa funzione di callback nel membro pfnCallback di una struttura PROPSHEETPAGE prima di passare la struttura alla funzione CreatePropertySheetPage .

Nota Il foglio delle proprietà è in corso nel processo di modifica dell'elenco di pagine quando questa funzione viene chiamata. Non tentare di aggiungere, rimuovere o inserire pagine durante la gestione di questa notifica. In questo modo si avranno risultati imprevedibili.

Ad eccezione del membro lParam , l'applicazione non deve modificare la struttura PROPSHEETPAGE . In questo modo si avranno risultati imprevedibili. Il membro lParam contiene dati definiti dall'applicazione e può essere modificato in base alle esigenze.

Nota

L'intestazione prsht.h definisce LPFNPSPCALLBACK come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	prsht.h

Condividi tramite