macro PropSheet_CancelToClose (prsht.h)

  • Articolo

Utilizzato quando le modifiche apportate dal momento che la notifica di PSN_APPLY più recente non può essere annullata. È anche possibile inviare un messaggio di PSM_CANCELTOCLOSE in modo esplicito.

Sintassi

VOID PropSheet_CancelToClose(
   HWND hDlg
);

Parametri

hDlg

Tipo: HWND

Handle nella finestra delle proprietà.

Valore restituito

Tipo: VOID

Nessun valore restituito.

Osservazioni

PSM_CANCELTOCLOSE disabilita il pulsante annulla e modifica il testo del pulsante OK su "Chiudi". È possibile utilizzare questa macro o inviare il messaggio di PSM_CANCELTOCLOSE in modo esplicito.

La maggior parte delle finestre delle proprietà attende di eseguire modifiche irreversibili fino a quando non viene ricevuta una notifica di PSN_APPLY. In alcune circostanze, tuttavia, una finestra delle proprietà può apportare modifiche irreversibili al di fuori della sequenza standard PSN_APPLY/PSN_RESET. Un esempio è una finestra delle proprietà che contiene un pulsante Modifica utilizzato per visualizzare una casella di sottodialoga per la modifica di una proprietà. Quando l'utente fa clic OK per inviare la modifica, la pagina della finestra delle proprietà include diverse opzioni:

  • Può registrare le modifiche, ma attendere che riceva una notifica di PSN_APPLY per applicarle. Questo è l'approccio preferito.
  • Può applicare le modifiche immediatamente dopo l'uscita dalla casella di sottodialoga, ma ricordare le impostazioni originali. Queste impostazioni possono essere usate per ripristinare lo stato originale se viene ricevuta una notifica di PSN_RESET.
  • Può applicare immediatamente le modifiche e non tentare di ripristinare le impostazioni originali quando riceve una notifica di PSN_RESET. Questo approccio non è consigliato, ma potrebbe essere necessario se le modifiche sono troppo lontane per rendere pratiche le altre due opzioni.
Per la terza opzione, le applicazioni devono inviare un messaggio PSM_CANCELTOCLOSE alla finestra delle proprietà. Indica all'utente che le modifiche apportate con la casella di sottodialogo non possono essere annullate facendo clic sul pulsante Annulla .
Nota Questa macro non è supportata quando si utilizza lo stile della procedura guidata Aero (PSH_AEROWIZARD).
 

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