これは、Wijmo API（Wijmoが提供するaddEventListener）です。JavaScript APIの「addEventListener」メソッドとは異なります。 イベントに関しては、こちらの「ヘルプ」もご参照ください。 コントロールは、アタッチされているリスナーとそのハンドラのリストを内部で保持し、 コントロールが破棄されるときにそれらを簡単に削除することができます。 不要なイベントリスナーは、dispose あるいはremoveEventListener メソッドを使用して削除するようにしてください。

Wijmoが提供するイベントリスナーを削除しないと、メモリリークが発生する可能があります。 なお JavaScript APIが提供するaddEventListenerは、Wijmoのdisposeメソッドでは破棄されません。 しかし、メモリの破棄はブラウザ（エンジン）が使用しているガベージコレクションメカニズムに依存します。 WijmoのdisposeメソッドはグリッドのhostElementのinnerHTMLを削除するため、disposeメソッドを呼び出すことで、 ブラウザのガベージコレクションメカニズムに応じてすべてのイベントリスナーがメモリから削除されます。 Wijmo APIとJavaScript APIでaddEventListenerがどのように使用されるかは以下をご参照ください。

// JavaScriptのaddEventListenerメソッドを使用してイベントを追加します。
// これは、FlexGridオブジェクトの内部配列（追加されたすべてのイベントリスナーの配列）には保持されません。
// disposeメソッドがFlexGridのhostElementのinnerHTMLを上書きすると削除されます。
flexGrid.hostElement.addEventListener("keydown", handleKeydown, true);
// Wijmoが提供するaddEventListenerメソッドを使用してイベントを追加します。
// これは、FlexGridオブジェクトの内部配列（追加されたすべてのイベントリスナーの配列）に保持されます。
// disposeメソッドが内部的にWijmo APIのremoveEventListenerメソッドを呼び出すと削除されます。
flexGrid.addEventListener(flexGrid.hostElement, 'keydown', customKeyDownFunctionality);

また、デフォルトでは、passive パラメータはfalseに設定されています。

これはイベントハンドラが event.preventDefault() を呼び出すことを意味します。 タッチイベントまたはマウスホイールイベントにpassiveハンドラを追加する場合は、 このパラメータをtrueに設定するとアプリケーションのパフォーマンスが向上します。

passive　イベントリスナーの詳細については、「パッシブリスナーによるスクロールの性能改善」を参考してください。

このメソッドは、テンプレート化されたコントロールのコンストラクターによって呼び出される必要があるため、 このメソッドを使用することができません。 また、テンプレートのパーツを対応するコントロールのメンバに連結します。

以下のサンプルコードは、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 ホスト要素にちなんで名付けられたパーツの名前。 これにより、コントロールがフォームで使用されたときにデータをどのように送信するかが決まります。

この関数の実行が完了するまでコントロールは更新されません。 このメソッドは、関数が例外を生成した場合でも endUpdate が呼び出されるようにします。

なお、Wijmoのdispose メソッドでは、JavaScript APIが提供する「addEventListener」で追加されたイベントリスナーは破棄されません。 しかし、メモリの破棄はブラウザ（エンジン）が使用しているガベージコレクションメカニズムに依存します。 WijmoのdisposeメソッドはグリッドのhostElementのinnerHTMLを削除するため、disposeメソッドを呼び出すことで、

ブラウザのガベージコレクションメカニズムに応じてすべてのイベントリスナーがメモリから削除されます。 例

flexGrid.dispose();
                 ``````

このメソッドは、クラス階層をさかのぼってコントロールのテンプレートを指定する最も近い祖先を探します。 たとえば、ComboBox コントロールのプロトタイプを指定した場合、 そのプロトタイプによってDropDown 基本クラスで定義されたテンプレートがオーバーライドされます。

このメソッドを使用すると、各プロパティの値をコードで設定する代わりにプレーンなデータオブジェクトを使用してコントロールを初期化できます。

例:

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;
// など

初期化データは適用時に型チェックされます。 初期化オブジェクトに不明なプロパティ名または無効なデータ型が含まれている場合、このメソッドは例外を発生します。

イベントハンドラーがイベントをキャンセルした場合、コントロールは無効な入力内容とフォーカスを保持します。