Page. DropManyLinkedU-Methode (Visio)Page.DropManyLinkedU method (Visio)

Erstellt mehrere neue Shapes auf dem Zeichenblatt, die mit mehreren Datenzeilen in einem Datenrecordset verknüpft sind.Creates multiple new shapes on the drawing page that are linked to multiple data rows in a data recordset. Gibt die Anzahl der erstellten Shape-Instanzen und ein Array von IDs dieser Shapes zurück.Returns the number of shape instances created and an array of IDs of those shapes.

Hinweis

Dieses Visio-Objekt oder dieses Visio-Mitglied ist nur für lizenzierte Benutzer von Visio Professional 2013 verfügbar.This Visio object or member is available only to licensed users of Visio Professional 2013.

SyntaxSyntax

Ausdruck.expression. DropManyLinkedU( _ObjectsToInstance()_ , _XYs()_ , _DataRecordsetID_ , _DataRowIDs()_ , _ApplyDataGraphicAfterLink_ , _ShapeIDs()_ )

Ausdruck Ein Ausdruck, der ein Page -Objekt zurückgibt.expression An expression that returns a Page object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
ObjectsToInstance ()ObjectsToInstance() ErforderlichRequired VariantVariant Ein Array vom Typ Variant mit Objekten, für die Instanzen erstellt werden sollen.An array of type Variant of objects to create instances of.
XYs()XYs() ErforderlichRequired DoubleDouble Ein Array vom Typ DoubleAn array of type Double
DataRecordsetIDDataRecordsetID ErforderlichRequired LongLong Die ID des Datenrecordsets, das die zu verknüpfenden Datenzeilen enthält.The ID of the data recordset containing the data rows to link to.
DataRowIDs()DataRowIDs() ErforderlichRequired LongLong Ein Array vom Typ Long mit IDs der Datenzeilen, die die zu verknüpfenden Daten enthalten.An array of type Long of IDs of the data rows containing the data to link to.
ApplyDataGraphicAfterLinkApplyDataGraphicAfterLink ErforderlichRequired BooleanBoolean Gibt an, ob die aktuelle Datengrafik auf die verknüpften Shapes angewendet werden soll.Whether to apply the current data graphic to the linked shapes. Weitere Informationen finden Sie in den Anmerkungen.See Remarks for more information.
ShapeIDs ()ShapeIDs() ErforderlichRequired LongLong Ausgabeparameter.Out parameter. Ein Array vom Typ Long von Formen, die erstellt und mit verknüpft sind.An array of type Long of shapes created and linked to.

RückgabewertReturn value

LongLong

HinweiseRemarks

Wenn Sie Shapes erstellen möchten, die bereits mit Daten auf einem Zeichenblatt verknüpft sind, die entweder keine Formen enthalten oder andere Formen als die, die Sie verknüpfen möchten, können Sie die Methoden Page. DropLinked und Page. DropManyLinkedU verwenden, um eine zu erstellen oder Weitere weitere Formen, die bereits mit Daten verknüpft sind.When you want to create shapes already linked to data on a drawing page that either does not contain any shapes or contains shapes other than the ones you want to link, you can use the Page.DropLinked and Page.DropManyLinkedU methods to create one or more additional shapes already linked to data. Diese Methoden ähneln den vorhandenen Page. Drop -und Page. DropManyU -Methoden darin, dass Sie zusätzliche Formen an einer bestimmten Position auf der Seite erstellen. Darüber hinaus werden Verknüpfungen zwischen den neuen Formen und den angegebenen Datenzeilen in einem angegebenen Datenrecordset erstellt.These methods resemble the existing Page.Drop and Page.DropManyU methods in that they create additional shapes at a specified location on the page; but in addition, they create links between the new shapes and specified data rows in a specified data recordset.

Übergeben Sie für den ObjectsToInstance()-Parameter ein Array mit Objekten, die zu mit Daten verknüpften Shapes instanziiert werden sollen.For the ObjectsToInstance() parameter, pass an array of objects to instance into shapes linked to data. Während diese Objekte typischerweise Visio-Objekte wie Master-, Shape-oder Selection -Objekte sind, können Sie beliebige OLE-Objekte sein, die eine IDataObject -Schnittstelle bereitstellen.While these objects are typically Visio objects such as Master, Shape, or Selection objects, they can be any OLE objects that provide an IDataObject interface.

Übergeben Sie für den XYs()-Parameter ein Array vom Typ Double.For the XYs() parameter, pass an array of type Double. Jedes aufeinanderfolgende paar von Array-Index-Position-Werten sollte den x- und y-Seiten- Koordinaten entsprechen, an denen die Instanz des Objekts an der entsprechenden Position im ObjectsToInstance ()-Array positioniert werden soll.Each consecutive pair of array-index-position values should correspond to the x- and y- page coordinates where you want the instance of the object in the corresponding position in the ObjectsToInstance() array to be positioned. Wenn Sie beispielsweise möchten, dass die Instanz des Objekts in der ersten Arrayindex Position in ObjectsToInstance () an der Seitenkoordinate (2, 4) positioniert wird, platzieren Sie den Wert 2 in der ersten Arrayindex Position in XYs (), und platzieren Sie den Wert 4 in der zweiten arrayIndex Position in diesem Array usw. für die restlichen Objekte und Koordinaten.For example, if you want the instance of the object in the first array index position in ObjectsToInstance() to be positioned at page coordinate (2,4), place the value 2 in the first array index position in XYs(), and place the value 4 in the second array index position in that array, and so on for the rest of the objects and coordinates.

Wenn ein Objekt, das Sie im ObjectsToInstance ()-Array übergeben, eine Form ist, wird der Mittelpunkt des Felds für die Breite der Form an den in XYs () angegebenen Koordinaten positioniert.When an object you pass in the ObjectsToInstance() array is a shape, the center of the shape's width-height box is positioned at the coordinates you specify in XYs().

Wenn ein im ObjectsToInstance()-Array übergebenes Objekt ein Master-Objekt ist, wird der Drehbezugspunkt des Masters bei den unter XYs() angegebenen Koordinaten positioniert.When an object you pass in the ObjectsToInstance() array is a master, the pin of the master is positioned at the coordinates you specify in XYs(). Der Drehbezugspunkt eines Masters ist häufig der Mittelpunkt der Drehung, aber nicht notwendigerweise.A master's pin is often, but not necessarily, at its center of rotation.

Übergeben Sie für den DataRowIDs()-Parameter ein Array mit Long-Werten. Diese Werte stellen die IDs der Datenzeilen im Datenrecordset dar, die mit den Shape-Instanzen verknüpft werden sollen, die aus den Objekten an den entsprechenden Array-Indexpositionen im Array ObjectsToInstance() erstellt wurden.For the DataRowIDs() parameter, pass an array of Long values that represent the IDs of the data rows in the data recordset that you want to link to the shape instances created from the objects in the corresponding array index positions in the ObjectsToInstance() array.

Übergeben Sie für den Parameter ShapeIDs() ein leeres Array ohne Dimensionen vom Typ Long.For the ShapeIDs() parameter, pass an empty, dimensionless array of type Long. Die Methode gibt das Array zurück, das die IDs der neu erstellten und verknüpften Shapes enthält.The method will return the array filled with the IDs of the newly created and linked shapes.

Hinweis

Ab Microsoft Visio 2000 können Sie sowohl lokale als auch universelle Namen verwenden, um auf Shapes, Master-Shapes, Dokumente, Zeichenblätter, Zeilen, Add-Ons, Zellen, Hyperlinks, Formatvorlagen, Schriftarten, Master-Shape-Verknüpfungen, Benutzeroberflächenobjekte und Layer von Visio zu verweisen.Beginning with Microsoft Visio 2000, you can use both local and universal names to refer to Visio shapes, masters, documents, pages, rows, add-ons, cells, hyperlinks, styles, fonts, master shortcuts, UI objects, and layers. Wenn ein Benutzer eine Form benennt, wird beispielsweise der Benutzer einen lokalen Namen angeben. Beginnend mit Microsoft Office Visio 2003 werden in der ShapeSheet-Kalkulationstabelle nur universelle Namen in Zellformeln und-Werten angezeigt.When a user names a shape, for example, the user is specifying a local name.Beginning with Microsoft Office Visio 2003, the ShapeSheet spreadsheet displays only universal names in cell formulas and values. (In früheren Versionen von Visio wurden universelle Namen nicht auf der Benutzeroberfläche angezeigt.) Als Entwickler können Sie universelle Namen in einem Programm verwenden, wenn Sie nicht bei jeder Lokalisierung einer Lösung einen Namen ändern möchten.(In prior versions of Visio, universal names were not visible in the user interface.) As a developer, you can use universal names in a program when you don't want to change a name each time a solution is localized. Verwenden Sie die DropManyLinkedU-Methode, um mehrere mit Daten verknüpfte Shapes abzulegen, wenn Sie zum Identifizieren der Shapes universelle Namen verwenden.Use the DropManyLinkedU method to drop more than one shape linked to data when you are using universal names to identify the shapes.

BeispielExample

Mit dem folgenden VBA-Makro (Microsoft Visual Basic for Applications) wird gezeigt, wie Sie mithilfe der DropManyLinkedU -Methode mehrere Formen auf dem aktiven Zeichenblatt erstellen, die an angegebenen Koordinaten zentriert sind und mit Datenzeilen im Datenrecordset verknüpft sind: wurde kürzlich dem aktiven Dokument hinzugefügt.The following Microsoft Visual Basic for Applications (VBA) macro shows how to use the DropManyLinkedU method to create several shapes on the active drawing page, centered at specified coordinates, and linked to a data rows in the data recordset most recently added to the active document. Es wird die Anzahl der erstellten Formen und ihre ID-Nummern im Direktfenster gedruckt.It prints the number of shapes created and their ID numbers to the Immediate window.

Die an die DropManyLinkedU -Methode übergebenen Formen sind einfache Formulare aus der Schablone Basis Formen (US-Einheiten) .The shapes passed to the DropManyLinkedU method are simple forms from the Basic Shapes (US units) stencil. Verwenden Sie vor dem Ausführen dieses Makros die DataRecordsets . Add -Methode oder eine andere Möglichkeit, der DataRecordsets- **** Auflistung mindestens ein Datenrecordset hinzuzufügen, und stellen Sie sicher, dass die Schablone Basic Shapes (US-Einheiten) in der Visio-Zeichnung geöffnet ist. Fenster.Before running this macro, use the DataRecordsets.Add method or another means to add at least one data recordset to the DataRecordsets collection, and make sure that the Basic Shapes (US units) stencil is open in the Visio drawing window.

Sub DropManyLinkedU_Example() 
 
    Dim avarObjects(0 To 2) As Variant 
    Dim adblXYs(0 To 5) As Double   
    Dim alngDataRowIDs(0 To 2) As Long 
    Dim alngShapeIDs() As Long 
    Dim vsoDataRecordset As Visio.DataRecordset 
    Dim intRecordsetCount As Integer 
    Dim lngReturned As Long 
    Dim intCounter As Integer 
     
    intRecordsetCount = Visio.ActiveDocument.DataRecordsets.Count 
    Set vsoDataRecordset = Visio.ActiveDocument.DataRecordsets(intRecordsetCount) 
     
    Set avarObjects(0) = Visio.Documents("Basic_U.VSS").Masters("Rectangle") 
    Set avarObjects(1) = Visio.Documents("Basic_U.VSS").Masters("Triangle") 
    Set avarObjects(2) = Visio.Documents("Basic_U.VSS").Masters("Circle") 
     
    adblXYs(0) = 2 
    adblXYs(1) = 2 
    adblXYs(2) = 4 
    adblXYs(3) = 4 
    adblXYs(4) = 6 
    adblXYs(5) = 6 
         
    alngDataRowIDs(0) = 1 
    alngDataRowIDs(1) = 2 
    alngDataRowIDs(2) = 3 
         
    lngReturned = ActivePage.DropManyLinkedU(avarObjects, adblXYs, vsoDataRecordset.ID, alngDataRowIDs, True, alngShapeIDs) 
    Debug.Print lngReturned 
     
    For intCounter = 0 To lngReturned - 1 
        Debug.Print alngShapeIDs(intCounter) 
    Next 
     
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.