Esempio ATLPages: implementazione di una pagina delle proprietà mediante IPropertyPageImpl
Aggiornamento: novembre 2007
Nell'esempio ATLPages viene illustrata l'implementazione di una pagina delle proprietà mediante IPropertyPageImpl.
L'esempio è costituito da:
una classe delle pagine delle proprietà, CDocumentProperties, che utilizza l'interfaccia EnvDTE::Document per visualizzare le proprietà di un documento di testo e consentirne la modifica
un componente di supporto, CHelper, che espone un wrapper semplificato per l'API OleCreatePropertyFrame ai linguaggi di script
una semplice macro di verifica, la macro Test inclusa nel progetto ATLPages.vsmacros, nella quale viene utilizzato il componente di supporto per visualizzare la pagina delle proprietà per il documento attivo nell'editor di Visual C++.
.gif "Nota sulla sicurezza") Nota sulla sicurezza: |
|---|
Questo esempio di codice viene fornito solo a scopo dimostrativo e non deve essere utilizzato in applicazioni o siti Web, poiché potrebbe non implementare le tecniche migliori a livello di sicurezza. Microsoft esclude ogni responsabilità per danni diretti o indiretti derivanti dall'utilizzo dell'esempio di codice per scopi diversi da quelli previsti. |
Per ottenere gli esempi e le istruzioni per l'installazione:
In Visual Studio scegliere Esempi dal menu ?.
Per ulteriori informazioni, vedere Individuazione dei file di esempio.
La versione più recente e l'elenco completo degli esempi sono disponibili in linea alla pagina Visual Studio 2008 Samples.
È anche possibile trovare gli esempi sul disco rigido del computer. Per impostazione predefinita, gli esempi e il file Leggimi vengono copiati in una cartella nel percorso \Programmi\Visual Studio 9.0\Samples\. Per le versioni Express di Visual Studio, tutti gli esempi sono disponibili in linea.
Generazione ed esecuzione dell'esempio
Per eseguire l'esempio è necessario generare la soluzione e quindi eseguire la macro di test.
Per generare l’esempio
Aprire il file di soluzione ATLPages7.sln.
Scegliere Genera soluzione dal menu Genera.
Per eseguire la macro
Aprire un documento di testo nell'editor. Aprire ad esempio uno dei file sorgente dell'esempio ATLPages.
Scegliere Macro dal menu Strumenti, quindi Esplora macro. Verrà aperta la finestra Esplora macro.
Scegliere Macro dal menu Strumenti, quindi Carica progetto macro. Verrà aperta la finestra di dialogo Aggiungi progetto macro.
Individuare il percorso del file ATLPages.vsmacros, che si trova nella stessa cartella dell'esempio ATLPages, quindi scegliere Apri. Con questa operazione verrà caricato il file delle macro, che verrà visualizzato in Esplora macro.
Espandere il nodo ATLPages, quindi fare doppio clic sulla macro Test.
Se quando viene eseguita la macro non è aperto alcun documento di testo, non si verifica alcun cambiamento. Se è aperto un documento, verrà visualizzata una pagina delle proprietà per tale documento in cui viene indicato il nome del file e il relativo stato in sola lettura. È possibile modificare entrambe queste impostazioni. Le modifiche verranno applicate scegliendo Applica o OK. Se viene modificato il nome del file, il file verrà salvato su disco con il nuovo nome. La modifica dello stato in sola lettura del file influisce invece sulla possibilità di apportare modifiche al file nell'editor di Visual C++, ma non sull'attributo in sola lettura del file su disco.
.gif "Nota")
Nota:Mediante questa pagina delle proprietà non può essere modificata la proprietà in sola lettura dei file inclusi nel controllo del codice sorgente.
Parole chiave
Nell'esempio vengono utilizzate le parole chiave seguenti:
IPropertyPage, IPropertyPageImpl, OleCreatePropertyFrame, IPropertyPage::SetObjects, IPropertyPage::Activate, IPropertyPage::Apply, EnvDTE