セルが現在選択されてない場合、または選択されたセルが現在の画面内にない場合、このプロパティはnullを返します。

セルが現在編集されていない場合、このプロパティはnullを返します。

isReadOnly プロパティがtrueに設定されている場合、 新規行テンプレートは表示されません。

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

isReadOnly プロパティがtrueに設定されている場合、選択されている行は削除されません。

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

autoScroll プロパティがtrueに設定されている場合、ユーザーが行または列を新しい位置に ドラッグするときにグリッドの内容が自動的にスクロールされます。

グリッドでは、列のドラッグがデフォルトで有効になっています。

グリッドが連結モードでは、行をドラッグするには特別な 考慮が必要になります。

グリッドが連結モードでは、行をドラッグするとデータソースとの同期が失われます （たとえば行4は6行として参照されることがあります）。 これを回避するには、draggedRow イベントを処理し、データを新しい行の位置と同期させる必要があります。

また、allowSorting プロパティをfalseに設定する必要があります。 そうしないと、行の順序がデータによって決定され、行をドラッグするのは無意味になります。

次のフィドルでは、連結グリッドでの行のドラッグを実行しています。 Bound Row Dragging.

@link FlexGrid}コントロールに対して、このプロパティのデフォルト値はb>AllowDragging.Columns/b>です。また、PivotGridコントロールに対して、このプロパティのデフォルト値はAllowDragging.Noneです。このプロパティはMultiRowコントロールには適用されません。

このプロパティのデフォルト値は、FlexGridコントロールの場合はAllowMerging.None、またPivotGridコントロールの場合はAllowMerging.Allです。

このプロパティはMultiRowコントロールには適用しません。

ユーザーが固定ボタンを使用することで、グリッドを水平方向にスクロールしても列が表示されたままになるように 列を固定できます。

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

サイズ変更が可能な場合は、列ヘッダーセルの右端をドラッグして列を、 行ヘッダーセルの下端をドラッグして行をサイズ変更できます。

ヘッダーセルの端をダブルクリックして、 行および列をコンテンツに合わせて自動的にサイズ変更することもできます。 自動サイズ変更の動作は、autoSizeMode プロパティを使用してカスタマイズできます。

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

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

FlexGridでは、このプロパティのデフォルト値は1です。 交互の行を無効にするにはゼロに設定します。 または、交互の行の間に複数の通常行を挿入するには、1より大きい数に設定します。 FlexGridコントロールに対して、このプロパティのデフォルト値は1です。 また、PivotGridに対して、このプロパティのデフォルト値は1です。

このプロパティのデフォルト値は false です。これにより、 グリッド上にカーソルが移動され、選択範囲が固定されたままになります。

このプロパティが true に設定されている場合、 グリッド上に選択範囲が移動され、カーソルが固定されたままになります。 本動作はExcelと同じです。

次のクリップボードショートカットがあります。

［Ctrl］+［C］、［Ctrl］+［Ins］

グリッドの選択範囲をクリップボードにコピーします

［Ctrl］+［V］、［Shift］+［Ins］

クリップボードのテキストをグリッドの選択範囲に貼り付けます。

クリップボード操作は、表示されている行および列だけが対象となります。

読み取り専用セルは貼り付け操作の影響を受けません。

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

列の生成は、少なくとも1項目を含む itemsSource プロパティに依存します。 このデータ項目が検査され、列が作成されて、 プリミティブ値（数値、文字列、Boolean、またはDate）を含むプロパティに連結されます。

プロパティをnullに設定すると、適切なタイプを推測する方法がないため、 列は生成されません。このような場合は、 autoGenerateColumns プロパティをfalseに設定し、明示的に列を作成する必要があります。次に例を示します。

import { FlexGrid } from '@mescius/wijmo.grid';
let grid = new FlexGrid('#theGrid', {
  autoGenerateColumns: false, // データ項目にnull値が含まれる場合があります
  columns: [                  // そのため、列を明示的に定義します
    { binding: 'name', header: 'Name', dataType: 'String' },
    { binding: 'amount', header: 'Amount', dataType: 'Number' },
    { binding: 'date', header: 'Date', dataType: 'Date' },
    { binding: 'active', header: 'Active', dataType: 'Boolean' }
  ],
  itemsSource: customers
});

FlexGridコントロールに対して、このプロパティのデフォルト値は trueです。また、 PivotGrid コントロールに対して、このプロパティのデフォルト値は false　です。

このプロパティは、グリッドに内容がワードラップされるように 構成された列が含まれている場合（ Column.wordWrap) を参照）や、グリッドの行数が比較的に少ない場合は特に役立ちます。

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

行と列のドラッグは、allowDragging プロパティによって制御されます。

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

検索が現在選択されている列(編集不可能な場合)で行われます。 検索は現在選択されている行から始まり、大文字と小文字を区別されません。

caseSensitiveSearchプロパティもご参考ください。 このプロパティのデフォルト値は false です。

このプロパティは、ユーザーが列ヘッダの端をダブルクリックしたときの動作を制御します。

デフォルトでは、その列のヘッダセルとデータセルの内容に基づいて 列の幅が自動的に設定されます。 このプロパティを使用すると、 ヘッダのみまたはデータのみに基づいて列の幅を設定するように変更できます。

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

大きなチェックボックスは、ユーザーがセルの任意の場所をクリックして切り替えることができるため、マウスで簡単に切り替えることができます。

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

bottomLeftCells パネルは、行ヘッダの下、columnFooters パネルの左に表示されます。

検索処理には、通常のテキストの検索（autoSearchプロパティを参照）と、データマップされたセルの編集時の項目の検索（Column.dataMapプロパティを参照）が含まれます。

このプロパティのデフォルト値はfalseです。デフォルトでは、検索で大文字と小文字が区別されません。DataMapセルの場合は常に最初に大文字と小文字を区別して検索を実行され、その後caseSensitiveSearchの値に応じた検索が実行されます。

このプロパティには、項目の子項目を含むプロパティの名前を指定する文字列を設定します （たとえば、 childItemsPath = 'items';）。

項目の異なるレベルに異なる名前を持つ子項目がある場合は、 このプロパティに、各レベルの子項目を含むプロパティの名前から成る配列を設定します。 （たとえば、. childItemsPath = ['checks','earnings'];）。

デモ

このプロパティはMultiRowコントロールには適用しません。

このプロパティのデフォルト値は null です。これにより、 グリッドでブラウザに応じて最適な設定が適用されます。

itemsSource プロパティが ICollectionViewに設定されている場合、 このプロパティはその値を返します。

itemsSource プロパティがデータ項目の配列に設定されている場合、 このプロパティは編集およびソートをサポートするために グリッドによって作成された内部 CollectionView を返します。

columnFooters パネルは、グリッドセルの下、 bottomLeftCells パネルの右に表示されます。 これを使用して、 グリッドデータの下にサマリー情報を表示できます。 以下の例では、columnFooters パネルに 1行を追加して、Column.aggregate プロパティが設定された列に サマリーデータを表示する方法を示します。

function addFooterRow(flex) {

  // 集計を表示するGroupRowを作成します
  let row = new wijmo.grid.GroupRow();

  // 列フッターパネルに行を追加します
  flex.columnFooters.rows.push(row);

  // ヘッダーにシグマを表示します
  flex.bottomLeftCells.setCellData(0, 0, '\u03A3');
}

配列内のアイテムは、Column オブジェクトのプロパティと、 オプションである3つのメンバーを持つJSONオブジェクトである必要があります。

• 子列の配列を含む'columns' メンバー、

• グループが折りたたまれたときに表示されたままにする必要がある子列のバインディングを含む'collapseTo' メンバー、

• グループを最初に縮小する必要があるかどうかを決定する'isCollapsed' ブール値。

たとえば、次のサンプルコードは、 折りたたまれた状態で2つの列グループを含むグリッドを生成します。

new FlexGrid('#theGrid', {
autoGenerateColumns: false,
    columnGroups: [
{ header: 'Group 1', align: 'center', collapseTo: ['id', 'country'], isCollapsed: true, columns: [
{ binding: 'id', header: 'ID' },
{ binding: 'date', header: 'Date', dataType: 'Date' },
{ binding: 'country', header: 'Country', dataType: 'String' },
{ binding: 'active', header: 'Active', dataType: 'Boolean' },
        ]},
{ header: 'Group 2', align: 'center', collapseTo: 'sales', isCollapsed: true, columns: [
{ binding: 'sales', header: 'Sales', dataType: 'Number' },
{ binding: 'expenses', header: 'Expenses', dataType: 'Number' },
        ]}
    ],
itemsSource: getData(20)
});

列レイアウト文字列は、列とそのプロパティを含む配列を表します。 これを使用して、ユーザーが定義した列レイアウトをセッションを越えて保持できます。 また、ユーザーが列レイアウトを変更できるアプリケーションで元に戻す/やり直し機能を実装することもできます。

列レイアウト文字列には、dataMapやeditorなどのJSONに変換できないプロパティは含まれていません。

列レイアウトを保存および復元する必要があり、 レイアウトをシリアル化可能にする必要がない場合は、 columnsプロパティのコンテンツのクローンを作成した後で、 配列のメソッドを使用して復元できます。 これは、columnLayoutプロパティを使用するほど便利ではありませんが、 データマップとエディターを保存および復元することはできます。

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

空にした編集内容の確定を無視することを選択した場合、元の値が null の場合、 グリッドはセル値に空にした編集内容を確定しません。

このプロパティは、グリッドにデータを貼り付けるときに通常ヘッダー情報を含める必要がないため、 読み取り専用グリッドで特に役立ちます。

FlexGridコントロールに対して、このプロパティのデフォルト値は HeadersVisibility.Noneです** PivotGrid コントロールに対して、このプロパティのデフォルト値は HeadersVisibility.All　です。

フォルトでは、deferResizing はfalseに設定されており、 ユーザーがマウスをドラッグするに伴って行および列がサイズ変更されます。 このプロパティをtrueに設定すると、 グリッドにサイズ変更マーカーが表示され、 ユーザーがマウスボタンを放したときに初めて行または列のサイズが変更されます。

FlexGridコントロールに対して、このプロパティのデフォルト値はfalseです。また、 PivotGrid コントロールに対して、このプロパティのデフォルト値はtrueです。

このプロパティのデフォルト値は null です。これにより、 グリッドで rowHeaders パネルの最後の列に編集中のグリフが表示されます。

デフォルトでは、このプロパティにツールチップが表示されるまでの遅延が0で （無効なセル上にマウスをホバーするとツールチップがすぐに表示される）、 HTML要素が含まれない、およびツールチップの外観を カスタマイズするための "wj-error-tip"クラスが含まれています。

このプロパティをnullに設定されている場合、 コントロールはセルの "title"属性を使用して検証エラーを表示します。

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

固定された行や列は、垂直または水平方向にスクロールできませんが、そのセルを選択して編集することは可能です。

固定された列は水平方向にスクロールできませんが、セルは選択および編集できます。

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

固定された行は垂直方向にスクロールできませんが、セルは選択および編集できます。

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

この文字列は、任意のテキストと次の置換文字列を含むことができます。

• {name}: グループ化されるプロパティの名前。
• {value}: グループ化されるプロパティの値。
• {level}: グループレベル。
• {count}: このグループ内にある項目の合計数。

列がグループ化プロパティに連結されている場合は、列ヘッダーを使用して {name} パラメータを置換し、列の書式とデータマップを使用して {value} パラメータを計算します。 列がない場合は、代わりにグループ情報が使用されます。

グループプロパティに連結された非表示の列を追加して、グループヘッダーセルの書式設定をカスタマイズすることもできます。

このプロパティのデフォルト値はnullです。これにより、グリッドは指定されたカルチャの文字列を使用します。

'{name}: <b>{value}</b>({count:n0} items)'

このデフォルトの書式文字列は、次のようなグループヘッダを作成します。

'Country: <b>UK</b> (12 items)'
'Country: <b>Japan</b> (8 items)'

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

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

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

このプロパティは、日本語、中国語、韓国語など、IMEサポートを必要とする言語のサイト/アプリケーションにのみ関係します。

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

このプロパティのデフォルト値は、FlexGridコントロールの場合はfalse、またPivotGridコントロールの場合はtrueです。

このフォーマッター関数は、任意のセルに任意の内容を追加できます。 そのため、グリッドセルの外観と動作を非常に柔軟に制御することが可能です。

指定される場合この関数は、セルを含む GridPanel 、セルの行インデックスと列インデックス、セルを表すHTML要素の4つのパラメーターをとります。 通常は、関数内でセル要素の innerHTML プロパティを変更するようにします。

例:

flex.itemFormatter = (panel, r, c, cell) => {
  if (panel.cellType == CellType.Cell) {

    // セルにスパークラインを描画します
    let col = panel.columns[c];
    if (col.name == 'sparklines') {
      cell.innerHTML = getSparkline(panel, r, c);
    }
  }
}

FlexGridはセルをリサイクルするため、 itemFormatter によってセルのスタイル属性を変更する場合は、 セルの適切でないスタイル属性を事前にリセットする必要があります。 例:

flex.itemFormatter = (panel, r, c, cell) => {

  // カスタマイズする属性をリセットします
  let s = cell.style;
  s.color = '';
  s.backgroundColor = '';
  // このセルのcolorおよびbackgroundColor属性をカスタマイズします
  ...
}

複数のクライアントがグリッドのレンダリングをカスタマイズできるようにする場合は（たとえば、ディレクティブや再利用可能なライブラリを作成するときなど）、 代わりに formatItem イベントを使用することを検討してください。 このイベントを使用すると、複数のクライアントがそれぞれ独自のハンドラをアタッチできます。

指定される場合、バリデータ関数はセルの行と列のインデックスを含むパラメータ、およびデータが既に解析されてデータ項目に適用されているかどうか（parsing == false）、またはユーザーが値を編集しようとして予期されたデータ型に解析できない値を入力したかどうかを記述する解析パラメータ（parsing == true）を受け取ります。

このメソッドは、エラーメッセージを含む文字列を返します。エラーが検出されなかった場合はnullを返します。

次に例を示します。

grid.itemValidator = (row: number, col: number, parsing: boolean) => {
    let item = grid.rows[row].dataItem,
        prop = grid.columns[col].binding;

    // 「解析に失敗しました」メッセージを表示します
    if (parsing) {
        if (prop == 'date') {
            return 'Please enter a valid date in the format "MM/dd/yyyy"';
        } else if (prop == 'id') {
            return 'Please enter a positive number';
        }
    }

    // 保存（解析）されたデータが有効であることを確認します
    if (prop == 'date' && item.date < minDate) {
        return 'Please enter a date after ' + Globalize.formatDate(minDate, 'd');
    } else if (prop == 'id' && item.id < 0) {
        return '正の数を入力してください。';
    }
});

CollectionView.getError メソッドも参照してください。

このプロパティの既定の設定はKeyAction.MoveDown　となり、 コントロールがカーソルを次の行に移動します。 この動作は標準的なExcel式の動作です。

このプロパティの既定の設定は、KeyAction.None　となります。 これにより、Tabキーが押されたときにブラウザ上で次または前のコントロールを選択できます。これは、

ページのアクセシビリティを向上させるために推奨される設定になります。

継承された FlexSheet コントロールのデフォルト設定は KeyAction.CycleOut であることに注意してください (以下を参照)。

以前のバージョンでは、デフォルトは KeyAction.Cycle に設定されていたため、, コントロールは選択範囲をグリッドを横切って移動させていました。 これは Excel の標準的な動作ですが、アクセシビリティには適していません。

また、KeyAction.CycleOut の設定が存在します。これにより、 カーソルがセルを通じて移動（KeyAction.CycleOut　）してから、 最後または最初のセルが選択されたときにページの次/前のコントロールに移動します。

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

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

newRowAtTop プロパティをtrueに設定した場合、新しい行テンプレートを常に表示したままにする場合は、 frozenRowsプロパティを 1に設定します。 これにより、新しい行テンプレートは上部に固定され、ビューからスクロールオフされなくなります。

allowAddNew プロパティがtrueに設定されている場合、および itemsSource オブジェクトが新しい項目の追加をサポートしている場合にのみ、新しい行テンプレートが表示されます。

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

preserveOutlineState プロパティの実装は、 JavaScriptのMap オブジェクトに基づいています。 このオブジェクトはIE 9およびIE 10で利用できません。 このプロパティのデフォルト値は true です。

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

このプロパティを使用すると、CSSルールを変更せずにグリッドが空白を処理する方法を指定できます。 CSSルールはスコープをより適切に制御できるため、CSSルールを使用することを選択します。

たとえば、アプリケーションのすべてのグリッド、特定のグリッド、 または特定の列に適用するCSSルールを作成できます。

このプロパティをtrueに設定すると、相互運用セルテンプレート（特にVueテンプレート）を使用する アプリケーションに望ましくない影響を与える可能性があることに注意してください。

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

このプロパティをfalseに設定すると、高速な自動サイズ変更機能が無効になります。 このプロパティをtrueに設定すると、 各列の wijmo.grid.Column.quickAutoSize プロパティの値に従って、高速な自動サイズ変更機能が有効になります。 このプロパティのデフォルト値はnullです。 これにより、カスタムitemFormatterまたはformatItemイベント ハンドラが割り当てられていないグリッドで、高速な自動サイズ変更機能が有効になります。

クイック自動リサイズでは、行または列を自動サイズ設定するときに さまざまな方法が使用されます。

列の自動サイズ変更では、一時的なcanvas 要素を使用することで、 可能な最大幅の列を収めることができる行が検索されます。 行が検索される場合、その内容が正確に測定されます。 この方法の制限は、キャンバスがプレーンテキストのみをレンダリングすることです。 そのため、セルにHTMLテキストが含まれている場合、 自動リサイズのときに最も幅の広い列が失われる可能性があります。

行の自動リサイズでは、セルの内容に基づいて行の高さを格納するようにキャッシュが使用され、数値セルの測定がスキップされます。 この方法の制限は、多くのセルが同じ内容である場合、または多くの列が数値である場合にのみパフォーマンスが向上することです。

自動リサイズによって、アプリケーションの動作が遅くなっている場合 quickAutoSize をtrueに設定し、アプリのパフォーマンスが向上することができます。

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

行ヘッダーセルは表示されないし、選択することもできません。 アクセシビリティツールと組み合わせて使用することを意図しています。

メモ: このプロパティはすべての選択モードで取得できますが、SelectionMode.ListBoxに設定されている場合にのみ設定可能です。

連結されていないモードでは、行にデータ項目が関連付けられておらず、このプロパティは常に空の配列を返します。

連結モードと非連結モードの両方で選択された行のインデックスを取得するには、selection プロパティを使用します。

配列内の最初の要素は現在の selectionです。 グリッドの selectionMode プロパティが SelectionMode.MultiRange に設定されている場合、 配列には拡張された選択範囲を表す追加の選択範囲が含まれる可能性があります。

selectedRanges 配列内の選択範囲には重なる領域が含まれることに注意してください。 これは、拡張した選択範囲に対する集約などのような操作を実行するときに必要になります。

メモ: このプロパティはすべての選択モードで取得できますが、設定できるのはselectionMode がSelectionMode.ListBoxに設定されているときだけです。

これらのドロップダウンボタンは、 列にColumn.dataMap が設定され、編集可能である場合に表示されます。 ユーザーがドロップダウンボタンをクリックすると、 セルの値を選択するために使用できるドロップダウンリストがグリッドに表示されます。 この設定は、列のColumn.dataMapEditorプロパティを使用して特定の列でオーバーライドされる場合があります。

セルのドロップダウンを使用するには、wijmo.input moduleモジュールをロードしておく必要があります。

グリッドは、グリッドのitemsSourceのitemValidator プロパティおよびCollectionView.getError プロパティを使用して、検証エラーを検出します。

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

データグループを作成するには、itemsSource として使用されるICollectionView オブジェクトのICollectionView.groupDescriptions プロパティを変更します。

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

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

マーキーを表示する場合、グリッドにフォーカスがある場合にのみ、 単純なCSSを使用してマーキーを完全に不透明にすることにより、 アクセシビリティを向上させることができます。

.wj-flexgrid:not(.wj-state-focused) .wj-marquee {
    opacity: 0.2;
}

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

このプロパティは、データ項目ごとに複数の行があるグリッド（MultiRowグリッドなど）および 新しい項目の追加を許可するグリッド（allowAddNewプロパティを参照）で特に役立ちます。

このプロパティは、グリッドの組み込みエディタでのみ機能します。 カスタムエディタ（Column.editorプロパティを参照）を使用している場合は、 プレースホルダープロパティを設定する必要があります。

Internet Explorerブラウザーは、 フォーカスされた入力要素に入力プレースホルダーを表示しないため、 このプロパティはIEでは利用できません。

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

ソートは、グリッドのitemsSource として使用されるICollectionView オブジェクトの ICollectionView.sortDescriptions プロパティによって制御されます。

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

デフォルトでは、このプロパティは nullに設定されており、 columnHeaders パネルの最後の行がソート行になります。

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

tabindex属性値は、コントロールのホストHTML要素で指定することで、 Wijmoコントロールに対して静的に定義できます。 ただし、Wijmoコントロールは複雑な構造であり、コントロールが正しく機能できるように、属性値を内部要素に伝達する必要があるため、 この値をアプリケーションのライフサイクルの後半で変更することはできません。

そのため、コントロールのtabindexを動的に読み取ったり変更したりするには、このプロパティを使用して行う必要があります。

このプロパティのデフォルト値は、FlexGridコントロールの場合は14ピクセル、またPivotGridコントロールの場合は32ピクセルです。

グリッドは、グリッドのitemsSource のCollectionView.getError メソッドを呼び出して、検証エラーを検出します。

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

このプロパティはデフォルトでゼロに設定されます。つまり、仮想化は常に有効ということです。 これにより、バインディングパフォーマンスとメモリー必要量が向上しますが、 スクロール時のパフォーマンス低下は犠牲になります。

グリッドの行数が少ない場合（約50〜100）、このプロパティを150などのやや高い値に設定することで、 スクロールのパフォーマンスを向上させることができます。これにより、 仮想化が無効になり連結処理が遅くなりますが、認識されるスクロールのパフォーマンスが向上する可能性があります。 たとえば、以下のコードは、データソースに150を超える項目がある場合、 グリッドがセルを仮想化します。

// 150を超える項目がある場合はグリッドを仮想化します
theGrid.virtualizationThreshold = 150;

このプロパティを200より大きい値に設定することは推奨されません。 ロード処理の時間が長くなり、グリッドはすべての行のセルを作成しているときに数秒間フリーズするため、 ページ上の要素数が多いためブラウザが遅くなります。 行と列に別々の仮想化しきい値を設定する場合は、 virtualizationThreshold プロパティを2つの数値を含む配列に設定できます。この場合、 最初の数値は行のしきい値として使用され、2番目の数値は列のしきい値として使用されます。 たとえば、次のコードでは、グリッドは行を仮想化しますが、列を仮想化しません。

// 行（しきい値0）は仮想化しますが、列は仮想化しません（しきい値10,000）
theGrid.virtualizationThreshold = [0, 10000];

このプロパティのデフォルト値は 0 で、すべての行と列を仮想化します。