列の選択ダイアログ ウィンドウ

このコントロールは廃止されたため、XamDataGrid コントロールに移行することをお勧めします。今後、新機能、バグ修正、サポートは提供されません。コードベースの XamDataGrid への移行に関する質問は、サポートまでお問い合わせください。

列の選択ダイアログ ウィンドウは、特定の ColumnLayout の列コレクションを表示します。ColumnLayout オブジェクトを含む、すべての ColumnBase オブジェクトをそのコレクションに表示します。また、各列のとなりにチェックボックスを表示します。その特定の列が非表示の場合、このチェックボックスは選択が解除されます。エンドユーザーは、対応するチェックボックスを選択することで列の可視性を切り替えることができます。

列の選択ダイアログ ウィンドウが最初に表示されるとき、xamGrid コントロールに対してセンタリングされます。エンドユーザーが列の選択ダイアログ ウィンドウをブラウザー ウィンドウの外にドラッグした場合、マウスをリリースすると、列の選択ダイアログ ウィンドウは、ダイアログが消えないように xamGrid コントロールに対して再度センタリングされます。

列の選択ダイアログ ウィンドウは、xamGrid コントロール内の列順序に基づいて列ヘッダーを構成します。ただし、エンドユーザーが、列の選択ダイアログ ウィンドウ内で、チェックボックスの左に表示されているアイコンを使用して列をドラッグ アンドドロップすると、列ヘッダーの順序を変更できます。エンドユーザーが列の選択ダイアログ ウィンドウ内で列を並べ替えると、xamGrid コントロール内でも並べ替えられます。

列の選択ダイアログ ウィンドウの列に表示されるテキストは、ColumnBase オブジェクトの DisplayName プロパティからきています。これは、読み取り専用プロパティで、最初に HeaderText プロパティが設定されているかどうかを確認します。設定されていれば、その値を使用します。そうでない場合は、ColumnKey プロパティの値を使用します。

また、列の選択ダイアログ ウィンドウのチェックボックスを無効にして、エンドユーザーが特定の列を非表示にできないようにすることが可能です。詳細については、「列が非表示にされることを防止する」を参照してください。

次のスクリーンショットは、列の選択ダイアログ ウィンドウを示しています。