[]
MultiRow クラスの新しいインスタンスを初期化します。
通常、optionsパラメータパラメータにはlayoutDefinition プロパティの 値が含まれます。
コントロールをホストするDOM要素、またはホスト要素のCSS セレクター(例: '#theCtrl')。
コントロールの初期化データを含むJavaScriptオブジェクト。
現在アクティブなセル要素を表すHTMLElementを取得します。
セルが現在選択されてない場合、または選択されたセルが現在の画面内にない場合、このプロパティはnullを返します。
現在アクティブなセルエディタを表すHTMLInputElementを取得します。
セルが現在編集されていない場合、このプロパティはnullを返します。
ユーザーがソースコレクションに項目を追加できるようにグリッドに新規行テンプレートを表示するかどうかを示す値を取得または設定します。
isReadOnly プロパティがtrueに設定されている場合、 新規行テンプレートは表示されません。
このプロパティのデフォルト値は falseです。
ユーザーが[Delete]キーを押したときにグリッドの選択されている行を削除するかどうかを示す値を取得または設定します。
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コントロールには適用しません。
ユーザーがマウスを使用して行、列、またはその両方をサイズ変更できるかどうかを決定する値を取得または設定します。
サイズ変更が可能な場合は、列ヘッダーセルの右端をドラッグして列を、 行ヘッダーセルの下端をドラッグして行をサイズ変更できます。
ヘッダーセルの端をダブルクリックして、 行および列をコンテンツに合わせて自動的にサイズ変更することもできます。 自動サイズ変更の動作は、autoSizeMode プロパティを使用してカスタマイズできます。
このプロパティのデフォルト値はAllowResizing.Columnsです。
ユーザーが列ヘッダーセルをクリックして列をソートできるかどうかを決定する値を取得または設定します。
このプロパティのデフォルト値は AllowSorting.SingleColumn です。
マウスまたはキーボードで選択範囲を広げる時、現在の選択範囲の開始位置(カーソル)と終了位置のどちらを変更するかを決定する値を取得または設定します。
このプロパティのデフォルト値は false です。これにより、 グリッド上にカーソルが移動され、選択範囲が固定されたままになります。
このプロパティが true に設定されている場合、 グリッド上に選択範囲が移動され、カーソルが固定されたままになります。 本動作はExcelと同じです。
セルホストの ARIA ラベル プロパティを取得または設定します。
グリッドがクリップボードショートカットを処理するかどうかを決定する値を取得または設定します。
次のクリップボードショートカットがあります。
クリップボード操作は、表示されている行および列だけが対象となります。
読み取り専用セルは貼り付け操作の影響を受けません。
このプロパティのデフォルト値は true です。
グリッドがitemsSource に基づいて列を自動的に 生成するかどうかを 決定する値を取得または設定します。
列の生成は、少なくとも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です。
左下のセルを含むGridPanel を取得します。
bottomLeftCells パネルは、行ヘッダの下、columnFooters パネルの左に表示されます。
検索するときに大文字と小文字を区別するかどうかを決定する値を取得または設定します。
検索処理には、通常のテキストの検索(autoSearchプロパティを参照)と、データマップされたセルの編集時の項目の検索(Column.dataMapプロパティを参照)が含まれます。
このプロパティのデフォルト値はfalseです。デフォルトでは、検索で大文字と小文字が区別されません。DataMapセルの場合は常に最初に大文字と小文字を区別して検索を実行され、その後caseSensitiveSearchの値に応じた検索が実行されます。
このグリッドのセルを作成および更新するCellFactory を取得または設定します。
データセルを含むGridPanel を取得します。
複数の行にまたがるセルのコンテンツを垂直方向に中央揃えにするかどうかを 判定する値を取得または設定します。
このプロパティのデフォルト値はtrueです。
階層グリッドで子の行の生成に使用される1つ以上のプロパティの名前を取得または設定します。
このプロパティには、項目の子項目を含むプロパティの名前を指定する文字列を設定します
(たとえば、 childItemsPath = 'items';
)。
項目の異なるレベルに異なる名前を持つ子項目がある場合は、
このプロパティに、各レベルの子項目を含むプロパティの名前から成る配列を設定します。
(たとえば、. childItemsPath = ['checks','earnings'];
)。
このプロパティのデフォルト値はnullです。
このプロパティはMultiRowコントロールには適用しません。
コントロールのクライアントサイズを取得します(コントロールのサイズからヘッダーとスクロールバーを引いた値)。
スクロール中のちらつきを減らすために、FlexGridがフリーズされたセルを複製し、 別の要素に表示するかどうかを決定する値を取得または設定します。
このプロパティのデフォルト値は null です。これにより、 グリッドでブラウザに応じて最適な設定が適用されます。
列ヘッダーを折りたたみ、単一の行としてグループヘッダーを 表示するかどうかを判定する値を取得または設定します。
collapsedHeaders プロパティをtrueに設定した場合は、 各グループのheaderプロパティを設定して、ヘッダーが空に ならないようにしてください。
collapsedHeaders プロパティをnullに設定すると、 グリッドにすべてのヘッダー情報(グループおよび列)が表示されます。 この場合、最初の行にはグループヘッダーが、残りの行には個々の 列ヘッダーが表示されます。
このプロパティのデフォルト値はfalseです。
グリッドデータを含むICollectionView を取得します。
itemsSource プロパティが ICollectionViewに設定されている場合、 このプロパティはその値を返します。
itemsSource プロパティがデータ項目の配列に設定されている場合、 このプロパティは編集およびソートをサポートするために グリッドによって作成された内部 CollectionView を返します。
列フッターセルを保持するGridPanel を取得します。
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)
});
列ヘッダセルを含むGridPanel を取得します。
現在の列レイアウトを定義するJSON文字列を取得または設定します。
列レイアウト文字列は、列とそのプロパティを含む配列を表します。 これを使用して、ユーザーが定義した列レイアウトをセッションを越えて保持できます。 また、ユーザーが列レイアウトを変更できるアプリケーションで元に戻す/やり直し機能を実装することもできます。
列レイアウト文字列には、dataMapやeditorなどのJSONに変換できないプロパティは含まれていません。
列レイアウトを保存および復元する必要があり、 レイアウトをシリアル化可能にする必要がない場合は、 columnsプロパティのコンテンツのクローンを作成した後で、 配列のメソッドを使用して復元できます。 これは、columnLayoutプロパティを使用するほど便利ではありませんが、 データマップとエディターを保存および復元することはできます。
グリッドの列コレクションを取得します。
グリッドが空にした編集内容をセル値に確定する方法を示す値を取得または設定します。
このプロパティのデフォルト値はtrueです。
空にした編集内容の確定を無視することを選択した場合、元の値が null の場合、 グリッドはセル値に空にした編集内容を確定しません。
コントロールの外接矩形(ページ座標単位)を取得します。
グリッドでデータをクリップボードにコピーするときに、ヘッダーセルのコンテンツを含めるかどうかを決定する値を取得または設定します。
このプロパティは、グリッドにデータを貼り付けるときに通常ヘッダー情報を含める必要がないため、 読み取り専用グリッドで特に役立ちます。
FlexGridコントロールに対して、このプロパティのデフォルト値は HeadersVisibility.Noneです** PivotGrid コントロールに対して、このプロパティのデフォルト値は HeadersVisibility.All です。
ユーザーがマウスボタンを放すまで、行および列のサイズ変更を遅らせるかどうかを決定する値を取得または設定します。
フォルトでは、deferResizing はfalseに設定されており、 ユーザーがマウスをドラッグするに伴って行および列がサイズ変更されます。 このプロパティをtrueに設定すると、 グリッドにサイズ変更マーカーが表示され、 ユーザーがマウスボタンを放したときに初めて行または列のサイズが変更されます。
FlexGridコントロールに対して、このプロパティのデフォルト値はfalseです。また、 PivotGrid コントロールに対して、このプロパティのデフォルト値はtrueです。
項目が編集されているかどうかを示す行ヘッダパネル内の列のインデックスを取得または設定します。
このプロパティのデフォルト値は null です。これにより、 グリッドで rowHeaders パネルの最後の列に編集中のグリフが表示されます。
現在編集中のセルを識別するCellRange を取得します。
グリッドデータを含むIEditableCollectionView を取得します。
showErrors プロパティがtrueに設定されているときにグリッドで検出された検証エラーを表示するために使用される Tooltip オブジェクトを取得または設定します。
デフォルトでは、このプロパティにツールチップが表示されるまでの遅延が0で (無効なセル上にマウスをホバーするとツールチップがすぐに表示される)、 HTML要素が含まれない、およびツールチップの外観を カスタマイズするための "wj-error-tip"クラスが含まれています。
このプロパティをnullに設定されている場合、 コントロールはセルの "title"属性を使用して検証エラーを表示します。
グリッドでクリップボードへ、またはクリップボードから、コンテンツをコピーまたは貼り付けるときに、選択範囲を自動的に拡張して結合範囲のセルを含めるかどうかを決定する値を取得または設定します。
このプロパティのデフォルト値は trueです。
固定列の数を取得または設定します。
固定された列は水平方向にスクロールできませんが、セルは選択および編集できます。
このプロパティのデフォルト値は 0です。
固定行の数を取得または設定します。
固定された行は垂直方向にスクロールできませんが、セルは選択および編集できます。
このプロパティのデフォルト値は 0です。
グループヘッダーコンテンツを作成するために使用される書式文字列を取得または設定します。
この文字列は、任意のテキストと次の置換文字列を含むことができます。
列がグループ化プロパティに連結されている場合は、列ヘッダーを使用して
{name}
パラメータを置換し、列の書式とデータマップを使用して {value}
パラメータを計算します。
列がない場合は、代わりにグループ情報が使用されます。
グループプロパティに連結された非表示の列を追加して、グループヘッダーセルの書式設定をカスタマイズすることもできます。
このプロパティのデフォルト値はnullです。これにより、グリッドは指定されたカルチャの文字列を使用します。
'{name}: <b>{value}</b>({count:n0} items)'
このデフォルトの書式文字列は、次のようなグループヘッダを作成します。
'Country: <b>UK</b> (12 items)'
'Country: <b>Japan</b> (8 items)'
グループ内のサマリー行の位置を決定する値を取得または設定します。 childItemsPath プロパティが設定されている場合、このプロパティは機能しません。
このプロパティのデフォルト値は GroupSummaryPosition.Top です。
グリッドの列ヘッダーの表示に使用される行のレイアウトを定義する配列を取得または設定します。
この配列には、layoutDefinition プロパティと同じセルグループオブジェクトのリストが含まれます。
このプロパティのデフォルト値はnullです。グリッドでlayoutDefinition プロパティを使用して列ヘッダーが作成されます。
行ヘッダおよび列ヘッダにフォーカスできるかどうかを決定する値を取得または設定します。
このプロパティのデフォルト値は HeadersFocusability.None です。
行ヘッダおよび列ヘッダが表示されるかどうかを決定する値を取得または設定します。
このプロパティのデフォルト値は HeadersVisibility.All です。
コントロールをホストしているDOM要素を取得します。
編集モードでないときに、グリッドがIME(Input Method Editor)をサポートするかどうかを決定する値を取得または設定します。
このプロパティは、日本語、中国語、韓国語など、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 メソッドも参照してください。
グリッドに表示される項目を含む配列またはICollectionView を取得または設定します。
[ENTER]キーが押されたときに実行されるアクションを取得または設定します。
このプロパティの既定の設定はKeyAction.MoveDown となり、 コントロールがカーソルを次の行に移動します。 この動作は標準的なExcel式の動作です。
[Tab]キーが押されたときに実行されるアクションを取得または設定します。
このプロパティの既定の設定は、KeyAction.None となります。 これにより、Tabキーが押されたときにブラウザ上で次または前のコントロールを選択できます。これは、
ページのアクセシビリティを向上させるために推奨される設定になります。
継承された FlexSheet コントロールのデフォルト設定は KeyAction.CycleOut であることに注意してください (以下を参照)。
以前のバージョンでは、デフォルトは KeyAction.Cycle に設定されていたため、, コントロールは選択範囲をグリッドを横切って移動させていました。 これは Excel の標準的な動作ですが、アクセシビリティには適していません。
また、KeyAction.CycleOut の設定が存在します。これにより、 カーソルがセルを通じて移動(KeyAction.CycleOut )してから、 最後または最初のセルが選択されたときにページの次/前のコントロールに移動します。
各データ項目の表示に使用される行のレイアウトを定義する配列を取得または設定します。
この配列には、次のプロパティを持つセルグループオブジェクトのリストが含まれます。
layoutDefinition プロパティを設定すると、グリッドは各グループ内のセルを 次のようにスキャンします。
すべてのグループが準備できたら、すべてのグループの最大の rowspan を1レコードの行数とし、 必要に応じて各グループに行を追加して高さを合わせます。
このスキームは単純で柔軟です。次に例を示します。
{ header: 'Group 1', cells: [{ binding: 'c1' }, { binding: 'c2'}, { binding: 'c3' }]}
このグループの colspan は1なので、各列に1つのセルが使用されます。結果は次のとおりです。
| C1 |
| C2 |
| C3 |
2列を含むグループを作成するには、グループの colspan プロパティを次のように設定します。
{ header: 'Group 1', colspan: 2, cells:[{ binding: 'c1' }, { binding: 'c2'}, { binding: 'c3' }]}
セルは次のように折り返されます。
| C1 | C2 |
| C3 |
最後のセルは2列にまたがります(グループ全体に拡大)。
グループではなく個々のセルに colspan を指定することもできます。次に例を示します。
{ header: 'Group 1', cells: [{binding: 'c1', colspan: 2 }, { binding: 'c2'}, { binding: 'c3' }]}
最初のセルの colspan が2なので、結果は次のようになります。
| C1 |
| C2 | C3 |
セルのrowspanプロパティを使用して、セルを垂直方向に拡張することもできます。
{ header: 'Group 1', cells: [{binding: 'c1', rowspan: 2 }, { binding: 'c2'}, { binding: 'c3' }]}
最初のセルの rowspan が2なので、結果は次のようになります。
| C1 | C2 |
| | C3 |
セルは Column クラスを拡張しているため、どのセルにも通常の Column プロパティのすべてを追加できます。 次に例を示します。
{ header: 'Group 1', cells: [
{ binding: 'c1', colspan: 2 },
{ binding: 'c2'},
{ binding: 'c3', format: 'n0', required: false, etc... }
]}
セルグループの isRowHeader プロパティを使用すると、行ヘッダーセルとして表示されるグループを作成できます。 セルグループのisRowHeaderプロパティを使用すると、行ヘッダーセルとして表示されるグループを作成できます。 これは、固定された列によって行われます。 そのため、行ヘッダーは通常のセルであっても、ヘッダーセルのように表示および動作します。
isRowHeader プロパティをtrueに設定すると、セルのisReadOnlyプロパティが自動的にtrueに設定され(ヘッダーは編集できません)、 セルがヘッダーとしてスタイル設定されるようにセルの cssClass プロパティに'wj-header' スタイルが追加され、また、セルがヘッダーを連結されていない文字列として表示するように cellTemplate プロパティをその header 値に設定します。 行ヘッダーセルに連結されている値を表示する場合は、 セルのheaderではなく、bindingプロパティを設定することができます。
グリッドでは、最後の描画サイクルで更新されたセルの描画をスキップするかどうかを決定する値を取得または設定します。
このプロパティのデフォルト値は trueです。
コンテンツの最大幅や高さに合わせてグリッドのサイズを調整するかどうかを決定する値を取得または設定します。
このプロパティのデフォルト値は false です。
セルの結合方法を決定するMergeManager オブジェクトを取得または設定します。
グループヘッダーに複数の行を含めるか、単一のヘッダー行を含めるかを決定する値を取得または設定します。
このプロパティは、グループヘッダーに集計値を表示する場合に役立ちます(Column.aggregate プロパティを参照)。
このプロパティのデフォルト値はfalseです。
新しい行テンプレートをグリッドの上部に配置するか、下部に配置するかを示す値を取得または設定します。
newRowAtTop プロパティをtrueに設定した場合、新しい行テンプレートを常に表示したままにする場合は、 frozenRowsプロパティを 1に設定します。 これにより、新しい行テンプレートは上部に固定され、ビューからスクロールオフされなくなります。
allowAddNew プロパティがtrueに設定されている場合、および itemsSource オブジェクトが新しい項目の追加をサポートしている場合にのみ、新しい行テンプレートが表示されます。
このプロパティのデフォルト値は false です。
貼り付けるときに、すべてのセルを貼り付けるか、空のセルのみを貼り付けるかを決定する値を取得または設定します。 このプロパティのデフォルト値は true です。
データがリフレッシュされたときに、グリッドがノードの展開/折りたたみ状態を保持するかどうかを決定する値を取得または設定します。
preserveOutlineState プロパティの実装は、 JavaScriptのMap オブジェクトに基づいています。 このオブジェクトはIE 9およびIE 10で利用できません。 このプロパティのデフォルト値は true です。
データがリフレッシュされたときに、グリッドが行の選択状態を保持するかどうかを決定する値を取得または設定します。
このプロパティのデフォルト値は trueです。
グリッドがセル内の空白をデータに表示されるとおりに保持する(white-space: pre)
か、または空白を単一の空白文字に折りたたむ(white-space: normal)
かどうかを決定する値を取得または設定します。
このプロパティを使用すると、CSSルールを変更せずにグリッドが空白を処理する方法を指定できます。 CSSルールはスコープをより適切に制御できるため、CSSルールを使用することを選択します。
たとえば、アプリケーションのすべてのグリッド、特定のグリッド、 または特定の列に適用するCSSルールを作成できます。
このプロパティをtrueに設定すると、相互運用セルテンプレート(特にVueテンプレート)を使用する アプリケーションに望ましくない影響を与える可能性があることに注意してください。
このプロパティのデフォルト値はfalseです。
グリッドが列のサイズを自動調整するときに精度よりもパフォーマンスを最適化するかどうかを決定する値を取得または設定します。
このプロパティをfalseに設定すると、高速な自動サイズ変更機能が無効になります。 このプロパティをtrueに設定すると、 各列の wijmo.grid.Column.quickAutoSize プロパティの値に従って、高速な自動サイズ変更機能が有効になります。 このプロパティのデフォルト値はnullです。 これにより、カスタムitemFormatterまたはformatItemイベント ハンドラが割り当てられていないグリッドで、高速な自動サイズ変更機能が有効になります。
クイック自動リサイズでは、行または列を自動サイズ設定するときに さまざまな方法が使用されます。
列の自動サイズ変更では、一時的なcanvas 要素を使用することで、 可能な最大幅の列を収めることができる行が検索されます。 行が検索される場合、その内容が正確に測定されます。 この方法の制限は、キャンバスがプレーンテキストのみをレンダリングすることです。 そのため、セルにHTMLテキストが含まれている場合、 自動リサイズのときに最も幅の広い列が失われる可能性があります。
行の自動リサイズでは、セルの内容に基づいて行の高さを格納するようにキャッシュが使用され、数値セルの測定がスキップされます。 この方法の制限は、多くのセルが同じ内容である場合、または多くの列が数値である場合にのみパフォーマンスが向上することです。
自動リサイズによって、アプリケーションの動作が遅くなっている場合 quickAutoSize をtrueに設定し、アプリのパフォーマンスが向上することができます。
viewRange と似ていますが、rowは最初の行インデックスではなく、最初のレコード インデックスであり、 row2 は、最後のレコードの行インデックスではなく、最後のレコード インデックスです。
1つのセルが編集された後にグリッドのすべてのセルを更新するかどうかを決定する値を取得または設定します。
このプロパティのデフォルト値は trueです。
要素内のコントロールを右から左のレイアウトでホストするかどうかを示す値を取得します。
行ヘッダーセルを作成するために使用されるプロパティの名前を取得または設定します。
行ヘッダーセルは表示されないし、選択することもできません。 アクセシビリティツールと組み合わせて使用することを意図しています。
行ヘッダセルを含むGridPanel を取得します。
グリッドの行コレクションを取得します。
各項目の表示に使用される行数を取得します。
この値は、layoutDefinitionプロパティの値に基づいて 自動的に計算されます。
リッドのスクロールバーの値を表すPoint を取得または設定します。
グリッド内容のサイズ(ピクセル単位)を取得します。
現在選択されているデータ項目を含む配列を取得または設定します。
メモ: このプロパティはすべての選択モードで取得できますが、設定できるのはselectionMode がSelectionMode.ListBoxに設定されているときだけです。
現在の選択範囲を表す CellRange オブジェクトを含む配列を取得または設定します。
配列内の最初の要素は現在の selectionです。 グリッドの selectionMode プロパティが SelectionMode.MultiRange に設定されている場合、 配列には拡張された選択範囲を表す追加の選択範囲が含まれる可能性があります。
selectedRanges 配列内の選択範囲には重なる領域が含まれることに注意してください。 これは、拡張した選択範囲に対する集約などのような操作を実行するときに必要になります。
現在選択されている行を含む配列を取得または設定します。
メモ: このプロパティはすべての選択モードで取得できますが、設定できるのはselectionMode がSelectionMode.ListBoxに設定されているときだけです。
現在の選択を取得または設定します。
現在の選択モードを取得または設定します。
グリッドがデータマップされたセルにドロップダウンボタンを追加するかどうかを示す値を取得または設定します。
これらのドロップダウンボタンは、 列にColumn.dataMap が設定され、編集可能である場合に表示されます。 ユーザーがドロップダウンボタンをクリックすると、 セルの値を選択するために使用できるドロップダウンリストがグリッドに表示されます。 この設定は、列のColumn.dataMapEditorプロパティを使用して特定の列でオーバーライドされる場合があります。
セルのドロップダウンを使用するには、wijmo.input moduleモジュールをロードしておく必要があります。
グリッドで、検証エラーがあるセルとエラーの説明を含むツールチップに'wj-state-invalid' クラスを追加するかどうかを指定する値を取得または設定します。
グリッドは、グリッドのitemsSourceのitemValidator プロパティおよびCollectionView.getError プロパティを使用して、検証エラーを検出します。
このプロパティのデフォルト値は true です。
データグループを区切るために FlexGrid にグループ行を挿入するかどうかを決定する値を 取得または設定します。
データグループを作成するには、itemsSource として使用されるICollectionView オブジェクトのICollectionView.groupDescriptions プロパティを変更します。
このプロパティのデフォルト値はtrueです。
グリッドで、行フィールドの列ヘッダーにソートインジケータを グリッドの列ヘッダーパネルに表示するかどうかを判定する値を 取得または設定します。
ボタンが表示されている場合は、ボタンをクリックすると、 collapsedHeaders プロパティの値が切り替わります。
このプロパティのデフォルト値はfalseです。
現在の選択範囲の周囲にマーキー要素を表示するかどうかを示す値を取得または設定します。
このプロパティのデフォルト値は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です。
結合されたセルをコピーするかコピーしないかを決定する値を取得または設定します。 このプロパティのデフォルト値は false です。
ソートインジケーターを表示する列ヘッダパネルの行のインデックスを取得または設定します。
デフォルトでは、このプロパティは nullに設定されており、 columnHeaders パネルの最後の行がソート行になります。
ユーザーがドキュメントをスクロールしたときに、列ヘッダーを表示したままにするかどうかを決定する値を取得または設定します。
このプロパティのデフォルト値は false です。
コントロールに関連付けられた tabindex 属性の値を取得または設定します。
tabindex属性値は、コントロールのホストHTML要素で指定することで、 Wijmoコントロールに対して静的に定義できます。 ただし、Wijmoコントロールは複雑な構造であり、コントロールが正しく機能できるように、属性値を内部要素に伝達する必要があるため、 この値をアプリケーションのライフサイクルの後半で変更することはできません。
そのため、コントロールのtabindexを動的に読み取ったり変更したりするには、このプロパティを使用して行う必要があります。
左上のセル(列ヘッダーの左)を含むGridPanel を取得します。
異なるレベルの行グループをオフセットするインデントを取得または設定します。
このプロパティのデフォルト値は、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 で、すべての行と列を仮想化します。
FlexGrid コントロールのインスタンス化に使用されるテンプレートを取得または設定します。
列タイプに基づいて自動生成されたグリッド列のデフォルトの幅を定義する静的なオブジェクトへの参照を取得します。
オブジェクトキーは DataType 値です。 オブジェクトの値は、 数値(ピクセル単位での幅)またはスターサイズの文字列 (列のdefaultSizeプロパティで定義されているデフォルトの幅の倍数)です。
次に例を示します。
import { FlexGrid } from '@mescius/wijmo.grid';
import { DataType } from '@mescius/wijmo';
// デフォルトですべてのグリッドのブール列を「100px」幅にします
FlexGrid.defaultTypeWidth[DataType.Boolean] = 100;
// すべてのグリッドの数値列を列のdefaultSizeと同じ幅「75%」にします
FlexGrid.defaultTypeWidth[DataType.Number] = '0.75*';
このControl が所有する要素にイベントリスナーを追加します。
コントロールは、アタッチされているリスナーとそのハンドラのリストを保持し、 コントロール が破棄されているときにそれらを簡単に削除すること ができます(dispose と removeEventListener ) メソッドを参照してください)。
イベントリスナーを削除しないと、メモリリークが発生する可能があります。
デフォルトでは passive パラメータはfalseに設定されています。これはイベントハンドラが event.preventDefault() を呼び出すことを意味します。 タッチイベントまたはマウスホイールイベントにpassiveハンドラを追加する場合は、このパラメータをtrueに設定するとアプリケーションのパフォーマンスが向上します。
passive イベントリスナーの詳細については、「Improving scrolling performance with passive listeners」を参考してください。
イベントのターゲット要素。
イベントを指定する文字列。
イベントが発生したときに実行する関数。
リスナーがターゲット要素によって処理される前にコントロールによって処理される必要があるかどうかを示します。
ハンドラーが preventDefault() を呼び出さないことを示します。
固定された要素の合計サイズがグリッド サイズを超えないように列または行のサイズを調整します。
コントロールの新しいインスタンスにテンプレートを適用し、ルート要素を返します。
このメソッドはテンプレート化されたコントロールのコンストラクターによって呼び出されますので、このメソッドは使用できません。 テンプレートのパーツを対応するコントロールメンバにバインドする役割を持ちます。
以下のサンプルコードは、InputNumber コントロールのインスタンスにテンプレートを適用します。 このテンプレートには、'wj-part'属性が'input'、'btn-inc'、および'btn-dec'に設定された要素を含める必要があります。 コントロールのメンバである'_tbx'、'_btnUp'、'_btnDn'には、これらの要素への参照が割り当てられます。
this.applyTemplate('wj-control wj-inputnumber', templateString, {
_tbx: 'input',
_btnUp: 'btn-inc',
_btnDn: 'btn-dec'
}, 'input');
@param classNames コントロールのホスト要素に追加するクラスの名前。 @param template コントロールのテンプレートを定義するHTML文字列。 @param parts パーツ変数とその名前のディクショナリー。 @param namePart ホスト要素にちなんで名付けられたパーツの名前。 これにより、コントロールがフォームで使用されたときにデータをどのように送信するかが決まります。
列をその内容がちょうど収まるようにサイズ変更します。
ホスト要素がDOMに追加されていない場合、 またはグリッドの祖先要素が非表示の場合、 グリッドはセルを測定することができませんので、 列のサイズを自動的に変更することはできません。
サイズ変更する列のインデックス。
列インデックスの参照先が通常の列であるか、ヘッダ列であるか。
追加の間隔(ピクセル単位)。
列の範囲をその内容がちょうど収まるようにサイズ変更します。
測定される行の範囲は常に、現在表示されているすべての行 と 現在表示されていない最大2,000行です。 グリッドに大量のデータが含まれている場合には(たとえば、50,000行など)、 すべての行を測定すると非常に時間がかかる可能性があるため、すべての行は測定されません。
ホスト要素がDOMに追加されていない場合、 またはグリッドの祖先要素が非表示の場合、 グリッドはセルを測定することができませんので、 列のサイズを自動的に変更することはできません。
サイズ変更する最初の列のインデックス(デフォルトは最初の列)。
サイズ変更する最後の列のインデックス(デフォルトは最後の列)。
列インデックスの参照先が通常の列であるか、ヘッダ列であるか。
追加の間隔(ピクセル単位)。
行をその内容がちょうど収まるようにサイズ変更します。
ホスト要素がDOMに追加されていない場合、 またはグリッドの祖先要素が非表示の場合、 グリッドはセルを測定することができませんので、 列のサイズを自動的に変更することはできません。
サイズ変更する行のインデックス。
行インデックスがヘッダ行を参照していることを示す場合はtrue。通常のデータ行を参照している場合はfalse。フッタ行を参照している場合はnull。
追加の間隔(ピクセル単位)。
行の範囲をその内容がちょうど収まるようにサイズ変更します。
ホスト要素がDOMに追加されていない場合、 またはグリッドの祖先要素が非表示の場合、 グリッドはセルを測定することができませんので、 行のサイズを自動的に変更することはできません。
サイズ変更する最初の行のインデックス。
サイズ変更する最初の行のインデックスす。
行インデックスの参照先が通常の行であるか、ヘッダ行であるか。
追加の間隔(ピクセル単位)。
次にendUpdate が呼び出されるまで通知を中断します。
指定されたセルが編集可能かどうかを示す値を取得します。
セルを含む行のインデックス。
セルを含む列のインデックス。
すべてのグループ行を指定したレベルに折りたたみます。
表示する最大のグループレベル。
このコントロールにフォーカスのある要素が含まれているかどうかをチェックします。
beginUpdate/endUpdate ブロック内で関数を実行します。
この関数の実行が完了するまでコントロールは更新されません。 このメソッドは、関数が例外を生成した場合でも endUpdate が呼び出されるようにします。
実行する関数。
ホスト要素との関連付けを解除することによってコントロールを破棄します。
beginUpdate の呼び出しによって中断された通知を再開します。
コントロールを無効にする必要があります。このパラメータのデフォルト値は true です。
保留中の編集をすべてコミットし、編集モードを終了します。
保留中の編集をキャンセルするかコミットするか。
編集操作が正常に終了した場合は True です。
グリッド全体をスクロールしてビューに入れることなくグリッドにフォーカスを設定するようにオーバーライドされます。
グリッドに既にフォーカスが設定されている場合でも、フォーカス操作を実行するかどうか。
セル要素の範囲(ビューポート座標単位)を取得します。
このメソッドは、 cellsパネル内のセル(スクロール可能なデータセル)の範囲を返します。 その他のパネルにあるセルの範囲を取得するには、該当する GridPanel オブジェクトの getCellBoundingRect メソッドを使用してください。
戻り値は、セルの位置とサイズ(ビューポート座標単位)を 含むRect オブジェクトです。 このビューポート座標は、 getBoundingClientRectメソッドで使用されている座標と同じです。
セルを含む行のインデックス。
セルを含む列のインデックス、名前、またはバインディング。
返される矩形の単位をビューポート座標ではなく生のパネル座標にするかどうか。
グリッドのスクロール可能領域内のセルに格納された値を取得します。
セルを含む行のインデックス。
セルを含む列のインデックス、名前、またはバインディング。
値を表示用に書式設定するかどうか。
CellRange の内容を、クリップボードへのコピーまたはCSV(カンマ区切り値)ファイルへのエクスポートに適した文字列として取得します。
非表示の行および列はクリップボード文字列に含まれません。
CellRangeで無効な(負のインデックスを持つ)行または列の範囲を指定できます。これは、データの行または列が結果に含まれないことを示します。 また、colHeadersまたはrowHeadersパラメーターをtrueに設定すると、 対応するデータセルなしで、 列ヘッダーまたは行ヘッダーのみをエクスポートできます。
コピーするCellRange 。 省略した場合、現在の選択範囲が使用されます。
クリップ文字列を指定するブール値は、CSV文字列またはクリップ文字列に対する オプションを指定する ClipStringOptions 値である必要があります。
列ヘッダーを含めるかどうか。
行のヘッダーを含むかどうか。
現在の選択範囲をエクスポートするには、 rng パラメータをnullに設定します。 これにより、主な選択範囲だけでなく、選択された行( SelectionMode.ListBox モードの場合) や複数の選択範囲( SelectionMode.MultiRange モードの場合)などの拡張した選択範囲も含まれます。
選択したすべての範囲が同じ列範囲または行範囲を参照している場合のみに、複数の選択範囲が含まれます。
名前または連結に基づいて列を取得します。
このメソッドは、名前で列を検索します。指定された名前を持つ列が見つからない場合は、 バインディングによって検索します。検索では大文字と小文字が区別されます。
検索する名前または連結。
ヘッダに定義された列を検索するかどうか。
指定された名前または連結を含む列。見つからない場合はnull。
列グループのコレクションを取得します。
セルの選択状態を示すSelectedState 値を取得します。
検査するセルの行インデックス。
検査するセルの列インデックス。
オブジェクトが指定されたプロパティを持つかどうかを判定します。
プロパティの名前。
指定されたポイントに関する情報を含むwijmo.grid.HitTestInfo オブジェクトを取得します。
次に例を示します。
// ユーザーがグリッドをクリックしたときに、ポイントをヒットテストします
flex.hostElement.addEventListener('click', (e) => {
let ht = flex.hitTest(e.pageX, e.pageY);
console.log('you clicked a cell of type "' +
wijmo.grid.CellType[ht.cellType] + '".');
});
調べるPoint (ページ座標単位)、MouseEventオブジェクト、またはポイントのX座標。
ポイントのY座標(ページ座標単位、最初のパラメーターが数値の場合)。
ポイントに関する情報を含むwijmo.grid.HitTestInfoオブジェクト。
指定したオブジェクトからプロパティをコピーしてコントロールを初期化します。
このメソッドを使用すると、各プロパティの値をコードで設定する代わりにプレーンなデータオブジェクトを使用してコントロールを初期化できます。
例:
grid.initialize({
itemsSource: myList,
autoGenerateColumns: false,
columns: [
{ binding: 'id', header: 'Code', width: 130 },
{ binding: 'name', header: 'Name', width: 60 }
]
});
// 以下と同等です。
grid.itemsSource = myList;
grid.autoGenerateColumns = false;
// など
初期化データは適用時に型チェックされます。 初期化オブジェクトに不明なプロパティ名または無効なデータ型が含まれている場合、このメソッドは例外をスローします。
初期化データを含むオブジェクト。
非同期更新を発生させるため、コントロールを無効にします。
内容だけでなくコントロールのレイアウトも更新するかどうか。
オブジェクトが別のオブジェクトのプロトタイプチェーンに存在するかどうかを判定します。
プロトタイプチェーンが判定される別のオブジェクト。
指定したCellRangeがこのグリッドの行および列コレクションに対して有効かどうかをチェックします。
チェックする範囲。
autoSizedColumn イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
autoSizedRow イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
autoSizingColumn イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
autoSizingRow イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
beginningEdit イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
cellEditEnded イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
cellEditEnding イベントを発生させます。
イベントデータを含むCellEditEndingEventArgs 。
イベントがキャンセルされなかった場合は True です。
collapsedHeadersChanged イベントを発生させます。
collapsedHeadersChanging イベントを発生させます。
イベントデータを含むCancelEventArgs 。
イベントがキャンセルされなかった場合は True です。
columnGroupCollapsedChanged イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
columnGroupCollapsedChanging イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
copied イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
copying イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
deletedRow イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
deletingRow イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
draggedColumn イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
draggedRow イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
draggingColumn イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
draggingColumnOver イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
draggingRow イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
draggingRowOver イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
formatItem イベントを発生させます。
イベントデータを含むFormatItemEventArgs 。
groupCollapsedChanged イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
groupCollapsedChanging イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
invalidInput イベントを発生させます。
イベントハンドラーがイベントをキャンセルした場合、コントロールは無効な入力内容とフォーカスを保持します。
itemsSourceChanged イベントを発生させます。
itemsSourceChanging イベントを発生させます。
イベントデータを含むCancelEventArgs 。
イベントがキャンセルされなかった場合は True です。
loadedRows イベントを発生させます。
loadingRows イベントを発生させます。
イベントデータを含むCancelEventArgs 。
イベントがキャンセルされなかった場合は True です。
pasted イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
pastedCell イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
pasting イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
pastingCell イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
pinnedColumn イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
pinningColumn イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
prepareCellForEdit イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
refreshing イベントを発生させます。
resizedColumn イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
resizedRow イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
resizingColumn イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
resizingRow イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
rowAdded イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされず、新しい行が保持される場合は True です。
rowEditEnded イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
rowEditEnding イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
rowEditStarted イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
rowEditStarting イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
scrollPositionChanged イベントを発生させます。
selectionChanged イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
sortedColumn イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
sortingColumn イベントを発生させます。
イベントデータを含むCellRangeEventArgs 。
イベントがキャンセルされなかった場合は True です。
starSizedColumns イベントを発生させます。
updatedLayout イベントを発生させます。
updatedView イベントを発生させます。
updatingLayout イベントを発生させます。
イベントデータを含むCancelEventArgs 。
イベントがキャンセルされなかった場合は True です。
updatingView イベントを発生させます。
イベントデータを含むCancelEventArgs 。
イベントがキャンセルされなかった場合は True です。
指定されたプロパティが列挙可能かどうかを判断します。
プロパティの名前。
グリッドの表示を更新します。
グリッドのレイアウトと内容を更新するか、内容だけを更新するか。
グリッドの表示を更新します。
グリッドのレイアウトと内容を更新するか、内容だけを更新するか。
既存の要素を再利用するかどうか。
既存の要素を保持してその状態を更新するかどうか。
選択範囲内のセルを更新し、その内容とスタイルを更新します。
すべてのセルを更新する refreshCells メソッドとは異なり、 refreshRange ではどのセルを更新するかを指定できます。 これにより、 パフォーマンスを向上させることができます。
このControl が所有する要素にアタッチされている1つまたは複数のイベントリスナーを解除します。
イベントのターゲット要素。 nullの場合、すべてのターゲットにアタッチされているリスナーが解除されます
イベントを指定する文字列。 nullの場合、すべてのイベントにアタッチされているリスナーが解除されます。
削除するハンドラ。 nullの場合は、すべてのハンドラが削除されます。
リスナーがキャプチャリスナーかどうか。 nullの場合、キャプチャリスナーと非キャプチャリスナーの両方が解除されます。
削除されたリスナーの数。
指定したセルが画面に入るようにグリッドをスクロールします。
負の行と列のインデックスは無視されるので、以下を呼び出すと、
grid.scrollIntoView(200, -1);
グリッドは200行目を表示するように垂直にスクロールしますが、水平にスクロールしません。
画面に入るようにスクロールする行のインデックス
画面に入るようにスクロールする列のインデックス、名前、または連結。
スクロールした新しい位置をすぐ表示するためにグリッドを更新する必要があるかどうかを決定するオプションのパラメータ。
グリッドがスクロールされた場合はTrue。
セル範囲を選択し、オプションでそのセル範囲が画面に入るようにスクロールします。
select メソッドは、 CellRange 、と新しい選択範囲を画面に入るようにスクロールするかどうかを示すオプションの ブール型パラメータを渡すことで呼び出すことができます。 以下に例を示しています。
// セル1,1を選択して画面に入るようにスクロールします
grid.select(new CellRange(1, 1), true);
// 選択範囲(1,1)~(2,4)を指定し、画面に入るようにスクロールしません
grid.select(new CellRange(1, 1, 2, 4), false);
select メソッドを呼び出してインデックスまたは選択する行と列を渡すこともできます。 この場合、選択範囲が画面に入るようにスクロールします。 以下に例を示しています。
// セル1,1を選択して画面に入るようにスクロールします
grid.select(1, 1);
選択する範囲(または選択する行のインデックス)。
新しい選択範囲が画面に入るようにスクロール(または、選択する列のインデックス、名前、または連結)するかどうか。
選択した範囲の GridPanel は GridPanel に属します。
新しい選択範囲が適用された場合は True になります。
グリッド内のすべてのセルを選択します。
グリッドのスクロール可能領域内のセルの値を設定します。
セルを含む行のインデックス。
セルを含む列のインデックス、名前、またはバインディング。
セルに格納する値。
列のデータ型に合わせて値を自動的に変更するかどうか。
グリッドを無効にして変更を表示するかどうか。
値が正常に保存された場合はtrue、それ以外の場合はfalse。
指定されたセルの編集を開始します。
FlexGrid の編集は、Excelの編集によく似ています。 [F2]キーを押すか、セルをダブルクリックすると、 グリッドが完全編集モードになります。 このモードでは、ユーザーがEnter、Tab、Esc、またはいずれかの矢印キーを押すまで、 セルエディタはアクティブなままになります。 完全編集モードでは、 カーソルキーを押しても、グリッドの編集モードは終了しません。
テキストをセルに直接入力すると、グリッドはクイック編集モードになります。 このモードでは、ユーザーがEnter、Tab、Esc、またはいずれかの矢印キーを押すまで、 セルエディタはアクティブなままになります。
通常、完全編集モードは既存の値を変更する際に使用します。 クイック編集モードは新しいデータをすばやく入力する際に使用します。
編集中に[F2]キーを押すことで、完全編集モードとクイック編集モードを切り替えることができます。
ユーザーがカーソルキーを押したときも編集モードのままにするかどうか。デフォルトはtrueです。
編集する行のインデックス。 デフォルトは現在選択されている行です。
編集する列の索引、名前、または連結。 デフォルトは現在選択されている列です。
編集開始時に、エディタにフォーカスを与えるかどうか。デフォルトはtrueです。
このアクションをトリガーしたイベント(通常はキープレスまたはキーダウン)。
編集操作が正常に開始された場合は True です。
現在のロケールを使用して文字列に変換された日付を返します。
オブジェクトの文字列表現を返します。
現在選択されているセルに関連付けられたドロップダウンリストボックスの表示・非表示を切り替えます。
ドロップダウンリストは、列のColumn.dataMapプロパティに基づいて自動的に作成されます。 このメソッドでは、セルが編集モードに入ったとき、またはユーザが特定のキーを押したときに、 ドロップダウンリストを自動的に表示することができます。
たとえば、このコードでは、グリッドが編集モードに入るたびに、グリッドにドロップダウンリストが表示されます。
// グリッドが編集モードに入ると、ドロップダウンリストを表示する
theGrid.beginningEdit = () => {
theGrid.toggleDropDownList();
}
このコードでは、ユーザーがスペースバーを押した場合、グリッドが編集モードに入った後で、ドロップダウンリストが表示されます。
// ユーザーがスペースバーを押したときにドロップダウンリストを表示する
theGrid.hostElement.addEventListener('keydown', (e) => {
if (e.keyCode == 32) {
e.preventDefault();
theGrid.toggleDropDownList();
}
}, true);
指定されたオブジェクトのプリミティブ値を返します。
HTML要素に含まれるすべてのWijmoコントロールを破棄します。
コンテナー要素。
指定したDOM要素でホストされているコントロールを取得します。
コントロールをホストするDOM要素、またはホスト要素のCSS セレクター(例: '#theCtrl')。
指定したHTML要素に含まれるすべてのWijmoコントロールを無効化します。
このメソッドは、コントロールの表示状態やサイズを変更する 動的なパネルをアプリケーションで使用している場合に使用します。 たとえば、スプリッタ、アコーディオン、およびタブコントロールは通常、 その中の要素の表示状態を変更します。この場合、その要素に含まれるコントロールに通知しないと、 それらのコントロールが適切に機能しなくなる可能性があります。 これが起こる場合は、動的コンテナーで適切なイベントを処理し、 Control.invalidateAll メソッドを呼び出してコンテナー内のWijmoコントロールの レイアウト情報が適切に更新されるようにする必要があります。
コンテナー要素。nullに設定すると、ページ上に存在するすべてのWijmoコントロールが無効化されます。
HTML要素で存在するすべてのWijmoコントロールを更新する。
コントロールが時間おいて更新される代わりに直ちに更新されること以外はinvalidateAll メソッドと同様です。
コンテナー要素。nullに設定すると、ページ上に存在するすべてのWijmoコントロールが無効化されます。
ユーザーが列ヘッダセルの右端をダブルクリックして列のサイズを自動設定した後に発生します。
ユーザーが行ヘッダセルの下端をダブルクリックして行のサイズを自動設定した後に発生します。
ユーザーが列ヘッダセルの右端をダブルクリックして列のサイズを自動設定する前に発生します。
ユーザーが行ヘッダセルの下端をダブルクリックして行のサイズを自動設定する前に発生します。
セルが編集モードに入る前に発生します。
ハンドラーのパラメーターの 'data'プロパティには、グリッドを編集モードにさせたDOMイベントへの参照が含まれています。
このイベントハンドラでは、編集操作をキャンセルできます。
セル編集が確定またはキャンセルされたときに発生します。
セル編集が終了するときに発生します。
このイベントを使用して検証を実行し、無効な編集を防ぐことができます。 たとえば、次のコードは、ユーザーが文字「a」を含まない値を入力できないようにします。 このコードは、編集が適用される前に、編集前と編集後の値を取得する方法を示しています。
function cellEditEnding(flex, e) {
// 編集前と編集後の値を取得します
let oldVal = flex.getCellData(e.row, e.col),
newVal = flex.activeEditor.value;
// newValに「a」が含まれていない場合は、編集をキャンセルします
e.cancel = newVal.indexOf('a') <lt; 0;
}
CellEditEndingEventArgs.cancel パラメータをtrueに設定すると、編集された値が無視されて、 グリッドでセルの元の値が維持されます。
また、CellEditEndingEventArgs.stayInEditMode パラメータをtrueに設定すると、 グリッドの編集モードが維持され、編集をコミットする前にユーザーが無効な値を修正できます。
collapsedHeaders プロパティの値が変化した後に発生します。
collapsedHeaders プロパティの値が変化した後に発生します。
列グループが展開または折りたたまれた後に発生します。
ハンドラーのパラメーターの 'data'プロパティには、変更されるColumnGroupへの参照が含まれています。
列グループが展開または折りたたまれる直前に発生します。
ハンドラーのパラメーターの 'data'プロパティには、変更されるColumnGroupへの参照が含まれています。
ユーザーがいずれかのクリップボードショートカットキーを押して選択されている内容をクリップボードにコピーした後に発生します(autoClipboard プロパティを参照)。
ユーザーがいずれかのクリップボードショートカットキーを押して選択されている内容をクリップボードにコピーするときに発生します(autoClipboard プロパティを参照)。
イベントハンドラでコピー操作をキャンセルできます。
ユーザーが[Del]キーを押して行を削除した後に発生します (allowDelete プロパティを参照)。
ユーザーが[Delete]キーを押して選択されている行を削除するときに発生します(allowDelete プロパティを参照)。
イベントハンドラで行の削除をキャンセルできます。
ユーザーが列のドラッグを完了したときに発生します。
ユーザーが行のドラッグを完了したときに発生します。
ユーザーが列のドラッグを開始するときに発生します。
ユーザーが列を別の位置にドラッグするときに発生します。
ハンドラは、このイベントをキャンセルして、ユーザーが特定の位置に列をドロップしないようにすることができます。 次に例を示します。
// ドラッグされている列を記憶します
flex.draggingColumn.addHandler((s, e) => {
theColumn = s.columns[e.col].binding;
});
// 'sales'列がインデックス0にドラッグされないようにします
s.draggingColumnOver.addHandler((s, e) => {
if (theColumn == 'sales' && e.col == 0) {
e.cancel = true;
}
});
ユーザーが行のドラッグを開始するときに発生します。
ユーザーが行を別の位置にドラッグするときに発生します。
セルを表す要素が作成されたときに発生します。
このイベントを使用してセルを表示用に書式設定できます。このイベントは、目的はitemFormatter プロパティと同じですが、複数の独立したハンドラを使用できる利点があります。
以下のサンプルコードは、グループ行のセルから'wj-wrap'クラスを削除します。
flex.formatItem.addHandler((flex, e) => {
if (flex.rows[e.row] instanceof GroupRow) {
wijmo.removeClass(e.cell, 'wj-wrap');
}
});
コントロールがフォーカスを取得したときに発生します。
グループが展開または折りたたまれた後に発生します。
グループが展開または折りたたまれる直前に発生します。
無効な文字が入力されたときに発生します。
ユーザーが入力した値が適切な種類に変換できない値、または有効な範囲外の値を貼り付ける場合、 無効な入力エラーが発生する場合があります。
イベントハンドラーがイベントをキャンセルする場合、 ユーザーがエラーを修正できるように、 コントロールは無効なコンテンツとフォーカスを保持します。
イベントがキャンセルされない場合、コントロールは無効な入力エラーを無視し、 元のコンテンツを保持します。
グリッドが新しい項目ソースにバインドされた後に発生します。
グリッドが新しい項目ソースにバインドされれ前に発生します。
グリッド行がデータソースの項目に連結された後に発生します。
グリッド行がデータソースの項目に連結される前に発生します。
コントロールがフォーカスを失ったときに発生します。
ユーザーがいずれかのクリップボードショートカットキーを押してクリップボードの内容を貼り付けた後に発生します(autoClipboard プロパティを参照)。
ユーザーがクリップボードの内容をセルに貼り付けた後に発生します(autoClipboard プロパティを参照)。
ハンドラのパラメーターの「data」プロパティには、新しい値が貼り付けられる前のセルの元の値が含まれます。
ユーザーがいずれかのクリップボードショートカットキーを押してクリップボードの内容を貼り付けた時に発生します(autoClipboard プロパティを参照)。
ハンドラーのパラメーターの 'data'プロパティには、グリッドに貼り付けられるテキストのコピーが含まれています。
このイベントハンドラーは、貼り付け操作をキャンセルできます。
ユーザーがクリップボードの内容をセルに貼り付けるときに発生します(autoClipboard プロパティを参照)。
ハンドラーのパラメーターの 'data'プロパティには、セルに貼り付けられるテキストが含まれています。
このイベントハンドラーは、貼り付け操作をキャンセルできます。
1つ以上の列が固定(または固定解除)された後に発生します。
1つ以上の列が固定(または固定解除)される前に発生します。
エディタセルが作成されたとき、それがアクティブになる前に発生します。
イベントハンドラは、グリッドのactiveEditorプロパティを使用してエディター要素にアクセスできます。
コントロールが内容を更新した後で発生します。
コントロールが内容を更新する直前に発生します。
ユーザーが列のサイズ変更を完了したときに発生します。
ユーザーが行のサイズ変更を完了したときに発生します。
列がサイズ変更されるときに発生します。
行がサイズ変更されるときに発生します。
ユーザーが新規行テンプレートを編集して新しい項目を作成したときに発生します(allowAddNew プロパティを参照)。
イベントハンドラで新しい項目の内容をカスタマイズしたり、新しい項目の作成をキャンセルしたりできます。
行編集が確定またはキャンセルされたときに発生します。
行編集が終了するとき、変更が確定またはキャンセルされる前に発生します。
このイベントをrowEditStarted イベントと組み合わせて使用して、 ディープ連結編集を元に戻す操作を実装できます。 次に例を示します。
// 編集の開始時にディープ連結値を保存します
let itemData = {};
s.rowEditStarted.addHandler((s, e) => {
let item = s.collectionView.currentEditItem;
itemData = {};
s.columns.forEach(function (col) {
if (col.binding.indexOf('.') > -1) { // deep binding
let binding = new wijmo.Binding(col.binding);
itemData[col.binding] = binding.getValue(item);
}
})
});
// 編集がキャンセルされたときにディープ連結値を復元します
s.rowEditEnded.addHandler((s, e) => {
if (e.cancel) { // 編集はユーザーによってキャンセルされました
let item = s.collectionView.currentEditItem;
for (let k in itemData) {
let binding = new wijmo.Binding(k);
binding.setValue(item, itemData[k]);
}
}
itemData = {};
});
行が編集モードに入った後に発生します。
行が編集モードに入る前に発生します。
コントロールがスクロールされた後に発生します。
選択が変更された後に発生します。
選択が変更される前に発生します。
ユーザーが列ヘッダをクリックしてソートを適用した後に発生します。
ユーザーが列ヘッダをクリックしてソートを適用する前に発生します。
ハンドラーのパラメーターの 'data'プロパティには、ソートを実行させたDOMイベントへの参照が含まれています。
このイベントハンドラーは、ソートアクションをキャンセルできます。
スター サイズにより1つ以上の列のサイズが変更されたとき。
グリッドで内部レイアウトが更新された後に発生します。
グリッドが現在のビューを構成する要素の作成/更新を完了したときに発生します。
グリッドのビューは以下のような操作に応じて更新されます。
グリッドで内部レイアウトが更新される前に発生します。
現在のビューを構成する要素の作成/更新をグリッドが開始したときに発生します。
FlexGrid コントロールを拡張して、項目ごとに複数の行を提供します。
layoutDefinitionプロパティを使用して、各データ項目の表示に使用する 行のレイアウトを定義します。
MultiRow コントロールでは、カスタム複数行レイアウトと干渉するいくつかの FlexGrid プロパティが無効にされています。 無効なプロパティ(サポートされていない機能)は、以下の通りです。
FlexGrid.allowMerging、FlexGrid.mergeManager、FlexGrid.autoGenerateColumns、FlexGrid.columnGroups、 FlexGrid.allowDragging、FlexGrid.allowPinning、FlexGrid.childItemsPath、FlexGridDetailProvider 、Column.visible また、FlexGrid.columnFooters パネルのセルは複数行レイアウトに従っていないことに注意してください。