Application. DocumentCreated-Ereignis (Visio)Application.DocumentCreated event (Visio)

Tritt ein, nachdem ein Dokument erstellt wurde.Occurs after a document is created.

SyntaxSyntax

Ausdruck. DocumentCreated (doc)expression.DocumentCreated (doc)

expression Eine Variable, die ein Application-Objekt darstellt.expression A variable that represents an Application object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
docdoc ErforderlichRequired [IVDOCUMENT][IVDOCUMENT] Das Dokument, das erstellt wurde.The document that was created.

BemerkungenRemarks

Das DocumentCreated -Ereignis wird häufig zur EventList -Auflistung einer Microsoft Visio Vorlagendatei (VST) hinzugefügt.The DocumentCreated event is often added to the EventList collection of a Microsoft Visio template file (.vst). Die Ereignisaktion wird jedes Mal ausgelöst, wenn anhand dieser Vorlage ein neues Dokument erstellt wird.The event's action is triggered whenever a new document is created based on that template.

Wenn Sie Microsoft Visual Basic oder Visual Basic für Applikationen (VBA) verwenden, beschreibt die Syntax in diesem Thema eine gängige und effiziente Methode zum Verarbeiten von Ereignissen.If you are using Microsoft Visual Basic or Visual Basic for Applications (VBA), the syntax in this topic describes a common, efficient way to handle events.

Wenn Sie eigene Event -Objekte erstellen möchten, verwenden Sie die Add - oder AddAdvise-Methode.If you want to create your own Event objects, use the Add or AddAdvise method.

Verwenden Sie zum Erstellen eines Event-Objekts, das ein Add-On ausführt, die Add-Methode der EventList-Auflistung.To create an Event object that runs an add-on, use the Add method as it applies to the EventList collection.

Verwenden Sie zum Erstellen eines Event-Objekts, das eine Benachrichtigung empfängt, die AddAdvise-Methode.To create an Event object that receives notification, use the AddAdvise method.

Informationen zum Suchen eines Ereigniscodes für das Ereignis, das Sie erstellen möchten, finden Sie unter Ereigniscodes.To find an event code for the event that you want to create, see Event codes.

Sie können DocumentCreated -Ereignisse zur EventList -Auflistung eines Application -Objekts, einer Documents -Auflistung oder eines Document -Objekts hinzufügen.You can add DocumentCreated events to the EventList collection of an Application object, Documents collection, or Document object. Die ersten beiden Fälle sind unkompliziert: Wenn ein Dokument im Bereich eines Application-Objekts oder seiner Documents-Auflistung geöffnet oder erstellt wird, tritt das DocumentCreated-Ereignis ein.The first two are straightforward; if a document is opened or created in the scope of the Application object or its Documents collection, the DocumentCreated event occurs.

Das Hinzufügen eines DocumentCreated -Ereignisses zur EventList -Auflistung eines Document -Objekts ist jedoch nur dann sinnvoll, wenn es sich bei der Aktion des Ereignisses um visActCodeRunAddonhandelt.However, adding a DocumentCreated event to the EventList collection of a Document object makes sense only if the event's action is visActCodeRunAddon. In diesem Fall ist das Ereignis dauerhaft; Sie kann mit dem Dokument gespeichert werden.In this case, the event is persistable; it can be stored with the document. Wenn das Dokument, das das persistent-Ereignis enthält, geöffnet wird, wird die entsprechende Aktion ausgelöst.If the document that contains the persistent event is opened, its action is triggered. Wenn ein neues Dokument auf dem Dokument basiert oder aus dem Dokument kopiert wird, das das persistente Ereignis enthält, wird das DocumentCreated -Ereignis in das neue Dokument kopiert, und seine Aktion wird ausgelöst.If a new document is based on or copied from the document that contains the persistent event, the DocumentCreated event is copied to the new document and its action is triggered. Wenn die Aktion des Ereignisses jedoch visActCodeAdviseist, ist dieses Ereignis nicht dauerhaft und wird daher nicht mit dem Dokument gespeichert. Daher wird Sie nie ausgelöst.However, if the event's action is visActCodeAdvise, that event is not persistable and therefore is not stored with the document; hence, it is never triggered.

Sie können verhindern, dass Code als Reaktion auf das DocumentCreated-, DocumentOpened-oder DocumentAdded -Ereignis und alle Ereignisse ausgelöst wird, indem Sie den Wert der EventsEnabled -Eigenschaft eines Application -Objekts festlegen. auf false.You can prevent code from running in response to the DocumentCreated, DocumentOpened, or DocumentAdded event and all events from firing by setting the value of the EventsEnabled property of an Application object to False.

BeispielExample

In diesem VBA-Beispiel wird gezeigt, wie Shapes gezählt werden, die einer Zeichnung hinzugefügt wurden, die auf einem Master namens Squarebasiert.This VBA example shows how to count shapes added to a drawing that are based on a master called Square.

Der DocumentCreated -Ereignishandler wird ausgeführt, wenn eine neue Zeichnung basierend auf der Vorlage erstellt wird, die diesen Code enthält.The DocumentCreated event handler runs when a new drawing based on the template that contains this code is created. Der Handler initialisiert eine Variable für eine ganze Zahl intNumberOfSquares mit der die Zählung gespeichert wird.The handler initializes an integer variable, intNumberOfSquares, which is used to store the count.

Der ShapeAdded -Ereignishandler wird jedes Mal ausgeführt, wenn dem Zeichenblatt eine Form hinzugefügt wird, unabhängig davon, ob das Shape aus einer Schablone gezogen, mit einem Zeichentool gezeichnet oder aus der Zwischenablage eingefügt wird.The ShapeAdded event handler runs each time a shape is added to the drawing page, whether the shape is dragged from a stencil, drawn with a drawing tool, or pasted from the Clipboard. Der Handler überprüft die Master -Eigenschaft des neuen Shapes, und wenn die Form auf dem quadratischen **** Master basiert, inkrementiert intNumberOfSquares.The handler checks the Master property of the new shape, and if the shape is based on the Square master, increments intNumberOfSquares.

 
Dim intNumberOfSquares As Integer 
 
Private Sub Document_DocumentCreated(ByVal vsoDocument As Visio.IVDocument) 
 
'Initialize number of squares added. 
 intNumberOfSquares = 0 
 
End Sub 
 
 
Private Sub Document_ShapeAdded(ByVal vsoShape As Visio.IVShape) 
 
 Dim vsoMaster As Visio.Master 
 
 'Get the Master property of the shape. 
 'the shape was created locally. 
 Set vsoMaster = vsoShape.Master 
 
 'Check whether the shape has a master. If not, 
 If Not (vsoMaster Is Nothing) Then 
 
 'Check whether the master is "Square". 
 If vsoMaster.Name = "Square" Then 
 
 'Increment the count for the number of squares added. 
 intNumberOfSquares = intNumberOfSquares + 1 
 
 End If 
 
 End If 
 
 MsgBox "Number of squares: " & intNumberOfSquares, vbInformation, _ 
 "Document Created Example" 
 
End Sub

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.