[]
        
(Showing Draft Content)

Wijmo_Grid_Selector.Selector

Selector クラス

行とグループの選択または選択解除に使用できるチェックボックスを追加して、FlexGridおよびColumnを変更するクラス。

FlexGridには、ユーザーがマウスまたはキーボードを使用して複数の行または行範囲を選択できるFlexGrid.selectionModeプロパティがあります。

ただし、チェックボックス付きの列を追加して、この機能を提供する場合もあります。 これにより、ユーザーはモバイルデバイスで行を簡単に選択でき、デスクトップシステムでもより直感的なインターフェイスを提供できます。

Selectorクラスを使用すると、Selectorクラスのインスタンスを作成し、そのcolumnプロパティをチェックボックスを表示する列に設定することで行うことができます。たとえば、

// SelectorColumnを追加します。
let selector = new SelectorColumn(theGrid, {
    itemChecked: () => showCheckedCount()
});

これにより、最初の行の列ヘッダのセルにチェックボックスが追加されます。 チェックボックスは各行のRow.isSelectedプロパティにバインドされたため、チェックボックスを切り替えると行の選択状態が切り替えます。

デフォルトでは、Selectorは一番上のヘッダセルと行グループのセルにもチェックボックスを追加します。 これらのセルを使用して、グリッドおよび各グループのすべての行を選択または選択解除できます。

showCheckAllプロパティを使用して、一番上のヘッダセルのチェックボックスをオフにすることができます。

Selectorは、ヘッダ以外の列にも追加できます。 たとえば、

// SelectorColumnを最初の行のデータ列に追加します。
let selector = new SelectorColumn(theGrid.columns[0], {
    itemChecked: () => showCheckedCount()
});

上記の場合、Selectorは、元のデータ内容を保持する通常のグリッドセルに選択チェックボックスを追加します。

メモSelectorFlexGridにアタッチすると、選択モードであるため、グリッドのFlexGrid.selectionModeプロパティが自動的にSelectionMode.Cellに設定されます。選択モードは、Selectorによって提供される選択のタイプのためです。 (SelectionMode.ListBoxモードでは、グリッドがセレクターの動作を妨害します。)

階層

コンストラクタ

constructor

  • Selectorクラスの新しいインスタンスを初期化します。

    引数

    • オプション column: Column | FlexGrid

      このSelectorがカスタマイズする必要があるColumn、または最初の列がカスタマイズされるFlexGridへの参照。

    • オプション options: any

      オブジェクトの初期化データを含むオブジェクト。

    戻り値 Selector

プロパティ

ariaLabel

ariaLabel: string

セレクタの ARIA ラベル プロパティを取得または設定します。

このプロパティのデフォルト値は''です。

column

column: Column | null

このSelectorによって使用されるColumnを取得または設定します。

showCheckAll

showCheckAll: boolean

列ヘッダーに「すべてオン」項目チェックボックスを表示するかどうかを決定する値を取得または設定します。

このプロパティのデフォルト値は true

メソッド

onColumnChanged

onColumnChanging

  • columnChanging イベントを発生させます。

    引数

    戻り値 boolean

    イベントがキャンセルされなかった場合は True です。

onItemChecked

  • itemChecked イベントを発生させます。

    引数

    戻り値 void

イベント

columnChanged

columnChanged: Event<Selector, EventArgs>

column プロパティの値が変化する後に発生します。

columnChanging

columnChanging: Event<Selector, CancelEventArgs>

column プロパティの値が変化する前に発生します。

itemChecked

itemChecked: Event<Selector, EventArgs>

ユーザーがこの列の項目をチェックするときに発生します。