Cenni preliminari sul modello a oggetti di Visio

Articolo
08/11/2011

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é gli insiemi Microsoft.Office.Interop.Visio.Documents e Microsoft.Office.Interop.Visio.Pages. Ognuno di questi oggetti può essere modificato e utilizzato 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é sugli insiemi 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 Application
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 all'insieme 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). La documentazione di riferimento del modello a oggetti di VBA per Visio è disponibile nei percorsi seguenti:

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 la creazione di soluzioni di Visio, vedere i seguenti download:

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.