Cenni preliminari sul modello a oggetti di Visio

Articolo
02/19/2013

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.

In questo argomento viene fornita una breve panoramica del modello a oggetti di Visio.Per informazioni sull'utilizzo del modello a oggetti di Visio per eseguire attività nei progetti 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 oggetti Microsoft.Office.Interop.Visio.Document e Microsoft.Office.Interop.Visio.Page nonché le raccolte Microsoft.Office.Interop.Visio.Documents e Microsoft.Office.Interop.Visio.Pages.È possibile modificare e utilizzare ogni oggetto e raccolta mediante i numerosi metodi e le varie proprietà di cui dispone.

Per ulteriori informazioni, vedere la documentazione di riferimento di VBA sugli oggetti Microsoft.Office.Interop.Visio.Application, Microsoft.Office.Interop.Visio.Document e Microsoft.Office.Interop.Visio.Page nonché sulle raccolte Microsoft.Office.Interop.Visio.Documents e Microsoft.Office.Interop.Visio.Pages.

Nelle sezioni riportate di seguito viene fornita 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 Application

L'oggetto Microsoft.Office.Interop.Visio.Application rappresenta l'applicazione Visio e costituisce 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 degli oggetti Microsoft.Office.Interop.Visio.Application e Microsoft.Office.Interop.Visio.ApplicationSettings per controllare l'ambiente di Visio.

Nei progetti di componenti aggiuntivi a livello di applicazione è possibile accedere all'oggetto Microsoft.Office.Interop.Visio.Application utilizzando il campo Application della classe ThisAddIn.Per ulteriori informazioni, vedere Programmazione di componenti aggiuntivi a livello di applicazione.

Oggetto Document

L'oggetto Microsoft.Office.Interop.Visio.Document svolge un ruolo centrale nell'ambito della programmazione di Visio.Rappresenta un disegno, uno stencil o un file modello.Quando si apre un documento di Visio o se ne crea uno nuovo, viene creato un nuovo oggetto Microsoft.Office.Interop.Visio.Document, che viene aggiunto alla raccolta Microsoft.Office.Interop.Visio.Documents dell'oggetto Microsoft.Office.Interop.Visio.Application.

Il documento con lo stato attivo è detto documento attivo.È rappresentato dalla proprietà Microsoft.Office.Interop.Visio.Application.ActiveDocument dell'oggetto Microsoft.Office.Interop.Visio.Application.

Oggetto Page

L'oggetto Microsoft.Office.Interop.Visio.Page rappresenta l'area di disegno di una pagina di primo piano o di sfondo.Per determinare se una pagina è di primo piano o di sfondo è possibile utilizzare la proprietà Microsoft.Office.Interop.Visio.Page.Background.

Per creare forme, è possibile utilizzare metodi che includono i metodi Microsoft.Office.Interop.Visio.Page.DrawSpline e Microsoft.Office.Interop.Visio.Page.DrawOval.Tramite il metodo Microsoft.Office.Interop.Visio.Page.Drop o Microsoft.Office.Interop.Visio.Page.DropMany è inoltre possibile recuperare master dagli stencil e posizionare le forme in una pagina.

Utilizzo della documentazione sul 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.Nella documentazione di riferimento del modello a oggetti di VBA viene illustrato il modello a oggetti di Visio e come viene esposto al codice Visual Basic, Applications Edition (VBA).Per ulteriori informazioni, vedere Riferimento a 2010 del 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 del modello a oggetti di VBA corrisponde al tipo Microsoft.Office.Interop.Visio.Document nell'assembly di interoperabilità primario (PIA) di Visio.Sebbene 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# se si desidera utilizzarli in un progetto di componente aggiuntivo di Visio creato mediante 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 creare soluzioni di 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 utilizzare 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 utilizzati direttamente nel codice.

Per ulteriori informazioni, vedere i cenni preliminari su classi e interfacce negli assembly di interoperabilità primari di Office e Assembly di interoperabilità primari di Office.