Warnung
このドキュメントはアーカイブされており、コンポーネントは現在のバージョンの Windows Community Toolkit では使用できません。
このコンポーネントを直接 8.x に移植する予定はありませんが、次の点を理解しておくことが重要です。
- WCT 7.x DataGrid は、既存のプロジェクトの WCT 8.x コンポーネントと共に引き続き使用できます。
- DataGrid コントロールは、代替手段を優先して非推奨になりました。
新しい開発では、強化された機能を提供し、アクティブに維持される DataTable または WinUI.TableView コンポーネントを使用することをお勧めします。
DataTable が満たしていない特定のニーズがある場合は、コンポーネントの改善がプロトタイプ化され、インキュベーションされる WCT Labs への貢献を検討してください。
詳細については、以下を参照してください。
- ラボでの DataTable ディスカッション
- Community Toolkit GitHub リポジトリ
- ドキュメントのフィードバックと提案
- WinUI.TableView コミュニティ プロジェクト
元のドキュメントを次に示します。
DataGrid コントロールを使用すると、行と列にデータのコレクションを柔軟に表示できます。
注
DataGrid コントロールは、Windows Community Toolkit バージョン 8.0 以降で使用できる WinUI 3 コントロールの一部ではありません。 このコントロールは、Windows Community Toolkit バージョン 7.1.0 の UWP アプリと Uno Platform アプリで使用できます。
組み込みの列の種類には、カスタム コンテンツをホストするためのテキスト列、チェック ボックス列、コンボ ボックス列、テンプレート列が含まれます。 組み込みの行の種類には、セル値の下に追加のコンテンツを表示するために使用できるドロップダウン詳細セクションが含まれています。
DataGrid コントロールは、行の背景と前景を交互に表示したり、ヘッダー、グリッド線、スクロール バーを表示または非表示にしたりする機能など、一般的なテーブルの書式設定オプションをサポートしています。 さらに、コントロールには、コントロールとその行、列、セル、行または列のヘッダーの外観を完全に変更するために使用できる、いくつかのスタイルとテンプレートのプロパティが用意されています。
DataGrid には、ナレーターとタッチ ナレーターのサポートが組み込まれており、視覚障磊のあるユーザーがコントロールを簡単に操作して操作できるようにします。 さらに、コントロールには、セル、ヘッダー、行、列を介した広範なキーボード ナビゲーションのサポートが組み込まれています。
ハウツー
次のガイダンス セクションでは、DataGrid コントロール機能をアプリケーションに組み込む際に使用できる追加の概念と手法について説明します。
- DataGrid コントロールをページに追加する
- スタイル設定と書式設定オプションを使用して DataGrid コントロールをカスタマイズする
- DataGrid コントロールのサイズ変更オプション
- 既定のキーボード ナビゲーションと選択パターン
- 行の詳細の表示と構成
- DataGrid コントロールで自動生成された列を構成する
- LINQ と DataGrid コントロールを使用してデータをグループ化、並べ替え、フィルター処理する
- DataGrid コントロールの編集と入力の検証
サンプル プロジェクト
DataGrid のサンプル ソース コードを次に示します。
WinUI 2 ギャラリー アプリがインストールされている場合は、アプリを使用して DataGrid の動作を確認できます。
Windows Community Toolkit ギャラリー アプリで使用できる他のコントロールを確認するか、ブラウザーのギャラリー アプリで試してみてください。
Requirements
| デバイス ファミリ | ユニバーサル、10.0.16299.0 以降 |
|---|---|
| Namespace | Microsoft.Toolkit.Uwp.UI.Controls |
| NuGet パッケージ | Microsoft.Toolkit.Uwp.UI.Controls.DataGrid |
API
.NET Community Toolkit