Selection.LinkToData-Methode (Visio)

Artikel
04/07/2023

Verknüpft eine Auswahl von Shapes mit einer einzelnen Datenzeile in einem Datenrecordset.

Hinweis

Dieses Visio-Objekt oder dieses Visio-Mitglied ist nur für lizenzierte Benutzer von Visio Professional 2013 verfügbar.

Syntax

Ausdruck. LinkToData( _DataRecordsetID_ , _DataRowID_ , _AutoApplyDataGraphics_ )

Ausdruck Ein Ausdruck, der ein Selection-Objekt zurückgibt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
DataRecordsetID	Erforderlich	Long	Die ID des Datenrecordsets, das die Daten enthält, mit denen eine Verknüpfung hergestellt werden soll.
DataRowID	Erforderlich	Long	Die ID der Zeile im Datenrecordset, die den zu verknüpfenden Datensatz enthält.
AutoApplyDataGraphics	Optional	Boolescher Wert	Gibt an, ob eine Datengrafik automatisch auf die verknüpften Shapes angewendet werden soll. Weitere Informationen finden Sie in den Anmerkungen.

Rückgabewert

Nichts

Bemerkungen

Die Selection.LinkToData-Methode funktioniert ähnlich wie die entsprechende Methode des Shape-Objekts, Shape.LinkToData. Allerdings wird anstelle eines einzelnen Shapes eine Auswahl von Shapes mit einer einzelnen Datenzeile verknüpft.

Wenn Visio keine Verknüpfung zwischen einem Shape und der Datenzeile herstellen kann, wird dieses Shape übersprungen, und Visio fährt mit dem nächsten Shape in der Auswahl fort. Nachdem Sie die -Methode ausgeführt haben, um festzustellen, ob alle Shapes in der Auswahl tatsächlich mit der Datenzeile verknüpft sind, rufen Sie die Shape.GetLinkedDataRow-Methode für jedes Shape in der Auswahl auf. Wenn bei dieser Methode für eins der Shapes ein Fehler auftritt, bedeutet dies, dass das Shape nicht mit der Datenzeile verknüpft ist. Visio ist in der Regel erfolgreich, eine Zeile mit einem Shape zu verknüpfen, es sei denn, das Shape ist bereits mit Daten verknüpft, und die Einstellung link-replacement-behavior für das Datenrecordset gibt an, dass die Verknüpfung nicht ersetzt werden soll.

Wenn Sie True als AutoApplyDataGraphics-Parameter übergeben, wendet Visio die vorhandene Datengrafik erneut auf die Shapes an, auf die bereits vor dem Aufrufen der Methode Datengrafiken angewendet worden waren. Auf Shapes ohne Datengrafik wendet Visio die Datengrafik an, die zuletzt auf ein anderes Shape im aktuellen Dokument angewendet wurde.

Beispiel

Das folgende VBA-Makro (Microsoft Visual Basic für Applikationen) veranschaulicht, wie Sie mit der LinkToData-Methode die Shapes in einer Auswahl mit einer Datenzeile verknüpfen.

Platzieren Sie vor dem Ausführen dieses Makros mehrere Shapes auf dem Zeichenblatt, und fügen Sie der DataRecordsets-Auflistung des Dokuments mindestens ein Datenrecordset hinzu. Das Makro verwendet die ID des Datenrecordsets, das der Auflistung zuletzt hinzugefügt wurde. Ausgewählte Shapes werden mit den Daten in der ersten Zeile des Datenrecordsets verknüpft.

Public Sub LinkToData_Example() 
 
    Dim vsoDataRecordset As Visio.DataRecordset 
    Dim vsoSelection As Visio.Selection 
    Dim intCount As Integer 
     
    intCount = Visio.ActiveDocument.DataRecordsets.Count 
    Set vsoDataRecordset = Visio.ActiveDocument.DataRecordsets(intCount) 
     
    ActiveWindow.DeselectAll 
    ActiveWindow.SelectAll 
     
    Set vsoSelection = ActiveWindow.Selection 
    vsoSelection.LinkToData vsoDataRecordset.ID, 1, True 
 
End Sub

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.

Freigeben über