PSM_CANCELTOCLOSE messaggio

Inviato da un'applicazione quando ha eseguito modifiche dopo la notifica di PSN_APPLY più recente che non può essere annullata. È possibile inviare questo messaggio in modo esplicito o usando la macro PropSheet_CancelToClose .

Parametri

wParam

Deve essere zero.

lParam

Deve essere zero.

Valore restituito

Nessun valore restituito.

Commenti

PSM_CANCELTOCLOSE disabilita il pulsante Annulla e modifica il testo del pulsante OK su "Chiudi".

La maggior parte dei fogli delle proprietà attende di eseguire modifiche irreversibili fino a quando non viene ricevuta una notifica di PSN_APPLY. Tuttavia, in alcune circostanze, un foglio delle proprietà può apportare modifiche irreversibili all'esterno della sequenza di PSN_APPLY/PSN_RESET standard. Un esempio è un foglio di proprietà che contiene un pulsante Modifica usato per visualizzare una casella di sottodialog per la modifica di una proprietà. Quando l'utente fa clic su OK per inviare la modifica, la pagina del foglio delle proprietà include diverse opzioni.

• Può registrare le modifiche, ma attendere fino a quando non riceve una notifica di PSN_APPLY per applicarle. Questo è l'approccio preferito.
• Può applicare le modifiche immediatamente dopo aver chiuso la casella di sottodialog, 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 le altre due opzioni da praticare.

Per la terza opzione, le applicazioni devono inviare un messaggio PSM_CANCELTOCLOSE al foglio delle proprietà. Indica all'utente che le modifiche apportate con la casella subdialog non possono essere invertite facendo clic sul pulsante Annulla .

Requisiti