Esempio di visualizzatore di documenti con archivio annotazioni XPS
Aggiornamento: novembre 2007
L'applicazione DocViewerAnnotationsXps illustra come leggere un documento XML Paper Specification (XPS) all'interno di un controllo DocumentViewer e quindi come attivare il supporto per l'aggiunta di annotazioni di testo, con input penna e con evidenziatore create dall'utente. In questo esempio le annotazioni dell'utente vengono archiviate in un file XML all'interno del documento XPS.
Nel momento in cui l'esempio viene eseguito, viene visualizzata una barra dei menu con l'opzione "File | Open". Quando si seleziona l'opzione "File | Open", viene visualizzata la finestra di dialogo "File Open" che consente all'utente di individuare e scegliere un file XpsDocument da aprire (viene fornito un file di documento XPS di esempio).
Quando il documento viene aperto, il relativo contenuto viene visualizzato nell'oggetto DocumentViewer della finestra dell'applicazione principale. All'interno del controllo DocumentViewer è possibile selezionare un blocco di testo per l'aggiunta di un'annotazione. Se si fa clic con il pulsante destro del mouse sul testo selezionato verrà visualizzato il menu di scelta rapida relativo alle annotazioni che consente all'utente di scegliere il tipo di annotazione da creare, ovvero "Highlight" (annotazione con evidenziatore),"Text Note" (annotazione di testo) o "Ink Note" (annotazione con input penna). Dopo aver selezionato il tipo di annotazione, l'evidenziatore o il form delle annotazioni viene visualizzato nel controllo DocumentViewer. È possibile aggiungere commenti personali alle annotazioni di testo o a quelle con input penna. Nell'esempio DocViewerAnnotationsXps, le annotazioni dell'utente vengono archiviate in un file XML come PackagePart all'interno del documento XPS stesso. Utilizzando questa struttura, le annotazioni dell'utente vengono mantenute insieme come parte del package del documento.
Il codice sorgente dell'esempio DocViewerAnnotationsXps è costituito da cinque file:
MyApp.xaml - RisorseExtensible Application Markup Language (XAML) per l'applicazione (nessuna inclusa in questo esempio).
MyApp.xaml.cs - File code-behind per la creazione e la visualizzazione della finestra dell'applicazione.
Window1.xaml - Dichiarazioni XAML che definiscono gli elementi della finestra dell'applicazione: menu principale, comandi di menu, controllo DocumentViewer, menu di scelta rapida delle annotazioni del controllo DocumentViewer e comandi di menu di scelta rapida.
Window1.xaml.cs - File code-behind che supporta l'interfaccia utente per i comandi del menu principale e del menu di scelta rapida.
AnnotationsHelperXps.cs - Classe per il supporto delle annotazioni dell'utente come parte di un documento XPS.
Sono disponibili anche un file di progetto e un documento XPS di esempio. Per esaminare il contenuto del documento XPS e il file XML delle annotazioni dell'utente in esso contenuto, è sufficiente modificare l'estensione del file di documento da xps in zip e quindi aprire il file con l'utilità di gestione dei file Zip.
In questo esempio viene illustrata una funzionalità specifica di Windows Presentation Foundation e non vengono pertanto seguite le procedure consigliate per lo sviluppo di applicazioni. Per una descrizione completa delle procedure consigliate per lo sviluppo di applicazioni Windows Presentation Foundation (WPF) e Microsoft .NET Framework, fare riferimento ai seguenti argomenti in base alle esigenze:
Accesso facilitato - Procedure consigliate per l'accesso facilitato
Sicurezza - Sicurezza di Windows Presentation Foundation
Localizzazione - Cenni preliminari sulla globalizzazione e localizzazione WPF
Compilazione dell'esempio
Installare Windows Software Development Kit (SDK) e aprire la finestra di comando dell'ambiente di compilazione. Fare clic sul pulsante Start, quindi scegliere Tutti i programmi, Microsoft Windows SDK, quindi fare clic su CMD Shell.
Scaricare l'esempio nel disco rigido locale, in genere dalla documentazione SDK.
Per generare l'esempio dalla finestra di comando dell'ambiente di compilazione , passare alla directory di origine dell'esempio. Al prompt dei comandi digitare MSBUILD.
Per compilare l'esempio in Microsoft Visual Studio, caricare il file della soluzione o del progetto dell'esempio e premere CTRL+MAIUSC+B.
Esecuzione dell'esempio
Per eseguire l'esempio compilato con il debug in Visual Studio, premere F5.
Per eseguire l'esempio da una finestra di comando dell'shell CMD, eseguire il file con estensione exe disponibile nella cartella di origine dell'esempio.
Vedere anche
Attività
Esempio di creazione di documenti XPS
Esempio di salvataggio di documenti XPS