syncfusion-winforms-xptaskpane

Syncfusion XPTaskPane の実装

XPTaskPane コンポーネントは、複数のタスクページをホストし、ナビゲーション機能とデザイン時のサポートを備えた、Microsoft Office XP に着想を得たコンテナーコントロールです。ドロップダウンメニューやナビゲーションボタンでページを切り替えられる、プロフェッショナルな外観の複数ページレイアウトが必要な場合に使用します。

XPTaskPane を使用する場面

次のような場合は XPTaskPane を使用します。

• Office XP UI に着想を得た複数ページレイアウトを作成する
• 複数のコンテンツパネル間を移動できるようにする
• ドロップダウンメニューや矢印ボタンでページを切り替えられるようにする
• 折りたたみ可能なタスクペインのインターフェイスを構築する
• 関連する機能を個別のページに整理する
• ページのドラッグ＆ドロップによるデザイン時のサポートを提供する

コンポーネントの概要

XPTaskPane は次の要素で構成されます。

• XPTaskPane - メインのコンテナーコントロール
• WizardContainer - ページコンテナー（自動的に追加されます）
• XPTaskPage - ペインに表示される個々のページ
• Header - ボタン、メニュー、閉じるアイコンを備えたナビゲーションツールバー

XPTaskPane (main control)
├── HeaderLeftToolbar (previous/next buttons)
├── HeaderRightToolbar (menu dropdown + close button)
└── TaskPanePageContainer (WizardContainer)
    ├── XPTaskPage 1
    ├── XPTaskPage 2
    └── XPTaskPage N

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

はじめに

📄 参照: references/getting-started.md

• アセンブリの依存関係と NuGet のインストール
• フォームデザイナーから XPTaskPane を追加する方法
• コードを使用してプログラムから XPTaskPane を追加する方法
• WizardContainer と XPTaskPage のインスタンスを作成する方法
• 基本的な初期化手順

ページ管理

📄 参照: references/page-management.md

• XPTaskPage のインスタンスを作成して追加する方法
• ページのタイトルとレイアウト名を設定する方法
• タスクページにコントロールを追加する方法
• TaskPages コレクションにアクセスする方法
• SelectedPage プロパティの使用方法

ナビゲーションとヘッダーコントロール

📄 参照: references/navigation-header.md

• ヘッダーツールバーのコンポーネントと項目
• ナビゲーションボタンの表示と機能
• ページ選択用のドロップダウンメニュー
• ヘッダーメニューのカスタマイズ
• 閉じるボタンの設定
• ツールバーボタン用のカスタム画像

ページの並べ替えとナビゲーション

📄 参照: references/page-reordering.md

• デザイン時にページを並べ替える方法
• NextPage プロパティと PreviousPage プロパティ
• 実行時のページ順次移動
• 最前面へ移動および最背面へ移動する操作
• コレクションエディターでのページ順序

外観とスタイル

📄 参照: references/appearance-styling.md

• ビジュアルスタイル（OfficeXP と Office2007）
• フォントと前景色のカスタマイズ
• 境界線のスタイルとプロパティ
• ヘッダーラベルのスタイル設定
• ページ単位の外観設定
• カスタムカラーとカラースキーム

コンテンツのスクロール

📄 参照: references/scrolling-content.md

• ページで垂直スクロールを有効にする方法
• ScrollSpeed プロパティの設定
• マウスホバー時のスクロール動作
• コンテンツのオーバーフロー処理

---

クイックスタートの例

using Syncfusion.Windows.Forms.Tools;

// Step 1: Create XPTaskPane
XPTaskPane xpTaskPane1 = new XPTaskPane();
this.Controls.Add(xpTaskPane1);

// Step 2: Create and add WizardContainer
WizardContainer wizardContainer1 = new WizardContainer();
xpTaskPane1.Controls.Add(wizardContainer1);
xpTaskPane1.TaskPanePageContainer = wizardContainer1;

// Step 3: Create task pages
XPTaskPage page1 = new XPTaskPage();
page1.Title = "Page 1";
wizardContainer1.Controls.Add(page1);

XPTaskPage page2 = new XPTaskPage();
page2.Title = "Page 2";
wizardContainer1.Controls.Add(page2);

// Step 4: Set pages in TaskPages collection
xpTaskPane1.TaskPages = new XPTaskPage[] { page1, page2 };

// Step 5: Add controls to pages
Button btn = new Button() { Text = "Click Me" };
page1.Controls.Add(btn);

よく使われるパターン

パターン 1：デザイナーを使ったセットアップ

1. ツールボックスからフォームに XPTaskPane をドラッグします
2. スマートタグで「ページの追加」をクリックします
3. 各ページをビジュアルにデザインします
4. 基本的なセットアップにコードは必要ありません

パターン 2：実行時のページ作成

• データや条件に応じてページを動的に作成します
• TaskPages プロパティを使ってコレクションを更新します
• 動的なレイアウトに便利です

パターン 3：ページ間のナビゲーション

• NextPage プロパティと PreviousPage プロパティを設定します
• プログラムからページの順序を定義します
• コレクションとは独立して順序を制御します

パターン 4：カスタムスタイル

• VisualStyle を Office2007 または OfficeXP に設定します
• Font と ForeColor を全体的にカスタマイズします
• 個々のページの外観を上書きします

主なプロパティの概要

プロパティ	型	目的
TaskPages	XPTaskPage[]	すべてのタスクページの配列
SelectedPage	XPTaskPage	現在アクティブなページ
TaskPanePageContainer	Control	ページ用のコンテナー（WizardContainer）
VisualStyle	VisualStyle	Office のテーマ（OfficeXP または Office2007）
ScrollSpeed	int	ページコンテンツのスクロール速度
VerticalScroll	bool	垂直スクロールを有効にする
Font	Font	タスクペイン全体のフォント
ForeColor	Color	テキスト全体の色
HeaderLabel	Label	ヘッダーテキストのコントロール
HeaderLeftToolbar	ToolBar	前へ／次へ移動するボタン
HeaderRightToolbar	ToolBar	メニューと閉じるボタン

---

代表的なユースケース

1. マルチステップウィザード - ステップごとに進むワークフローを作成します
2. 設定ダッシュボード - 設定を論理的なセクションに整理します
3. ドキュメントビューアー - 複数のドキュメントセクションを閲覧します
4. 機能エクスプローラー - 関連する機能をページごとにまとめます
5. タスクの整理 - 関連するタスクを折りたたみ可能なページに表示します