このトピックでは、 xamDiagram™ コントロールの各ノードの構成可能な要素の概要を説明します。
このトピックを理解するためには、以下のトピックを理解しておく必要があります:
以下の表は、ダイアグラム ノードの構成可能な要素を簡単に説明し、それらを構成するプロパティにマップします。詳細は、表の後に記載されています。
xamDiagram ノードは、ダイアグラムの領域の任意の位置に個別に配置、またはレイアウト アルゴリズム (Layout プロパティを介して使用可能な設定) を適用して配置します。(レイアウト アルゴリズムの詳細は、 レイアウトの構成のトピックを参照してください。)
デフォルトでは、明示的なオーバーライドが適用されていない場合、座標系の原点 (0、0) に新たに作成されたノードが表示されます。
ダイアグラムのノードのサイズは、幅と高さを設定すると明示的に制御できます。デフォルトのサイズはノードの図形に依存します。(デフォルト サイズの参照については、 ノードのデフォルト サイズを参照してください。)
xamDiagram には、定義済みのノードの図形が複数あります。(詳細は、 概要のトピックを参照してください。)定義済みの図形は、 ShapeType プロパティを使用して選択します。このプロパティは、ShapeType 列挙体として使用できる各ノードの図形を値として受け取ります。定義済みの図形に目的の図形がない場合は、 Geometry プロパティでカスタム図形を設定できます。
接続ポイントとは、ダイアグラム接続を開始 / 終了できるノードのポイントです。ノードの接続ポイントは、名前と座標により指定されます。
名前 - 接続の DiagramConnection.StartNodeConnectionPointName / DiagramConnection.EndNodeConnectionPointName プロパティを介して接続の接続ポイントを明示的に指定する場合に使用されます。このため、ノードの接続ポイントの名前は、すべて一意であることが必要です。
座標 - ノードの長方形に対応しています。座標の範囲は 0,0 (左上) から 1,1 (右下) までです。
各接続ポイントは、 Name プロパティと Position プロパティを公開する DiagramConnectionPoint オブジェクトによって表されます。
DiagramNode.ShapeType プロパティにより設定された定義済みの図形タイプを使用する場合、ノードの ConnectionPoints コレクションで、ノード タイプに応じていくつかのポイントが事前設定されます。カスタム ノードの図形では、デフォルトで接続ポイントが追加されません。