このトピックでは、 xamDiagram™ コントロールでダイアグラムの複数の項目の選択を有効または無効にする方法、およびプログラムによって選択を実行する方法を説明します。
このトピックをより理解するために、以下のトピックを参照することをお勧めします。
このトピックは、以下のセクションで構成されます。
xamDiagram コントロールでは、ダイアグラム領域にあるダイアグラムの項目をプログラムによって選択できるようにする機能が提供されています。使用できる選択機能には、「Single」、「Multiple」、「None」があり、いずれもプロパティの設定で構成できます。デフォルトでは、ダイアグラムの複数の項目の選択が有効になっています。
ダイアグラム項目を選択するには、マウスの左ボタンをクリックする、またはすべての目的の項目が破線で縁取りした [選択] ツールの境界線内に収まるまで、ダイアグラム上でマウスを移動させながらマウスの左ボタンを押し続け、[選択] ツールを描画します。(詳細は、 ダイアグラムの項目のインタラクションと操作性を参照してください。)
ダイアグラム コントロールのコンテキストでダイアグラムの項目を選択することは、項目のレンダリングや構成の際に、項目や項目のグループを強調表示する (項目を破線で縁取りした四角形で囲む) 上で役立ちます。これは、オプション ペインを使用、またはコードを使用して実行できます。xamDiagram コントロールの SelectionMode プロパティで使用する特定のタイプの選択を設定し、ダイアグラムの項目選択の動作を構成します。プロパティのデフォルト設定は、複数要素の選択です (SelectionMode = "Multiple")。
ダイアグラムの項目の選択状態は、ユーザー インタラクションによる選択機能とは別に実装されるプロパティの設定 (DiagramItem.IsSelected) を使用してプログラムにより変更できます。
ダイアグラム項目の選択は、 SelectedItems コレクションを事前設定し、このコレクションを変更するたびに、 SelectionChanged イベントを発生させメンバーに対してカスタム ロジックを適用できるようにします。たとえば、プログラムによるダイアグラムの項目の追加や削除などの操作ができます。データ バインディングの場合、 SelectedDataItems コレクションは SelectedItems と同期され、選択したダイアグラム項目に対応するデータ項目を含みます。
以下の表は、ダイアグラムの項目選択の構成可能な要素を簡単に説明し、それらを構成するプロパティにマップします。
ダイアグラムのスペースで選択できるダイアグラム項目の数を指定するには、コントロールの選択モードを構成します。デフォルト設定では、ダイアグラムで複数のダイアグラム項目が選択できるようになっています。項目数を 1 つに制限するには、SelectionMode プロパティの値を 「Single」 に設定します。または、 「None」 に設定すると選択できなくなります。
以下の表では、 SelectionMode プロパティの設定に対する xamDiagram コントロールのユーザー インタラクション機能を簡単に説明します。
以下の表は、任意の構成とそれを管理するプロパティ設定のマップを示します。
xamDiagram コントロールでは、プログラムによる項目の選択、および選択の解除ができます。IsSelected プロパティの値で選択状態を構成し、項目を選択または選択解除します。
以下の表は、任意の構成とそれを管理するプロパティ設定のマップを示します。
以下のスクリーンショットは、以下の設定の結果のノードの選択状態の構成を示しています。
以下のコードはこの例を実装します。
XAML の場合:
<ig:XamDiagram x:Name="diagram"
Width="300"
Height="250"
Background="#F9F9F9">
<ig:DiagramNode x:Name="node0"
Position="5,125"
IsSelected=”True”/>
</ig:XamDiagram>このトピックの追加情報については、以下のトピックも合わせてご参照ください。