DataRecordset.LinkReplaceBehavior プロパティ (Visio)
図形をデータにリンクするメソッドを呼び出したときに図形とデータ行の既存のリンクを処理する方法を取得または設定します。 読み取り/書き込みが可能です。
注:
この Visio オブジェクトまたはメンバーは Visio Professional 2013 のライセンス ユーザーのみが使用できます。
構文
式。LinkReplaceBehavior
式DataRecordset オブジェクトを返す式。
戻り値
VisLinkReplaceBehavior
注釈
リンク置換動作の次の定数は、 VisLinkReplaceBehavior の Visio タイプ ライブラリによって宣言されています。
定数 | 値 | 説明 |
---|---|---|
visLinkReplaceAlways | 1 | 既存のリンクがある図形にリンクする場合は、常にリンクを置き換えます。 |
visLinkReplaceNever | 0 | 既存のリンクがある図形にリンクする場合は、リンクを置き換えません。 |
visLinkReplacePrompt | 2 | ユーザーが Visio ユーザー インターフェイス (UI) でリンクを作成しようとしたときに、リンクを置き換える前にユーザーにメッセージを表示します。 |
これらのオプションは、[外部データ] ウィンドウのデータ レコードセットに対応するタブの [プロパティ] ダイアログ ボックスで使用できるオプションに対応します。 ([ 外部データ ] ウィンドウのデータ レコードセットのタブで、右クリックして [ データ ソース] をポイントし、[ プロパティ] をクリックします)。
このプロパティ設定の影響を受けるメソッドには 、Selection.LinkToData、 Shape.LinkToData、 Selection.AutomaticLink などがあります。
UI で、設定が visLinkReplacePrompt の場合にユーザーが既にデータへのリンクが設定されているデータ図形にリンクすると、このアクションによって既存のリンクが壊れることをユーザーに通知し、操作を続行するかどうかを確認するダイアログ ボックスが開きます。 このダイアログ ボックスを開く動作は、これらのメソッドの呼び出しに適した応答ではないので、いずれかのメソッドを呼び出して図形をリンクする場合、visLinkReplacePrompt の設定は visLinkReplaceAlways として処理されます。 つまり、これら 2 つの設定は、UI での動作に与える影響によって異なりますが、プログラムによる動作には影響しません。 既定の設定では、プログラム的にリンクが実行されると既存のリンクは常に置き換えられ、UI でリンクが実行されるとプロンプトが表示されます。
LinkReplaceBehavior を visLinkReplaceNever に設定すると、両方の LinkToData メソッドが無効になり、メソッドへの呼び出しは失敗します。
LinkReplaceBehavior 設定は、Visio UI の自動リンク ウィザードの 2 番目の画面の [既存のリンクの置換] チェック ボックスの既定の設定にも影響します ([データ] タブの [自動リンク] をクリックします)。 LinkReplaceBehavior を visLinkReplaceAlways または visLinkReplacePrompt に設定すると、このチェック ボックスは既定でオンになります。 LinkReplaceBehavior プロパティを visLinkReplaceNever に設定すると、このチェック ボックスは既定でオフになります。 ユーザーは、チェック ボックスをオンまたはオフにすることで、ウィザードの既定の動作を変更できます。
さらに、 LinkReplaceBehavior 設定によって Selection.AutomaticLink メソッドがどのように機能するかが決まります。 LinkToData のメソッドの場合と同様に、LinkReplaceBehavior を visLinkReplaceAlways または visLinkReplacePrompt に設定すると、AutomaticLink によって既存のリンクは置き換えられます。 LinkReplaceBehavior を visLinkReplaceNever に設定すると、AutomaticLink によって既存のリンクは置き換えられません。
ただし、LinkToData のメソッドと AutomaticLink メソッドの違いは、AutomaticLink では、VisAutoLinkBehaviors 列挙からメソッドに AutoLinkBehavior パラメーターとして定数 visAutoLinkReplaceExistingLinks または定数 visAutoLinkDontReplaceExistingLinks を渡すことによって、LinkReplaceBehavior の設定を上書きできることです。
したがって、たとえば、LinkReplaceBehavior を visLinkReplaceNever に設定している場合も、visAutoLinkReplaceExistingLinks を AutomaticLink に渡すことによって既存のリンクを置き換えるように指定できます。
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。