syncfusion-maui-radial-menu

.NET MAUI でのラジアルメニューの実装

Syncfusion .NET MAUI Radial Menu（SfRadialMenu）は、タッチ対応デバイスに最適化された円形レイアウトで、階層型メニューを表示します。通常はコンテキストメニューとして使用され、従来のメニューよりも同じスペースに多くのメニュー項目を表示できます。

このスキルを使用する場面

次のことが必要な場合に、このスキルを使用してください。

• .NET MAUI アプリケーションに円形／ラジアルメニューを実装する
• 階層ナビゲーションを備えたタッチ操作に最適化されたコンテキストメニューを作成する
• 画面上をドラッグして移動できるフローティングメニューを構築する
• 複数レベルの項目で構成されるネストされたメニューシステムを設計する
• テキスト、アイコン、カスタムビューを使って中央ボタンをカスタマイズする
• カスタムの位置やインデックスを指定してメニューのレイアウトを分割する
• 画像、アイコン、カスタムコンテンツを含むインタラクティブなメニュー項目を追加する
• ナビゲーション、開閉、項目のタップに関するメニューイベントを処理する
• リキッドガラス／アクリルスタイルなどのモダンな UI 効果を実装する

コンポーネントの概要

主な機能：

• 階層ナビゲーション： ネストされたメニュー項目を複数のレベルで表示
• タッチ操作に最適化： タッチ操作向けに設計された円形レイアウト
• ドラッグ可能： コンテンツ上に浮かび、画面上の任意の場所へドラッグ可能
• 回転のサポート： 項目を中央の周りで回転可能
• カスタム分割： 項目の配置と間隔を制御
• フォントアイコン： ベクターアイコンを標準でサポート
• カスタムビュー： 任意の MAUI ビューをメニュー項目のコンテンツとして使用可能
• 豊富なカスタマイズ： 色、サイズ、フォント、背景などを設定可能
• イベント駆動型： すべての操作に対応する包括的なイベントシステム

ドキュメントとナビゲーションガイド

はじめに

📄 参照： references/getting-started.md

• NuGet パッケージのインストール（Syncfusion.Maui.RadialMenu）
• MauiProgram.cs でのハンドラーの登録
• 基本的な SfRadialMenu の設定
• 項目を含む最初のラジアルメニューの作成
• XAML と C# の実装例

項目の追加

📄 参照： references/populating-items.md

• RadialMenuItem コレクションを使った項目の追加
• テキストのみの項目、テキスト付き画像、カスタムフォントアイコン
• ネストされた階層型メニュー構造の作成
• データバインディングにおける ItemsSource と ItemTemplate の使用
• アニメーション時間、リムのスタイル、区切り線
• プロパティのバインディングにおける DisplayMemberPath

中央ボタンのカスタマイズ

📄 参照： references/center-button-customization.md

• 中央ボタンのテキストと戻るボタンのテキスト
• 色（テキスト、背景、ストローク）
• サイズと半径のカスタマイズ
• フォントファミリー、サイズ、属性
• 中央ボタンのカスタムビュー
• アニメーションと自動スケーリング
• 開始角度の設定

メニュー項目のカスタマイズ

📄 参照： references/menu-item-customization.md

• SfRadialMenuItem のプロパティ
• テキスト、画像、フォントアイコン
• フォントのカスタマイズ（ファミリー、サイズ、属性）
• 色（背景、テキスト）
• サイズ（ItemHeight、ItemWidth）
• メニュー項目のカスタムビュー
• コマンドバインディング
• 有効／無効状態

レイアウトと分割

📄 参照： references/layout-segmentation.md

• デフォルトのレイアウト（順次配置）
• カスタムレイアウト（インデックスによる配置）
• VisibleSegmentsCount プロパティ
• 正確な配置を指定する SegmentIndex
• 各種レイアウトのユースケース

ドラッグと回転

📄 参照： references/dragging-rotation.md

• ドラッグ機能の有効化（IsDragEnabled）
• 回転の制御（EnableRotation）
• ドラッグイベント（DragBegin）
• ドラッグ動作の制限
• 親レイアウト上でのメニューの配置

イベント

📄 参照： references/events.md

• ナビゲーションイベント（Navigating、Navigated）
• 開閉イベント
• 中央ボタンのイベント（CenterButtonBackTapped）
• 項目操作のイベント（ItemTapped、TouchDown、TouchUP）
• イベント引数とキャンセル