バージョン

ダイアグラム ノードの接続ポイントの構成 (xamDiagram)

トピックの概要

目的

このトピックでは、 xamDiagram™ コントロールでダイアグラム ノードの接続ポイントを構成する方法を説明します。これは、カスタム ノードを使用する場合や、標準ノードの事前設定された接続ポイントをカスタマイズする場合に必要です。

前提条件

このトピックをより理解するために、以下のトピックを参照することをお勧めします。

トピック 目的

このトピックは、ダイアグラムのノードについて構成可能な内容の概要を提供します。

このトピックでは、 xamDiagram コントロールを WPF アプリケーションに追加する方法を説明します。

このトピックの内容

このトピックは、以下のセクションで構成されます。

概要

接続ポイントの構成の概要

接続ポイントとは、ダイアグラム接続を開始 / 終了できるノードのポイントです。ノードの接続ポイントは、名前と座標により指定されます。

  • 名前 - 接続の StartNodeConnectionPointName / EndNodeConnectionPointName プロパティを介して接続の接続ポイントを明示的に指定する場合に使用されます。このため、ノードの接続ポイントの名前は、すべて一意であることが必要です。

  • 座標 - ノードの長方形に対応しています。座標の範囲は 0,0 (左上) から 1,1 (右下) までです。

各接続ポイントは、 Name プロパティと Position プロパティを公開する DiagramConnectionPoint オブジェクトによって表されます。

DiagramNode.ShapeType プロパティにより設定された定義済みの図形タイプを使用する場合、ノードの ConnectionPoints コレクションで、ノード タイプに応じていくつかのポイントが事前設定されます。カスタム ノードの図形では、デフォルトで接続ポイントが追加されません。

接続ポイントの構成の概要表

以下の表は、ダイアグラムのノードの接続ポイントの構成可能な要素を簡単に説明し、それらを構成するプロパティにマップします。

構成可能な項目 詳細 プロパティ

カスタム接続ポイント

このノードに接続されたコネクションの開始 / 終了ポイントを追加 / 削除します。

ノードのカスタム接続ポイントの構成

概要

ノードの接続ポイントは、 ConnectionPoints プロパティで指定されます。DiagramConnectionPointCollection の Add メソッドと Remove メソッドを使用できます。

プロパティ設定

以下の表は、任意の構成とそれを管理するプロパティ設定のマップを示します。

目的: 使用するプロパティ: 設定値:

ノードに対するカスタム接続ポイントの設定

接続ポイントの目的のセット

例

以下のスクリーンショットは、以下のコードを実行した結果、接続ポイントのプレゼンターが表示される場合に、 xamDiagram のノードがどのように表示されるかを示しています。

xamDiagram Configuring The Connection Points Of Diagram Nodes 1.png

以下のコードはこの例を実装します。

XAML の場合:

<ig:XamDiagram x:Name="Diagram">
      <ig:DiagramNode>
            <ig:DiagramNode.ConnectionPoints>
                  <ig:DiagramConnectionPoint Name="Position1" Point="0,0"/>
                  <ig:DiagramConnectionPoint Name="Position2" Point="0.25,0.25"/>
                  <ig:DiagramConnectionPoint Name="Position3" Point="0.5,0.5"/>
                  <ig:DiagramConnectionPoint Name="Position4" Point="0.75,0.75"/>
                  <ig:DiagramConnectionPoint Name="Position5" Point="1,1"/>
            </ig:DiagramNode.ConnectionPoints>
      </ig:DiagramNode>
</ig:XamDiagram>

関連コンテンツ

このトピックの追加情報については、以下のトピックも合わせてご参照ください。

トピック 目的

このトピックでは、 xamDiagram にダイアグラム接続の始点および終点を構成する場合に使用できる 2 つのアプローチ (接続先のノードを指定する方法と、ダイアグラム スペースに接続の始点と終点の座標を指定する方法) について説明します。

XamDiagram.ConnectionPointsDisplayMode プロパティの API 参照。