DataPresenterBase.SelectedItemHolder クラス

DataPresenterBase の選択された Records、Fields および Cells を保持するために使用されるオブジェクト

シンタックス

Visual Basic

'宣言
 
Public Class DataPresenterBase.SelectedItemHolder 
   Inherits Infragistics.PropertyChangeNotifier

C#

public class DataPresenterBase.SelectedItemHolder : Infragistics.PropertyChangeNotifier 

解説

Record、Cell、および Field の 3 つの項目タイプを選択できます。この機能は、以下のプロパティで制御されます。

• Record 選択が FieldLayoutSettings.FieldLayoutSettings.SelectionTypeRecord で有効になり、SelectedItems.Records コレクションで公開されます。
• Cell 選択が FieldLayoutSettings.FieldLayoutSettings.SelectionTypeCell で有効になり、SelectedItems.Cells コレクションで公開されます。
• Field 選択が FieldLayoutSettings.FieldSettings.LabelClickAction で有効になり、SelectedItems.Fields コレクションで公開されます。

SelectedItems オブジェクトは、特定の項目の選択/選択解除に使用できる 3 コレクション (Records、Cells、および Fields) を公開します。更に、選択は Record の Record.IsSelected、Cell の Cell.IsSelected、および Field の Field.IsSelected プロパティの設定によって影響されます。

以下は、さまざまなシナリオの選択動作について説明します。

• ユーザーがマウスまたはキーボード操作でレコード、セル、またはフィールを選択した場合、SelectedItemsChanging イベントが発生します。キャンセルされた場合、適切な SelectedItems コレクションが更新され、SelectedItemsChangingSelectedItemsChangedイベントが発生します。
• IsSelected プロパティのいづれかがコードで変更された場合や SelectedItems コレクションで追加または削除された場合も動作は同じで SelectedItemsChanging および SelectedItemsChanged イベントが発生します。
• ユーザーがセルで編集モードに入って選択されたコレクションすべてをクリアすると、同じSelectedItemsChanging and SelectedItemsChanged
• レコードが削除された (データソースで変更された、またはユーザーが削除キーを押した) 場合、SelectedItemsRecords および Cells コレクションは適宜更新されますが、SelectedItemsChanging イベントは発生しません。ただし、SelectedItemsChanged イベントは発生します。注: データ ソースでレコードの削除をサポートし、FieldLayoutSettings.FieldLayoutSettings.AllowDelete プロパティが False に設定されていない場合、削除キーを押すと RecordsDeleting イベントが発生します。キャンセルしない場合、デフォルトで選択したレコードをすべて選択するかどうかの確認メッセージがユーザーに表示されます。
• レコード フィルターがアクティブな場合 (FieldSettings.FieldSettings.AllowRecordFiltering が 1 つ以上のフィールドで True に設定されている場合など)、選択動作は以下になります。
  • フィルター レコードが表示されている場合 (FieldLayoutSettings.FieldLayoutSettings.FilterUIType が FilterRecord に設定されているかデフォルトのままの場合など)、フィルター セルに入った場合と他のセルに入った場合に同じ動作になります。既存の選択のクリアやイベントを発生します。
  • フィルターがフィールドラベル内のドロップダウンで公開される場合 (FieldLayoutSettings.FieldLayoutSettings.FilterUIType が LabelIcons に設定される場合)、フィルター条件を変更しても既存の選択は変更されません。たとえば、5 レコードを選択してフィルターすると、元々選択されていた 5 つのレコードでフィルターを実行します。データ ソースでレコードの削除をサポートし、FieldLayoutSettings.FieldLayoutSettings.AllowDelete プロパティが False に設定されていない場合に削除キーを押すと、選択されている 5 つのレコードの削除について確認メッセージがユーザーに表示されます。この動作は RecordsDeleting イベントをキャンセルするかコードでレコードのフィルター済みのみを削除します。

注：Record および Cell 選択は相互排他的です。Record を 1 つまたは複数選択すると、Cell 選択が自動的にクリアされ、その逆も同じ結果になります。