Come utilizzare l'automazione OLE in Visio

Traduzione articoli Traduzione articoli
Identificativo articolo: 309603 - Visualizza i prodotti a cui si riferisce l?articolo.
Espandi tutto | Chiudi tutto

In questa pagina

INTRODUZIONE

In questo articolo informazioni su come utilizzare Microsoft Visual Basic o Microsoft Visual Basic, Applications Edition (VBA) per automatizzare Microsoft Office Visio2from un altro programma di Microsoft Office.

Microsoft fornisce esempi di programmazione a scopo puramente illustrativo, senza alcuna garanzia espressa o implicita. Questo include, ma non Ŕ limitato a, le garanzie implicite di commerciabilitÓ o idoneitÓ per uno scopo specifico. Questo articolo si presuppone che conosca il linguaggio di programmazione in questione e gli strumenti utilizzati per creare ed eseguire il debug di procedure. Tecnici del supporto Microsoft possono spiegare la funzionalitÓ di una particolare procedura, ma in nessun sono caso a modificare questi esempi per fornire funzionalitÓ aggiuntive o creare procedure per soddisfare specifiche esigenze.

Cenni preliminari su automazione

L'automazione (detto anche automazione OLE ) in Visual Basic Ŕ il processo di controllo di un programma da un altro programma o strumento di sviluppo esterno. ╚ possibile automatizzare qualsiasi programma che contiene un modello a oggetti di Visual Basic. Un modello a oggetti Ŕ un insieme gerarchico di oggetti disponibili del programma o di esposte a finestra di Visual Basic.

Ad esempio, il modello a oggetti per Microsoft Visio contiene oggetti, ad esempio:
  • Oggetto applicazione globale
  • Oggetto documento
  • Oggetto Page
  • Oggetto master
  • Oggetto Selection
  • Oggetto Shape
  • Oggetto Window
Ciascuno di questi oggetti dispone di un insieme univoco di metodi e proprietÓ che Ŕ necessaria utilizzarli in Visual Basic. Ad esempio, un oggetto Shape pu˛ rappresentare qualsiasi oggetto di una pagina di disegno di Visio che Ŕ possibile selezionare utilizzando il puntatore. Di conseguenza, un oggetto Shape pu˛ essere una forma, un gruppo, una Guida, un controllo, oppure un oggetto da un altro programma Ŕ collegato, incorporati o importati in un disegno di Visio.

Guida introduttiva

Gli esempi di codice di questo articolo viene illustrato come controllare Visio da Microsoft Office 2007, Microsoft Office 2003, Microsoft Office 2002, Microsoft Visual Basic 6.0, o da qualsiasi programma che include uno strumento di sviluppo Visual Basic. Per automatizzare Visio, attenersi alla seguente procedura principale quattro:
  1. Aggiungere un riferimento alla libreria dei tipi Visio.
  2. Dichiarare una variabile come tipo di oggetto Visio (in genere Visio.Application o Visio.Documents).
  3. Assegnare il metodo GetObject o CreateObject alla variabile di oggetto dichiarato nel passaggio 2.
  4. ╚ possibile utilizzare proprietÓ, metodi e gli oggetti figlio dell'oggetto di Visio per automatizzare Visio.

Passaggio 1: Aggiunge un riferimento al libreria dei tipi di Visio

Per aggiungere un riferimento alla libreria dei tipi Visio utilizzando applicazioni di Microsoft Office quali Microsoft Office XP o Office 2003, attenersi alla seguente procedura:
  1. In Access, PowerPoint, Excel o Word, scegliere macro dal menu Strumenti , quindi Visual Basic Editor .
  2. Nel menu Strumenti , fare clic su riferimenti .

    Nota Per aggiungere il riferimento utilizzando Microsoft Visual Basic 6.0, fare clic su riferimenti dal menu progetto .
  3. Nell'elenco di Riferimenti disponibili , fare clic per selezionare una delle seguenti caselle di controllo, a seconda della versione di Visio che si sta utilizzando:
    • Per Visio 2007, fare clic per selezionare la casella di controllo Microsoft Visio 12.0 Type Library .
    • Per Visio 2003, fare clic per selezionare la casella di controllo Microsoft Visio 11.0 Type Library .
    • Per Visio 2002, fare clic per selezionare la casella di controllo Microsoft Visio 2002 Type Library .
Quando si aggiunge il riferimento della libreria dei tipi Microsoft Visio, Ŕ possibile accedere a Guida in linea di Microsoft Visio e modello di oggetto di Visio. PoichÚ i riferimenti vengono salvati in ogni progetto, Ŕ necessario aggiungere il riferimento libreria dei tipi di Visio per ogni progetto di Visual Basic o VBA che si desidera utilizzare per automatizzare Visio.

Passaggio 2: Dichiarare la variabile oggetto

Per dichiarare una variabile di una dimensione variabile, oggetto di Visio come tipo di oggetto Visio specifico, ad esempio Visio.Application, Visio.Documents o Visio.Page.

Dichiarazione in modo esplicito che il tipo di oggetto Ŕ detta associazione anticipata in quanto si connette l'applicazione controller o Associa l'oggetto all'applicazione di Visio in fase di compilazione anzichÚ in fase di esecuzione. Questo consente di accedere a elenchi di Visio automaticamente e la Guida sensibile al contesto e consente di eseguire in modo pi¨ efficiente il codice.

Per ulteriori informazioni sull'associazione dell'oggetto, fare clic sul numero dell'articolo della Microsoft Knowledge Base riportato di seguito riportato:
138138Ritardo, ID, prima di associazione tipi possibili in Visual Basic per applicazioni
L'argomento di Visual Basic di esempio riportato di seguito dichiara la variabile AppVisio come oggetto di tipo Visio.Application:

   Dim AppVisio as Visio.Application
				

Passaggio 3: Impostare la variabile

╚ possibile utilizzare i due metodi di Visual Basic riportati di seguito per attivare Visio:
  • CreateObject
  • GetObject
La differenza principale Ŕ che il metodo CreateObject crea una nuova istanza di Visio, e il metodo GetObject utilizza un'istanza giÓ in esecuzione di Visio. ╚ inoltre possibile utilizzare GetObject per impostare la variabile oggetto su un documento di Visio specifico.

L'argomento di esempio riportato di seguito imposta la variabile di AppVisio all'applicazione di Visio utilizzando il metodo CreateObject funzione:
   Dim AppVisio as Visio.Application

   Set AppVisio = CreateObject("Visio.Application")
				
in alcuni casi, si desideri utilizzare un'istanza di Visio esistente se Visio Ŕ giÓ in esecuzione ma creare una nuova istanza se Visio non Ŕ in esecuzione. A tale scopo, creare un gestore errori che utilizza il metodo CreateObject nel caso in cui il metodo GetObject ha esito negativo, come illustrato nel codice di esempio:
   Dim AppVisio As Visio.Application

   On Error Resume Next

   Set AppVisio = GetObject(, "visio.application")

   If AppVisio Is Nothing Then
      Set AppVisio = CreateObject("visio.application")
   End If

				
Nota ╚ possibile utilizzare la funzione di CreateObject per creare un di Visio che l'istanza invisibile. Ad esempio:
Set AppVisio = CreateObject("Visio.InvisibleApp")
				
Ŕ quindi possibile utilizzare proprietÓ Visible dell'oggetto Application per controllare se l'istanza Ŕ visibile.

╚ possibile utilizzare l'oggetto InvisibleApp con solo la funzione CreateObject. Tenta di utilizzarlo con GetObject funzione avrÓ esito negativo. Oggetto InvisibleApp non Ŕ disponibile nelle versioni di Visio precedenti a Microsoft Visio 2000.

Passaggio 4: Utilizzare oggetti, metodi e proprietÓ di Visio

Dopo aver completato i passaggi da 1 a 3, Ŕ possibile utilizzare il Visio variabile oggetto per automatizzare Visio.

La seguente macro di esempio utilizzi l'automazione per avviare Visio, creare un nuovo disegno (documento) basato sul modello Basic Diagram, Elimina un rettangolo, viene aggiunto del testo e Salva il disegno e consente di uscire da Visio.
Sub AutoVisio()

   
   Dim AppVisio As Visio.Application  ' Declare an Instance of Visio.
   Dim docsObj As Visio.Documents     ' Documents collection of instance.
   Dim DocObj As Visio.Document       ' Document to work in.
   Dim stnObj As Visio.Document       ' Stencil that contains master.
   Dim mastObj As Visio.Master        ' Master to drop.
   Dim pagsObj As Visio.Pages         ' Pages collection of document.
   Dim pagObj As Visio.Page           ' Page to work in.
   Dim shpObj As Visio.Shape          ' Instance of master on page.

   ' Create an instance of Visio and create a document based on the
   ' Basic Diagram template. It doesn't matter if an instance of
   ' Visio is already running, CreateObject will run a new one.
   Set AppVisio = CreateObject("visio.application")

   Set docsObj = AppVisio.Documents

   ' Create a document based on the Basic Diagram template that
   ' automatically opens the Basic Shapes stencil.
   Set DocObj = docsObj.Add("Basic Diagram.vst")

   Set pagsObj = AppVisio.ActiveDocument.Pages

   ' A new document always has at least one page, whose index in the
   ' Pages collection is 1.
   Set pagObj = pagsObj.Item(1)

   Set stnObj = AppVisio.Documents("Basic Shapes.vss")
   Set mastObj = stnObj.Masters("Rectangle")

   ' Drop the rectangle in the approximate middle of the page.
   ' Coordinates passed with the Drop method are always inches.
   Set shpObj = pagObj.Drop(mastObj, 4.25, 5.5)

   ' Set the text of the rectangle.
   shpObj.Text = "This is some text."

   ' Save the drawing and quit Visio. The message pauses the program
   ' so you can see the Visio drawing before the instance closes.
   DocObj.SaveAs "MyDrawing.vsd"
   MsgBox "Drawing finished!", , "AutoVisio (OLE) Example"

   ' Quit Visio.
   AppVisio.Quit

   ' Clear the variable from memory.
   Set AppVisio = Nothing

End Sub
				

Riferimenti

Siti Web di Microsoft Visio Developer

Per ulteriori informazioni su come automatizzare Visio, visitare il sito di Web di Microsoft:
http://msdn2.microsoft.com/en-us/office/aa905478.aspx
Per ulteriori informazioni sullo sviluppo di Microsoft Visio soluzioni, visitare il sito di Web di Microsoft:
http://msdn2.microsoft.com/en-us/library/aa217846(office.10).aspx

Visio SDK

Per scaricare Visio 2002 Software Development Kit, il seguente sito Microsoft Web:
http://www.microsoft.com/downloads/details.aspx?familyid=d2845e80-6634-4703-9ad9-7e440ede12d7&displaylang=en

Per scaricare Visio 2003 Software Development Kit, il seguente sito Microsoft Web:
http://www.microsoft.com/downloads/details.aspx?familyid=557120bd-b0bb-46e7-936a-b8539898d44d&displaylang=en

Newsgroup

Il seguente newsgroup peer-to-peer Ŕ disponibile per consentono di interagire con altri utenti di Visual Basic, Applications Edition:
Microsoft.public.vb.OLE.Automation
Microsoft.public.Visio.Developer.VBA

Guida di Visual Basic

Per ulteriori informazioni su come utilizzare la funzione CreateObject , in Visual Basic Editor scegliere Guida in linea di Visual Basic dal menu Guida , digitare funzione createobject nella casella di ricerca e quindi scegliere Cerca per visualizzare gli argomenti restituiti.

Per ulteriori informazioni su come utilizzare la funzione GetObject in Visual Basic Editor scegliere Guida in linea di Visual Basic dal menu Guida , digitare funzione getobject nella casella di ricerca e quindi scegliere Cerca per visualizzare gli argomenti restituiti.

ProprietÓ

Identificativo articolo: 309603 - Ultima modifica: mercoledý 11 aprile 2007 - Revisione: 4.1
Le informazioni in questo articolo si applicano a:
  • Microsoft Office Visio Standard 2007
  • Microsoft Office Visio Professional 2007
  • Microsoft Office Visio Standard 2003
  • Microsoft Office Visio Professional 2003
  • Microsoft Visio 2002 Standard Edition
  • Microsoft Visio 2002 Professional Edition
Chiavi:á
kbmt kbautomation kbprogramming kbvba kbhowto KB309603 KbMtit
Traduzione automatica articoli
Il presente articolo Ŕ stato tradotto tramite il software di traduzione automatica di Microsoft e non da una persona. Microsoft offre sia articoli tradotti da persone fisiche sia articoli tradotti automaticamente da un software, in modo da rendere disponibili tutti gli articoli presenti nella nostra Knowledge Base nella lingua madre dell?utente. Tuttavia, un articolo tradotto in modo automatico non Ŕ sempre perfetto. Potrebbe contenere errori di sintassi, di grammatica o di utilizzo dei vocaboli, pi¨ o meno allo stesso modo di come una persona straniera potrebbe commettere degli errori parlando una lingua che non Ŕ la sua. Microsoft non Ŕ responsabile di alcuna imprecisione, errore o danno cagionato da qualsiasi traduzione non corretta dei contenuti o dell?utilizzo degli stessi fatto dai propri clienti. Microsoft, inoltre, aggiorna frequentemente il software di traduzione automatica.
Clicca qui per visualizzare la versione originale in inglese dell?articolo: 309603
LE INFORMAZIONI CONTENUTE NELLA MICROSOFT KNOWLEDGE BASE SONO FORNITE SENZA GARANZIA DI ALCUN TIPO, IMPLICITA OD ESPLICITA, COMPRESA QUELLA RIGUARDO ALLA COMMERCIALIZZAZIONE E/O COMPATIBILITA' IN IMPIEGHI PARTICOLARI. L'UTENTE SI ASSUME L'INTERA RESPONSABILITA' PER L'UTILIZZO DI QUESTE INFORMAZIONI. IN NESSUN CASO MICROSOFT CORPORATION E I SUOI FORNITORI SI RENDONO RESPONSABILI PER DANNI DIRETTI, INDIRETTI O ACCIDENTALI CHE POSSANO PROVOCARE PERDITA DI DENARO O DI DATI, ANCHE SE MICROSOFT O I SUOI FORNITORI FOSSERO STATI AVVISATI. IL DOCUMENTO PUO' ESSERE COPIATO E DISTRIBUITO ALLE SEGUENTI CONDIZIONI: 1) IL TESTO DEVE ESSERE COPIATO INTEGRALMENTE E TUTTE LE PAGINE DEVONO ESSERE INCLUSE. 2) I PROGRAMMI SE PRESENTI, DEVONO ESSERE COPIATI SENZA MODIFICHE, 3) IL DOCUMENTO DEVE ESSERE DISTRIBUITO INTERAMENTE IN OGNI SUA PARTE. 4) IL DOCUMENTO NON PUO' ESSERE DISTRIBUITO A SCOPO DI LUCRO.

Invia suggerimenti

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com