このトピックでは、 xamDiagram™ コントロールが提供するコンテキスト メニューを使用する方法を説明します。
このトピックをより理解するために、以下のトピックを参照することをお勧めします。
xamDiagram コントロールのダイアグラムの項目は、コントロールのコンテキスト メニューの機能を使用して構成できます。コンテキスト メニューはオプション ペインで表示することができます。ダイアグラムの項目 (複数可) を選択すると表示されるギア アイコンをクリックすると、オプション ペインが表示されます。デフォルトでは、コンテキスト メニューはダイアグラムで無効になっています。
オプション ペインの配置は、選択された項目 (複数可) と対応させて構成することができます。これにより、左利きのユーザーと右利きのユーザーのどちらにも、ダイアグラム項目の構成で最高のユーザー エクスペリエンスを提供できます。ダイアグラムでは、利き手に関するシステム設定を読み込む定義済み機能が提供されます。これによって、ユーザーにとって最も便利な場所にメニューが表示されます。「利き手」の設定とは、右左のどちらの手を使用して文字を書くかに応じて、メニューを表示させる位置を指定します。左利きの場合はメニューが右側に表示され、右利きの場合はメニューが左側に表示されます。利き手の設定は、「Tablet PC 設定」メニューからアクセスできます。詳細は、MSDN の利き手に関する記事を参照してください。デフォルトでは、オプション ペインは項目の右側に表示されます。
オプション ペインは、 ShowOptionsPane コマンドおよび CloseOptionsPane コマンドを使用したプログラムによる操作でも、開いたり閉じたりできます。( xamDiagram で使用するコマンドの詳細は、 コマンドを使用した UI 要素の構成を参照してください。)
塗りつぶし、サイズ、フォント ファミリなどダイアグラムの項目のさまざまなプロパティは、オプション ペインを使用して構成できます。これらのプロパティは、適用できるオブジェクトのタイプに基づき 図形 、 パス 、 線 など関連するセクションに論理的にグループ化されます。コピー / 貼り付け操作 (コピー、貼り付け、削除など) のコマンドも、UI とのインタラクションによって呼び出すことができます。これらのオプションは、 全般 タブに配置されます。(構成可能な要素および操作の詳細は、オプション ペインでのダイアグラム項目の構成可能な要素を参照してください。)
ダイアグラムのオプション ペインは、ダイアグラムの外側に配置することもできます。この場合、 DiagramOptionsPane インスタンスは、 DiagramOptionsPane.Diagram プロパティにダイアグラムを値として指定して、オプション ペインが属するダイアグラムを示す必要があります。
オプション ペインの外観は、コントロールのテンプレートをオーバーライドすることでカスタマイズできます。コンテキスト メニューの (オプション ペインとは異なる) 別の実装を作成するために、 xamDiagram は DiagramOptionsPaneDataContext クラスを公開します。
以下の表は、ダイアグラムのコンテキスト メニューに関連して構成可能な項目を簡単に説明し、それらを構成するプロパティにマップします。
オプション ペインの可視性 (オプション ペインを表示する機能) は、プロパティ設定によって制御されます。マウスのクリックでオプション ペインを表示するギア アイコン (
) を可視化するかどうかを指定できます。
以下の表は、任意の構成とそれを管理するプロパティ設定のマップを示します。
以下のスクリーンショットは、以下の設定の結果、オプション ペインの構成がどのように表示されるかを示します。
以下のコードはこの例を実装します。
XAML の場合:
<ig:XamDiagram x:Name="diagram"
Width="300"
Height="250"
Background="#F9F9F9"
OptionsPaneVisibility=”Visible”>
<ig:DiagramNode Position="5,125"/>
</ig:XamDiagram>xamDiagram コントロールは、選択された項目 (複数可) に対応し、オプション ペインの配置を指定する機能を提供します。
以下の表は、任意の構成とそれを管理するプロパティ設定のマップを示します。
以下のスクリーンショットは、以下の設定の結果のオプション ペインの配置を示します。
以下のコードはこの例を実装します。
XAML の場合:
<ig:XamDiagram x:Name="diagram"
Width="330"
Height="300"
Background="#F9F9F9"
OptionsPaneVisibility=”Visible”
OptionsPanePlacement="Left">
<ig:DiagramNode Position="200,100"/>
</ig:XamDiagram>オプション ペインを使用して呼び出すことができるコピー / 貼り付け操作は、ノード、接続またはその組み合わせの構成にタブを使用するかどうかにかかわらず、最初の「 全般 」タブに表示されます。ボタンには、各ボタンで制御される操作が記述されています。
以下の表は、オプション ペインで使用できるダイアグラム ノードの構成可能なオプションを示します。
以下の表は、オプション ペインで使用できるダイアグラム接続の構成可能なオプションを示しています。
コンテキスト メニューは、ダイアグラムのノードおよび接続のプロパティの構成に使用します。そのため、ノードと接続の両方を含むダイアグラムで選択されると、オプション ペインにはダイアグラムの項目に共通するプロパティのみが表示されます。
以下の表は、オプション ペインで使用できるダイアグラム項目が混在した選択の構成可能なオプションを示します。
このトピックの追加情報については、以下のトピックも合わせてご参照ください。
以下に、このトピックに関連する追加情報を示します (Infragistics® のコンテンツ ファミリー以外にも使用できます)。
