WinRadialMenu のイベント

トピックの概要

目的

このトピックでは、 WinRadialMenu ™ コンポーネントの一般的なイベントの概要を提供します。

イベントの概要

イベント名説明キャンセル可能

ToolClick

ツールがクリックされたときに、このイベントが発生します。

いいえ

ToolColorChanged

このイベントは以下の操作を実行したときに発生します。

カラー選択がユーザーインターフェイス (UI) から変更された場合 (フォントツールがドキュメントのスタイル設定のカラーツールを公開など)。カラーの選択により、このイベントが発生します。

以下のコードを実行して、カラープロパティがコードビハインドから変更された場合。

C# の場合:

var cTool = (RadialMenuColorTool)ultraRadialMenu1.CenterTool.Tools["Color"].Tools["Fill"];
if (cTool != null)  cTool.Color = Color.BlueViolet;

ColorWell ツールの選択が変更された場合。

Note	注: 各 `ColorWell` ツールには `ColorWell` の子コレクションが含まれ、カラーの変更が連鎖的に伝達されます。たとえば、子の `ColorWell` ツールの選択が変更された場合、親の `ColorWell` ツールのカラーが変更されます。

以下のスクリーンショットのステップで、より分かりやすく示しています。

親の ColorWell ツールの青のカラーツールは複数段階の網掛けで構成され、ColorWell ツールの子コレクションにドリルダウンします。

ColorWell ツールの子コレクションで異なる網掛けの青が選択されると、この選択 (下図) により選択したツールでイベントが発生し、ツールの親へと連鎖的に伝達されます。

選択が(上図) 子の ColorWellで行われた後、親メニューに戻り、親メニューで変更されたカラーが表示されます。

いいえ

ToolCheckedChanging

ユーザーインターフェイス (UI) からチェック可能なツールの「チェック」と「チェック解除」の状態を切り替えると、このイベントが発生します。ツールの Checkable プロパティで無効 (false) を設定し、このイベントが発生しないようにします。

以下のように、コードビハインドでツールの Checked プロパティを変更した場合も、このイベントが発生します。

C# の場合:

RadialMenuTool tool = ultraRadialMenu1.CenterTool.Tools["Copy"];
if (tool != null)  tool.Checked = true;

はい

ToolCheckedChanged

変更をコミットするために UI から ToolCheckedChanging イベントを実行すると、チェック可能なツールでこのイベントが発生します。

ToolCheckedChanging イベントがキャンセルされた場合、このイベントは発生しません。

いいえ

ListToolSelectedValueChanged

ListTool で項目を選択すると、このイベントが発生します。

項目はドロップダウンリストやキーボードの上下の矢印キーから選択でき、各項目を選択するとイベントが発生します。項目選択後に [Enter] キーを押し、選択内容をコミットします。

このイベントは、コード内で項目が変更された場合にも発生します。たとえば、以下のコードで選択項目を設定して 2 番目のパラメーター (true) を使用すると、イベントが実行されます。

C# の場合:

var listTool = (RadialMenuListTool)ultraRadialMenu1.CenterTool.Tools["List"];
if (listTool != null)  listTool.SetSelectedValue("Item2", true);

いいえ

ListToolSelectedValueCommitted

このイベントは、 ListToolSelectedValueChanged イベントの実行後に発生します。

この順番でイベントが発生する理由は、項目選択時に、ドロップダウンで 1 つの項目をクリックするよりも、キーボードの矢印キーを使用した場合、項目が選択されるまでに何度も矢印キーが使用されるためです。項目変更のたびに、 ListToolSelectedValueChanged イベントが実行されます。項目選択後に [Enter] キーを押した場合にも、発生します。

いいえ

DrillDownButtonClick

ツールのドリルダウンボタンをクリックすると、このイベントが発生します。

いいえ

CenterButtonClick

RadialMenuの中央ボタンをクリックすると、このイベントが発生します。

以下の操作により、このイベントの実行が発生します。

1.メインメニューの中央ボタンは、以下の 2 つの機能を実行します。展開と縮小