Panoramica del modello a oggetti di Visio
Per sviluppare soluzioni Office per Microsoft Office Visio è possibile interagire con il modello a oggetti di Visio. Questo modello a oggetti è costituito da classi e interfacce fornite nell'assembly di interoperabilità primario per Visio ed è definito nello spazio dei nomi Microsoft.Office.Interop.Visio.
Questo argomento contiene una breve panoramica del modello a oggetti di Visio. Per informazioni sull'uso del modello a oggetti di Visio per eseguire attività nei progetti di Office, vedere gli argomenti seguenti:
Informazioni sul modello a oggetti di Visio
In Visio sono disponibili numerosi oggetti con cui è possibile interagire. Questi oggetti sono organizzati in una gerarchia che corrisponde strettamente all'interfaccia utente. Il vertice della gerarchia è occupato dall'oggetto Microsoft.Office.Interop.Visio.Application . Questo oggetto rappresenta l'istanza corrente di Visio. L'oggetto Microsoft.Office.Interop.Visio.Application contiene gli Microsoft.Office.Interop.Visio.Document oggetti e Microsoft.Office.Interop.Visio.Page nonché gli Microsoft.Office.Interop.Visio.Documents insiemi e Microsoft.Office.Interop.Visio.Pages . È possibile modificare e usare ogni oggetto e raccolta con i numerosi metodi e le varie proprietà di cui dispone.
Per altre informazioni, vedere la documentazione di riferimento di VBA sugli oggetti Microsoft.Office.Interop.Visio.Application, Microsoft.Office.Interop.Visio.Documente Microsoft.Office.Interop.Visio.Page nonché sulle raccolte Microsoft.Office.Interop.Visio.Documents e Microsoft.Office.Interop.Visio.Pages .
Le sezioni riportate di seguito forniscono una breve descrizione degli oggetti di livello superiore e della loro reciproca interazione. Tali oggetti comprendono quelli elencati di seguito:
Oggetto applicazione
Oggetto Document
Oggetto Page
Oggetto applicazione
L'oggetto Microsoft.Office.Interop.Visio.Application rappresenta l'applicazione Visio ed è l'elemento padre di tutti gli altri oggetti. I membri di tale oggetto in genere vengono applicati a Visio nel suo complesso. È possibile utilizzare le proprietà e i metodi di Microsoft.Office.Interop.Visio.Application e gli Microsoft.Office.Interop.Visio.ApplicationSettings oggetti per controllare l'ambiente di Visio.
Nei progetti di componente aggiuntivo VSTO è possibile accedere all'oggetto Microsoft.Office.Interop.Visio.Application utilizzando il Application campo della ThisAddIn classe . Per altre informazioni, vedere Programming VSTO Add-Ins.
Oggetto Document
L'oggetto Microsoft.Office.Interop.Visio.Document è fondamentale per la programmazione di Visio. Rappresenta un disegno, uno stencil o un file modello. Quando si apre un documento di Visio o si crea un nuovo documento, viene creato un nuovo oggetto Microsoft.Office.Interop.Visio.Document, che viene aggiunto all'insieme Microsoft.Office.Interop.Visio.Documents dell'oggetto Microsoft.Office.Interop.Visio.Application.
Il documento con lo stato attivo è definito documento attivo. È rappresentato dalla Microsoft.Office.Interop.Visio.Application.ActiveDocument proprietà dell'oggetto Microsoft.Office.Interop.Visio.Application.
Oggetto Page
L'oggetto Microsoft.Office.Interop.Visio.Page rappresenta l'area di disegno di una pagina in primo piano o di una pagina di sfondo. Per determinare se una pagina è di primo piano o di sfondo è possibile usare la proprietà Microsoft.Office.Interop.Visio.Page.Background.
Per creare forme, è possibile usare metodi che includono i metodi Microsoft.Office.Interop.Visio.Page.DrawSpline e Microsoft.Office.Interop.Visio.Page.DrawOval. Con il metodo Microsoft.Office.Interop.Visio.Page.Drop o Microsoft.Office.Interop.Visio.Page.DropMany è anche possibile recuperare master dagli stencil e posizionare le forme in una pagina.
Usare la documentazione del modello a oggetti di Visio
Per informazioni complete sul modello a oggetti di Visio, vedere la documentazione di riferimento del modello a oggetti di VBA. Nel riferimento del modello a oggetti VBA è illustrato il modello a oggetti di Visio esposto al codice Visual Basic Applications (VBA). Per altre informazioni, vedere Informazioni di riferimento sul modello a oggetti di Visio.
Tutti gli oggetti e i membri nel riferimento del modello a oggetti di VBA corrispondono a tipi e membri nell'assembly di interoperabilità primario (PIA) di Visio. Ad esempio, l'oggetto Document nel riferimento al modello a oggetti VBA corrisponde al tipo Microsoft.Office.Interop.Visio.Document nell'elenco di interoperabilità primario di Visio. Nonostante il riferimento del modello a oggetti di VBA fornisca esempi di codice per la maggior parte delle proprietà, dei metodi e degli eventi, è necessario convertire il codice VBA in questo riferimento a Visual Basic o a Visual C# per usarli in un progetto di componente aggiuntivo VSTO di Visio creato con Visual Studio.
Nota
Attualmente non è prevista la documentazione di riferimento per l'assembly di interoperabilità primario di Visio.
Per esempi di codice correlati e strumenti aggiuntivi per la creazione di soluzioni Visio, vedere Visio 2010 Software Development Kit.
Tipi aggiuntivi negli assembly di interoperabilità primari
È possibile cercare negli assembly di interoperabilità primari tipi che non sono visibili a VBA a causa delle differenze di implementazione. VBA offre una visualizzazione del modello a oggetti di Visio che include solo gli oggetti e i membri che è possibile usare direttamente. Gli assembly di interoperabilità primari espongono lo stesso modello a oggetti, ma includono anche le altre interfacce, classi e membri che traducono gli oggetti del modello a oggetti COM nel codice gestito. Questi elementi aggiuntivi non devono essere usati direttamente nel codice.
Per altre informazioni, vedere Panoramica delle classi e delle interfacce negli assembly di interoperabilità primari di Office e negli assembly di interoperabilità primari di Office.