syncfusion-maui-toolkit-pyramid-charts

.NET MAUI ピラミッドチャートの実装

階層化されたセグメントで全体に占める割合を視覚化する Syncfusion .NET MAUI ピラミッドチャート（SfPyramidChart）の実装方法を説明します。高品質な .NET MAUI アプリケーションで、部分と全体の関係を表示するのに最適です。軸を持たない単一系列のチャートで、データは各部分の合計が全体と等しくなる割合として表されます。

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

ユーザーが次のことを必要としている場合に、このスキルを使用します。

• ピラミッドチャートを作成する：.NET MAUI アプリケーションで階層データや割合データを視覚化する
• 部分と全体の関係を表示する：セグメントで全体に占める割合を表す
• ファネル形式の視覚化を実装する：販売段階、プロセスフロー、または人口統計の内訳を表示する
• インタラクティブ機能を追加する：ピラミッドチャートにツールチップ、凡例、データラベルを追加する
• 外観をカスタマイズする：パレット、グラデーション、セグメント間隔を設定する
• チャートの視覚化をエクスポートする：レポートやドキュメント用に画像（JPEG/PNG）またはストリームとしてエクスポートする
• データバインディングを設定する：ビューモデルからピラミッドチャートのセグメントにデータをバインドする

コンポーネントの概要

SfPyramidChart コントロールでは、次の機能を利用できます。

• 単一系列の階層データ視覚化
• カスタマイズ可能なインタラクティブなツールチップと凡例
• 豊富なデータラベル配置オプション（Auto、Inner、Center、Outer）
• カスタムパレットブラシとグラデーションのサポート
• 2 つのピラミッドモード：Linear（高さ基準）と Surface（面積基準）
• GapRatio によるセグメント間隔の調整
• 画像形式またはストリームへのエクスポート
• 凡例の操作による系列の表示切り替え
• 凡例が領域を超える場合のスクロール表示

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

はじめに

📄 参照： references/getting-started.md

ユーザーが次のことを必要としている場合：

• Syncfusion.Maui.Toolkit NuGet パッケージをインストールする
• XAML または C# で SfPyramidChart を初期化する
• ビューモデルを作成して、チャートにデータをバインドする
• ItemsSource、XBindingPath、YBindingPath を設定する
• 基本的なピラミッドチャートの設定と名前空間のインポートを理解する
• データバインディングを使用した、動作する完全な例を確認する

データラベル

📄 参照： references/data-labels.md

ユーザーが次のことを必要としている場合：

• ピラミッドセグメントにデータラベルを有効にして表示する
• PyramidDataLabelSettings を設定してラベルをカスタマイズする
• ラベルの配置（Auto、Inner、Center、Outer）を制御する
• ラベルのコンテキストを設定して、X 値または Y 値を表示する
• フォント、色、背景、枠線、角の半径を設定してラベルをスタイルする
• 系列のパレットカラーをラベルの背景に使用する
• 余白を適用してラベルの外観をカスタマイズする

凡例

📄 参照： references/legend.md

ユーザーが次のことを必要としている場合：

• ChartLegend を追加、設定してセグメント情報を表示する
• 凡例ラベルのスタイル（フォント、色、サイズ、属性）をカスタマイズする
• 凡例アイコンの種類を設定して、アイコンの外観をカスタマイズする
• 凡例の位置（Top、Bottom、Left、Right）を指定する
• オフセット位置を指定して凡例をフローティング表示する
• 凡例のタップで系列の表示を切り替える
• ItemsLayout で凡例のレイアウトをカスタマイズする
• カスタムの凡例項目テンプレートを使用する
• LegendItemCreated イベントを処理する
• 凡例ビューの最大サイズ要求をオーバーライドする

ツールチップ

📄 参照： references/tooltip.md

ユーザーが次のことを必要としている場合：

• ホバー時にセグメント情報を表示するツールチップを有効にする
• ChartTooltipBehavior を設定してツールチップをカスタマイズする
• 背景、フォント、色、余白を設定してツールチップの外観をスタイルする
• ツールチップの表示時間を制御する
• 高度な UI 向けにカスタムツールチップテンプレートを作成する
• ツールチップの内容を項目データのプロパティにバインドする

外観とカスタマイズ

📄 参照： references/appearance-customization.md

ユーザーが次のことを行う必要がある場合：

• ピラミッドのセグメントにカスタムパレットブラシを適用する
• グラデーション塗りつぶし（LinearGradientBrush、RadialGradientBrush）を使用する
• ピラミッドの Linear モードと Surface モードを切り替える
• モードの違い（高さベースと面積ベース）を理解する
• GapRatio プロパティでセグメント間隔を制御する
• ビジュアルスタイル設定のベストプラクティスを実装する
• セグメントに高度なグラデーション効果を作成する

エクスポート

📄 参照： references/exporting.md

ユーザーが次のことを行う必要がある場合：

• ピラミッドチャートを画像（JPEG または PNG）としてエクスポートする
• ファイルのエクスポートに SaveAsImage メソッドを使用する
• プラットフォーム固有の保存場所を理解する
• Android および Windows Phone でファイル書き込み権限を設定する
• iOS の写真アルバムへのアクセス権限を設定する
• GetStreamAsync を使用してチャートをストリームとしてエクスポートする
• チャートストリームを PDF、Excel、または Word コンポーネントと統合する
• ImageFileFormat のオプションを扱う