Cenni preliminari sul modello a oggetti di Visio
Aggiornamento: novembre 2007
Per sviluppare soluzioni Visual Studio Tools per 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 Visual Studio Tools per 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 la classe 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 sulle classi utilizzabili nel modello a oggetti di Visio, vedere i seguenti argomenti della documentazione: La documentazione in linea di MSDN Library fornisce informazioni sul modello a oggetti di Visio nonché esempi di codice in VBA. In Visio 2007 Software Development Kit (SDK) sono forniti esempi di codice in Visual Basic e C# (informazioni in lingua inglese). In Visio 2007 SDK sono inoltre forniti strumenti di pubblicazione e modelli di Visual Studio.
Microsoft Office Visio 2007
Microsoft Office Visio 2003
Modello a oggetti di Visio [documentazione di Visio 2003 SDK]
Riferimento allo schema XML di Microsoft Office Visio 2003 [documentazione di Visio 2003 SDK]
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°Overview of Classes and Interfaces in the Office Primary Interop Assemblies e Assembly di interoperabilità primari di Office.
.gif "Nota") Nota: |
|---|
Attualmente non è prevista la documentazione di riferimento per gli assembly di interoperabilità primari di Visio. |
Riferimento a VBA
Tutti gli oggetti e i membri nel riferimento a VBA corrispondono a classi e membri nell'assembly di interoperabilità primario utilizzato nei progetti Visual Studio Tools per Office. Ad esempio, l'oggetto Visio.Application nella documentazione di VBA per Visio corrisponde alla classe Microsoft.Office.Interop.Visio.Application nell'assembly di interoperabilità primario.
Il riferimento a VBA presenta i vantaggi seguenti:
Documenta i modelli a oggetti di Visio 2007 e Visio 2003.
Fornisce esempi di codice per la maggior parte dei membri.
Il riferimento a VBA presenta gli svantaggi seguenti:
- Fornisce sintassi ed esempi di codice unicamente per VBA. Per utilizzare gli esempi di codice in un progetto Visual Studio Tools per Office, è necessario convertire il codice VBA in Visual Basic o Visual C#.