Classe CSnapInPropertyPageImpl
Questa classe fornisce metodi per l'implementazione di un oggetto pagina delle proprietà snap-in.
Importante
Questa classe e i relativi membri non possono essere usati nelle applicazioni eseguite in Windows Runtime.
Sintassi
CSnapInPropertyPageImpl : public CDialogImplBase
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| CSnapInPropertyPageImpl::CSnapInPropertyPageImpl | Costruttore. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CSnapInPropertyPageImpl::CancelToClose | Modifica lo stato dei pulsanti OK e Annulla . |
| CSnapInPropertyPageImpl::Create | Inizializza un oggetto appena creato CSnapInPropertyPageImpl . |
| CSnapInPropertyPageImpl::OnApply | Chiamato dal framework quando l'utente fa clic sul pulsante Applica ora durante l'uso di una finestra delle proprietà di tipo procedura guidata. |
| CSnapInPropertyPageImpl::OnHelp | Chiamato dal framework quando l'utente fa clic sul pulsante ? durante l'uso di una finestra delle proprietà di tipo procedura guidata. |
| CSnapInPropertyPageImpl::OnKillActive | Chiamato dal framework quando la pagina corrente non è più attiva. |
| CSnapInPropertyPageImpl::OnQueryCancel | Chiamato dal framework quando l'utente fa clic sul pulsante Annulla e prima che venga eseguito l'annullamento. |
| CSnapInPropertyPageImpl::OnReset | Chiamato dal framework quando l'utente fa clic sul pulsante Reimposta durante l'uso di una finestra delle proprietà di tipo procedura guidata. |
| CSnapInPropertyPageImpl::OnSetActive | Chiamato dal framework quando la pagina corrente diventa attiva. |
| CSnapInPropertyPageImpl::OnWizardBack | Chiamato dal framework quando l'utente fa clic sul pulsante Indietro durante l'uso di una finestra delle proprietà di tipo procedura guidata. |
| CSnapInPropertyPageImpl::OnWizardFinish | Chiamato dal framework quando l'utente fa clic sul pulsante Fine durante l'uso di una finestra delle proprietà di tipo procedura guidata. |
| CSnapInPropertyPageImpl::OnWizardNext | Chiamato dal framework quando l'utente fa clic sul pulsante Avanti durante l'uso di una finestra delle proprietà di tipo procedura guidata. |
| CSnapInPropertyPageImpl::QuerySiblings | Inoltra il messaggio corrente a tutte le pagine della finestra delle proprietà. |
| CSnapInPropertyPageImpl::SetModified | Chiamare per attivare o disattivare il pulsante Applica ora . |
Membri dati pubblici
| Nome | Descrizione |
|---|---|
| CSnapInPropertyPageImpl::m_psp | Struttura di Windows PROPSHEETPAGE utilizzata dall'oggetto CSnapInPropertyPageImpl . |
Osservazioni:
CSnapInPropertyPageImpl fornisce un'implementazione di base per un oggetto pagina delle proprietà snap-in. Le funzionalità di base di una pagina delle proprietà snap-in vengono implementate usando diverse interfacce e tipi di mappa.
Gerarchia di ereditarietà
CDialogImplBase
CSnapInPropertyPageImpl
Requisiti
Intestazione: atlsnap.h
CSnapInPropertyPageImpl::CancelToClose
Chiamare questa funzione dopo che è stata apportata una modifica irreversibile ai dati in una pagina di una finestra delle proprietà modale.
void CancelToClose();
Osservazioni:
Questa funzione modificherà il pulsante OK in Chiudi e disabiliterà il pulsante Annulla . Questa modifica avvisa l'utente che una modifica è permanente e le modifiche non possono essere annullate.
La CancelToClose funzione membro non esegue alcuna operazione in una finestra delle proprietà senza modalità, perché per impostazione predefinita una finestra delle proprietà senza modalità non dispone di un pulsante Annulla .
CSnapInPropertyPageImpl::CSnapInPropertyPageImpl
Costruisce un oggetto CSnapInPropertyPageImpl.
CSnapInPropertyPageImpl(LPCTSTR lpszTitle = NULL);
Parametri
lpszTitle
[in] Titolo della pagina delle proprietà.
Osservazioni:
Per inizializzare la struttura sottostante, chiamare CSnapInPropertyPageImpl::Create.
CSnapInPropertyPageImpl::Create
Chiamare questa funzione per inizializzare la struttura sottostante della pagina delle proprietà.
HPROPSHEETPAGE Create();
Valore restituito
Handle di una PROPSHEETPAGE struttura contenente gli attributi della finestra delle proprietà appena creata.
Osservazioni:
Prima di chiamare questa funzione, è necessario chiamare CSnapInPropertyPageImpl::CSnapInPropertyPageImpl .
CSnapInPropertyPageImpl::m_psp
m_psp è una struttura i cui membri archiviano le caratteristiche di PROPSHEETPAGE.
PROPSHEETPAGE m_psp;
Osservazioni:
Utilizzare questa struttura per inizializzare l'aspetto di una pagina delle proprietà dopo la sua costruzione.
Per altre informazioni su questa struttura, incluso un elenco dei relativi membri, vedere PROPSHEETPAGE in Windows SDK.
CSnapInPropertyPageImpl::OnApply
Questa funzione membro viene chiamata quando l'utente fa clic su OK o sul pulsante Applica ora.
BOOL OnApply();
Valore restituito
Diverso da zero se le modifiche vengono accettate; in caso contrario, 0.
Osservazioni:
Prima di OnApply poter essere chiamato dal framework, è necessario chiamare SetModified e impostarne il parametro su TRUE. Verrà attivato il pulsante Applica ora non appena l'utente apporta una modifica nella pagina delle proprietà.
Eseguire l'override di questa funzione membro per specificare l'azione eseguita dal programma quando l'utente fa clic sul pulsante Applica ora . Quando si esegue l'override, la funzione deve restituire TRUE per accettare le modifiche e FALSE per impedire che le modifiche vengano applicate.
L'implementazione predefinita di OnApply restituisce TRUE.
CSnapInPropertyPageImpl::OnHelp
Questa funzione membro viene chiamata quando l'utente fa clic sul pulsante ? per la pagina delle proprietà.
void OnHelp();
Osservazioni:
Eseguire l'override di questa funzione membro per visualizzare la Guida per la pagina delle proprietà.
CSnapInPropertyPageImpl::OnKillActive
Questa funzione membro viene chiamata quando la pagina non è più la pagina attiva.
BOOL OnKillActive();
Valore restituito
Diverso da zero se i dati sono stati aggiornati correttamente; in caso contrario, 0.
Osservazioni:
Eseguire l'override di questa funzione membro per eseguire attività speciali di convalida dei dati.
CSnapInPropertyPageImpl::OnQueryCancel
Questa funzione membro viene chiamata quando l'utente fa clic sul pulsante Annulla e prima dell'esecuzione dell'azione di annullamento.
BOOL OnQueryCancel();
Valore restituito
Diverso da zero per consentire l'operazione di annullamento; in caso contrario, 0.
Osservazioni:
Eseguire l'override di questa funzione membro per specificare un'azione eseguita dal programma quando l'utente fa clic sul pulsante Annulla .
L'implementazione predefinita di OnQueryCancel restituisce TRUE.
CSnapInPropertyPageImpl::OnReset
Questa funzione membro viene chiamata quando l'utente fa clic sul pulsante Annulla .
void OnReset();
Osservazioni:
Quando questa funzione viene chiamata, le modifiche apportate a tutte le pagine delle proprietà apportate dall'utente in precedenza facendo clic sul pulsante Applica ora vengono rimosse e la finestra delle proprietà mantiene lo stato attivo.
Eseguire l'override di questa funzione membro per specificare l'azione eseguita dal programma quando l'utente fa clic sul pulsante Annulla .
CSnapInPropertyPageImpl::OnSetActive
Questa funzione membro viene chiamata quando la pagina viene scelta dall'utente e diventa la pagina attiva.
BOOL OnSetActive();
Valore restituito
Diverso da zero se la pagina è stata impostata correttamente; in caso contrario, 0.
Osservazioni:
Eseguire l'override di questa funzione membro per eseguire attività quando viene attivata una pagina. L'override di questa funzione membro deve chiamare la versione predefinita prima di eseguire qualsiasi altra elaborazione.
L'implementazione predefinita restituisce TRUE.
CSnapInPropertyPageImpl::OnWizardBack
Questa funzione membro viene chiamata quando l'utente fa clic sul pulsante Indietro in una procedura guidata.
BOOL OnWizardBack();
Valore restituito
Da 0 per passare automaticamente alla pagina precedente.
-1 per impedire la modifica della pagina.
Per passare a una pagina diversa da quella successiva, restituire l'identificatore della finestra di dialogo da visualizzare.
Osservazioni:
Eseguire l'override di questa funzione membro per specificare un'azione che l'utente deve eseguire quando si fa clic sul pulsante Indietro .
CSnapInPropertyPageImpl::OnWizardFinish
Questa funzione membro viene chiamata quando l'utente fa clic sul pulsante Fine in una procedura guidata.
BOOL OnWizardFinish();
Valore restituito
Diverso da zero se la finestra delle proprietà viene eliminata definitivamente al termine della procedura guidata; in caso contrario, zero.
Osservazioni:
Eseguire l'override di questa funzione membro per specificare un'azione che l'utente deve eseguire quando si fa clic sul pulsante Fine .
CSnapInPropertyPageImpl::OnWizardNext
Questa funzione membro viene chiamata quando l'utente fa clic sul pulsante Avanti in una procedura guidata.
BOOL OnWizardNext();
Valore restituito
0 per passare automaticamente alla pagina successiva.
-1 per impedire la modifica della pagina.
Per passare a una pagina diversa da quella successiva, restituire l'identificatore della finestra di dialogo da visualizzare.
Osservazioni:
Eseguire l'override di questa funzione membro per specificare un'azione che l'utente deve eseguire quando si fa clic sul pulsante Avanti .
CSnapInPropertyPageImpl::QuerySiblings
Chiamare questa funzione membro per inoltrare un messaggio a ogni pagina nella finestra delle proprietà.
LRESULT QuerySiblings(WPARAM wParam, LPARAM lParam);
Parametri
wParam
[in] Specifica informazioni aggiuntive dipendenti dai messaggi.
lParam
[in] Specifica informazioni aggiuntive dipendenti dai messaggi.
Valore restituito
Diverso da zero se il messaggio non deve essere inoltrato alla pagina delle proprietà successiva; in caso contrario, zero.
Osservazioni:
Se una pagina restituisce un valore diverso da zero, la finestra delle proprietà non invia il messaggio alle pagine successive.
CSnapInPropertyPageImpl::SetModified
Chiamare questa funzione membro per abilitare o disabilitare il pulsante Applica ora , in base al fatto che le impostazioni nella pagina delle proprietà debbano essere applicate all'oggetto esterno appropriato.
void SetModified(BOOL bChanged = TRUE);
Parametri
bChanged
[in] TRUE per indicare che le impostazioni della pagina delle proprietà sono state modificate dopo l'ultima applicazione; FALSE per indicare che le impostazioni della pagina delle proprietà sono state applicate o devono essere ignorate.
Osservazioni:
La finestra delle proprietà tiene traccia delle pagine "dirty", ovvero le pagine delle proprietà per le quali è stato chiamato SetModified( TRUE ). Il pulsante Applica ora verrà sempre abilitato se si chiama SetModified( TRUE ) per una delle pagine. Il pulsante Applica ora verrà disabilitato quando chiami SetModified( FALSE ) una delle pagine, ma solo se nessuna delle altre pagine è "dirty".