DataRecordset.LinkReplaceBehavior-Eigenschaft (Visio)
Ruft ab oder legt fest, wie vorhandene Verknüpfungen zwischen Shapes und Datenzeilen behandelt werden, wenn Methoden zum Verknüpfen von Shapes und Daten aufgerufen werden. Lese-/Schreibzugriff.
Hinweis
Dieses Visio-Objekt oder dieses Visio-Mitglied ist nur für lizenzierte Benutzer von Visio Professional 2013 verfügbar.
Syntax
Ausdruck. LinkReplaceBehavior
Ausdruck Ein Ausdruck, der ein DataRecordset-Objekt zurückgibt.
Rückgabewert
VisLinkReplaceBehavior
Hinweise
Die folgenden Konstanten für das Linkersetzungsverhalten werden von der Visio-Typbibliothek in VisLinkReplaceBehavior deklariert:
| Konstante | Wert | Beschreibung |
|---|---|---|
| visLinkReplaceAlways | 1 | Verknüpfungen immer ersetzen, wenn Verknüpfungen mit einem Shape erstellt werden, das über vorhandene Verknüpfungen verfügt. |
| visLinkReplaceNever | 0 | Verknüpfungen nie ersetzen, wenn Verknüpfungen mit einem Shape erstellt werden, das über vorhandene Verknüpfungen verfügt. |
| visLinkReplacePrompt | 2 | Den Benutzer vor dem Ersetzen von Links auffordern, wenn der Benutzer versucht, Links auf der Visio-Benutzeroberfläche zu erstellen. |
Diese Optionen entsprechen den Optionen im Dialogfeld Eigenschaften, das für die Registerkarte des Datenrecordsets im Fenster Externe Daten gilt. (Klicken Sie mit der rechten Maustaste im Fenster Externe Daten auf die Registerkarte für das Datenrecordset, zeigen Sie auf Datenquelle, und klicken Sie dann auf Eigenschaften.)
Von dieser Eigenschaftseinstellung betroffene Methoden sind Selection.LinkToData, Shape.LinkToData und Selection.AutomaticLink.
Wenn Benutzer auf der Benutzeroberfläche versuchen, eine Verknüpfung mit Daten-Shapes mit vorhandenen Links zu Daten zu erstellen, und die Einstellung visLinkReplacePrompt lautet, reagiert Visio, indem ein Dialogfeld geöffnet wird, um die Benutzer darüber zu informieren, dass ihre Aktionen die vorhandenen Links unterbrechen und fragen, ob sie fortfahren möchten. Da das Öffnen eines Dialogfelds keine geeignete Antwort auf einen Methodenaufruf ist, behandelt Visio die Einstellung visLinkReplacePrompt so, als wäre sie visLinkReplaceAlways, wenn Sie Shapes durch Aufrufen einer dieser Methoden verknüpfen. Das heißt, diese beiden Einstellungen unterscheiden sich darin, wie sie sich auf das Verhalten in der Benutzeroberfläche auswirken, aber nicht das programmgesteuerte Verhalten. Standardmäßig werden vorhandene Verknüpfungen immer ersetzt, wenn das Verknüpfen programmgesteuert ausgeführt wird, aber die Aufforderung, wenn die Verknüpfung in der Benutzeroberfläche ausgeführt wird.
Wenn LinkReplaceBehavior auf visLinkReplaceNever festgelegt ist, werden beide LinkToData-Methoden deaktiviert, und Aufrufe dieser Methoden schlagen fehl.
Die Einstellung LinkReplaceBehavior wirkt sich auch auf die Standardeinstellung des Kontrollkästchens Vorhandene Links ersetzen auf dem zweiten Bildschirm des Assistenten für automatische Verknüpfungen in der Visio-Benutzeroberfläche aus (klicken Sie auf der Registerkarte Daten auf Automatisch verknüpfen). Wenn LinkReplaceBehavior auf visLinkReplaceAlways oder visLinkReplacePrompt festgelegt ist, ist dieses Feld standardmäßig aktiviert. Wenn die LinkReplaceBehavior-Eigenschaft auf visLinkReplaceNever festgelegt ist, ist das Kontrollkästchen standardmäßig deaktiviert. Benutzer können das Standardverhalten des Assistenten ändern, indem sie das Kontrollkästchen aktivieren oder deaktivieren.
Darüber hinaus bestimmt die Einstellung LinkReplaceBehavior , wie die Selection.AutomaticLink-Methode funktioniert. Wie bei den LinkToData-Methoden gilt auch hier, dass vorhandene Verknüpfungen durch AutomaticLink ersetzt werden, wenn LinkReplaceBehavior auf visLinkReplaceAlways oder visLinkReplacePrompt festgelegt ist. Und wenn LinkReplaceBehavior auf visLinkReplaceNever festgelegt ist, werden vorhandene Verknüpfungen nicht durch AutomaticLink ersetzt.
Der Unterschied zwischen den LinkToData-Methoden und der AutomaticLink-Methode besteht jedoch darin, dass für AutomaticLink die LinkReplaceBehavior-Einstellung außer Kraft gesetzt werden kann, indem Sie entweder die visAutoLinkReplaceExistingLinks-Konstante oder die visAutoLinkDontReplaceExistingLinks-Konstante aus der VisAutoLinkBehaviors-Aufzählung an die Methode als AutoLinkBehavior-Parameter übergeben.
Wenn beispielsweise für LinkReplaceBehavior der Wert visLinkReplaceNever festgelegt ist, können Sie angeben, dass vorhandene Verknüpfungen dennoch durch AutomaticLink ersetzt werden, indem visAutoLinkReplaceExistingLinks übergeben wird.
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.