Funzione di callback LPFNPSPCALLBACKA (prsht.h)

Articolo
11/20/2024

Specifica una funzione di callback definita dall'applicazione che una finestra delle proprietà chiama quando viene creata una pagina e quando sta per essere eliminata definitivamente. 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

Riservato; deve essere null.

[in] uMsg

Tipo: UINT

Flag azione. Questo parametro può essere uno dei valori seguenti.

Valore	Significato
PSPCB_ADDREF	versione 5.80 o successiva. Viene creata una pagina. Il valore restituito non viene utilizzato.
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 distrutta. Il valore restituito viene ignorato.

[in, out] ppsp

Tipo: LPPROPSHEETPAGE

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

Valore restituito

Tipo: UINT

Il valore restituito dipende dal valore del parametro uMsg.

Osservazioni

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

Nota La finestra delle proprietà è in corso 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 di 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	prsht.h

Condividi tramite