Funzione PropertySheetA (prsht.h)

Articolo
03/05/2024

Crea una finestra delle proprietà e aggiunge le pagine definite nella struttura di intestazione della finestra delle proprietà specificata.

Sintassi

INT_PTR PropertySheetA(
  LPCPROPSHEETHEADERA unnamedParam1
);

Parametri

unnamedParam1

Tipo: LPCPROPSHEETHEADER

Puntatore a una struttura PROPSHEETHEADER che definisce la cornice e le pagine di una finestra delle proprietà.

Valore restituito

Tipo: INT_PTR

Per le finestre delle proprietà modali, il valore restituito è il seguente:

>=1	Le modifiche sono state salvate dall'utente.
0	Nessuna modifica salvata dall'utente.
-1	Si è verificato un errore.

Per le finestre delle proprietà non modale, il valore restituito è l'handle di finestra della finestra della finestra delle proprietà.

I valori restituiti seguenti hanno un significato speciale.

Codice restituito	Descrizione
ID_PSREBOOTSYSTEM	Una pagina ha inviato il messaggio PSM_REBOOTSYSTEM alla finestra delle proprietà. Per rendere effettive le modifiche dell'utente, è necessario riavviare il computer.
ID_PSRESTARTWINDOWS	Una pagina ha inviato il messaggio PSM_RESTARTWINDOWS alla finestra delle proprietà. Per rendere effettive le modifiche dell'utente, è necessario riavviare Windows.

Commenti

Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Se si tenta di aggiungere più di 99 pagine a una finestra delle proprietà, questa funzione avrà esito negativo, ma senza alcuna indicazione della causa dell'errore: PropertySheet restituisce il valore -1, ma GetLastError restituisce 0.

Nota Le note seguenti fanno riferimento solo alle procedure guidate che non utilizzano lo stile della procedura guidata Aero (PSH_AEROWIZARD) o le finestre delle proprietà non guidate.

Per impostazione predefinita, la funzione PropertySheet crea una finestra di dialogo modale. Se il membro dwFlags della struttura PROPSHEETHEADER specifica il flag PSH_MODELESS, PropertySheet crea una finestra di dialogo senza modalità e restituisce immediatamente dopo la creazione. In questo caso, il valore restituito di PropertySheet è l'handle di finestra per la finestra di dialogo senza modalità.

Per una finestra delle proprietà senza modalità, il ciclo di messaggi deve usare PSM_ISDIALOGMESSAGE per passare messaggi alla finestra di dialogo della finestra delle proprietà. Il ciclo di messaggi deve usare PSM_GETCURRENTPAGEHWND per determinare quando eliminare definitivamente la finestra di dialogo. Quando l'utente fa clic sul pulsante OK o Annulla , PSM_GETCURRENTPAGEHWND restituisce NULL. È quindi possibile usare la funzione DestroyWindow per eliminare definitivamente la finestra di dialogo.

Versione 5.80. Il valore restituito di PropertySheet contiene informazioni diverse per le finestre delle proprietà modali e non modali. In alcuni casi, le finestre delle proprietà senza modalità potrebbero richiedere le informazioni ricevute da PropertySheet se fossero state modali. In particolare, potrebbe essere necessario sapere se ID_PSREBOOTSYSTEM o ID_PSRESTARTWINDOWS sarebbe stato restituito. Una finestra delle proprietà non modale può recuperare il valore che una finestra delle proprietà modale avrebbe ricevuto da PropertySheet attendendo che PSM_GETCURRENTPAGEHWND restituisca NULL e quindi invii un messaggio di PSM_GETRESULT .

Nota

L'intestazione prsht.h definisce PropertySheet 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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
Libreria	Comctl32.lib
DLL	Comctl32.dll
Set di API	ext-ms-win-shell-comctl32-window-l1-1-0 (introdotto in Windows 10, versione 10.0.14393)

Condividi tramite