Classe CPropertySheet

Articolo
06/10/2015

Rappresenta le finestre delle proprietà, note anche come le finestre di dialogo della scheda.

class CPropertySheet : public CWnd

Membri

Costruttori pubblici

Nome	Descrizione
CPropertySheet::CPropertySheet	Costruisce un oggetto CPropertySheet.

Metodi pubblici

Nome	Descrizione
CPropertySheet::AddPage	Aggiunge una pagina nella finestra delle proprietà.
CPropertySheet::Construct	Costruisce un oggetto CPropertySheet.
CPropertySheet::Create	Visualizza una finestra delle proprietà non modale.
CPropertySheet::DoModal	Visualizza una finestra delle proprietà modale.
CPropertySheet::EnableStackedTabs	Indica se utilizza la finestra delle proprietà in o tabulazioni di scorrimento.
CPropertySheet::EndDialog	Termina la finestra delle proprietà.
CPropertySheet::GetActiveIndex	Recupera l'indice della pagina attiva la finestra proprietà.
CPropertySheet::GetActivePage	Restituisce l'oggetto della pagina attiva.
CPropertySheet::GetPage	Recupera un puntatore alla pagina specificata.
CPropertySheet::GetPageCount	Recupera il numero di pagine nella finestra delle proprietà.
CPropertySheet::GetPageIndex	Recupera l'indice della pagina specificata la finestra proprietà.
CPropertySheet::GetTabControl	Recupera un puntatore a un controllo tab.
CPropertySheet::MapDialogRect	Converte le unità della finestra di dialogo del rettangolo in schermare unità.
CPropertySheet::OnInitDialog	Override per aumentare inizializzazione della finestra delle proprietà.
CPropertySheet::PressButton	Simula la scelta del pulsante specificato in una finestra delle proprietà.
CPropertySheet::RemovePage	Rimuove una pagina della finestra delle proprietà.
CPropertySheet::SetActivePage	Imposta a livello di codice l'oggetto della pagina attiva.
CPropertySheet::SetFinishText	Imposta il testo del pulsante fine.
CPropertySheet::SetTitle	Imposta la barra del titolo della finestra delle proprietà.
CPropertySheet::SetWizardButtons	Abilita i pulsanti della procedura guidata.
CPropertySheet::SetWizardMode	Attiva la modalità guidata.

Membri dati pubblici

Nome	Descrizione
CPropertySheet::m_psh	La struttura di Windows PROPSHEETHEADER. Fornisce l'accesso ai parametri di base della finestra delle proprietà.

Note

Una finestra delle proprietà è costituito da un oggetto CPropertySheet e uno o più oggetti CPropertyPage. Il framework viene visualizzata una finestra delle proprietà come finestra con un set di indici della scheda e di area contenente la pagina selezionata. L'utente passa a una pagina specifica utilizzando la scheda appropriata.

CPropertySheet fornisce il supporto per la struttura espansa PROPSHEETHEADER introdotta in Windows 98 e Windows NT 2000. La struttura contiene i flag aggiuntivi e i membri che supportano l'utilizzo di una bitmap di sfondo di "filigrana".

Per visualizzare queste nuove immagini automaticamente nell'oggetto finestra delle proprietà, passare i valori validi per le immagini della tavolozza e della bitmap nella chiamata a CPropertySheet::Construct o a CPropertySheet::CPropertySheet.

Anche se CPropertySheet non deriva da CDialog, gestire un oggetto CPropertySheet viene illustrato come gestire un oggetto CDialog. Ad esempio, la creazione di una finestra delle proprietà richiede la costruzione in due parti: chiamare il costruttore e quindi chiamare DoModal per una finestra delle proprietà modale o Crea per una finestra delle proprietà non modale. CPropertySheet ha due tipi di costruttori: CPropertySheet::Construct e CPropertySheet::CPropertySheet.

Quando si costruisce un oggetto CPropertySheet, il Stili finestra può causare un'eccezione first-chance di verificare. Ciò deriva dal sistema che tenta di modificare lo stile della finestra delle proprietà prima che il foglio venga creato. Per evitare questa eccezione, assicurarsi di impostare gli stili quando si crea il CPropertySheet:

DS_3DLOOK
DS_CONTROL
WS_CHILD
WS_TABSTOP

Gli stili sono facoltativi e non comporta il eccezioni first-chance:

DS_SHELLFONT
DS_LOCALEDIT
WS_CLIPCHILDREN

Qualsiasi altro Window Styles è vietato e non è necessario attivarlo.

I scambiano dati tra un oggetto CPropertySheet e un oggetto esterno sono simili per scambiare dati a un oggetto CDialog. La differenza importante è che le impostazioni di una finestra delle proprietà sono in genere variabili membro degli oggetti CPropertyPage anziché dell'oggetto CPropertySheet.

È possibile creare un tipo di finestra di dialogo della scheda chiamato una procedura guidata, costituito da una finestra delle proprietà a una sequenza di pagine delle proprietà che guidano l'utente nei passaggi di un'operazione, come l'impostazione del dispositivo o creare un informazioni. In una finestra di dialogo della scheda della procedura guidata- tipo, pagine delle proprietà non sono schede e una sola pagina delle proprietà è visibile per volta. Inoltre, anziché essere OK e pulsanti Applica ora, una finestra di dialogo della scheda della procedura guidata- tipo dispone di un pulsante Indietro, un pulsante Fine o Avanti, un pulsante Annulla e un pulsante Guida.

Per creare una finestra di dialogo procedura guidata- tipo, seguire la stessa procedura utilizzata a per creare una finestra delle proprietà standard, ma la chiamata SetWizardMode prima di chiamare DoModal. Per abilitare i pulsanti della procedura guidata, chiamare SetWizardButtons, utilizzando i flag per personalizzare la funzione e l'aspetto. Per attivare il pulsante Fine, chiamata SetFinishText dopo che l'utente ha intrapreso un'azione in relazione all'ultima pagina della procedura guidata.

Per ulteriori informazioni su come utilizzare gli oggetti CPropertySheet, vedere l'articolo Finestre e le pagine delle proprietà. Inoltre, vedere l'articolo della Knowledge Base Q146916: HOWTO: Creare un CPropertySheet non modale con pulsanti e l'articolo standard Q300606: HOWTO: Progetti una finestra delle proprietà ridimensionabile MFC.