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.

Syntax

Ausdruck. LinkReplaceBehavior

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

Rückgabewert

VisLinkReplaceBehavior

HinwBemerkungeneise

Die folgenden Konstanten für das Linkersetzungsverhalten werden von der Visio-Typbibliothek in VisLinkReplaceBehavior deklariert:

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.