Implementare le pagine delle proprietà

Le pagine delle proprietà sono oggetti COM che implementano IPropertyPage o un'interfaccia IPropertyPage2.ATL fornisce il supporto per implementare le pagine delle proprietà con Procedura guidata della pagina delle proprietà ATL in Aggiungere la finestra di dialogo della classe.

Per creare una pagina delle proprietà utilizzando ATL:

  • Creare o aprire un progetto server (DLL) la libreria a collegamento dinamico ATL.

  • Aprire Aggiungere la finestra di dialogo della classe e selezionare Pagina delle proprietà ATL.

  • Assicurarsi che la pagina delle proprietà sia apartment multithreading (poiché prevede un'interfaccia utente).

  • Impostare il titolo, la descrizione (stringa doc) e il file della Guida da associare alla pagina.

  • Aggiungere i controlli alla risorsa finestra di dialogo generata per fungere da interfaccia utente della pagina delle proprietà.

  • Rispondere alle modifiche nell'interfaccia utente della pagina per eseguire la convalida, aggiornare il sito della pagina, o per aggiornare gli oggetti associati alla pagina.In particolare, chiamata IPropertyPageImpl::SetDirty quando l'utente apporta modifiche alla pagina delle proprietà.

  • Facoltativamente eseguire l'override dei metodi IPropertyPageImpl utilizzando le linee guida riportate di seguito.

    Metodo di IPropertyPageImpl

    Override quando…

    Note

    SetObjects

    Eseguire controlli di base del settore sanitario di base per il numero di oggetti passati alla pagina e le interfacce che supportano.

    Eseguire il codice prima di chiamare l'implementazione della classe base.Se gli oggetti impostati conformi alle aspettative, è necessario avere esito negativo la chiamata il prima possibile.

    Attiva

    Inizializzare l'interfaccia utente della pagina (ad esempio, impostare i controlli della finestra di dialogo con i valori delle proprietà correnti dagli oggetti, creare i controlli dinamicamente, o eseguire altre inizializzazioni).

    Chiamare l'implementazione della classe base prima del codice in modo dalla classe base ha la possibilità di creare la finestra di dialogo e tutti i controlli prima di tentare di aggiornarli.

    Apply

    Convalidare le impostazioni delle proprietà e aggiornare gli oggetti.

    Non è necessario chiamare l'implementazione della classe base poiché non si limita oltre all'analisi la chiamata.

    Disattivare

    Pulisce gli elementi relativi alle finestre.

    L'implementazione della classe base elimina la finestra di dialogo che rappresenta la pagina delle proprietà.Per pulire prima che la finestra di dialogo venga eliminato, è necessario aggiungere il codice prima di chiamare la classe base.

Per un esempio di implementazione della pagina delle proprietà, vedere esempio: Implementare una pagina delle proprietà.

[!NOTA]

Se si desidera ospitare controlli ActiveX nella pagina delle proprietà, sarà necessario modificare la derivazione della classe generata mediante procedura guidata.CDialogImpl<CYourClass> di sostituzione con CAxDialogImpl<CYourClass> nell'elenco di classi base.

Vedere anche

Concetti

Pagine delle proprietà COM ATL

Esempio ATLPages