4.5.13 (Mar 2008)

DisplayService インターフェースにメソッドを追加 : (int) getUiUpdateFreezeCount()

DisplayService.freezeUiUpdates(true) は、UI DOM の更新を最適化するために、画面の更新を一時的に停止する。 このメソッドの標準的な使い方(パターン)は、DisplayService.freezeUiUpdates(true) で停止した描画を finally ブロックに記述した、 DisplayService.freezeUiUpdates(false) で再開させる方法である。 画面更新の停止がネストしている場合、そのネストした回数をカウンタによって知ることができる。 このカウンタ(フリーズカウンタ)が、0なら描画は停止されておらず、UI DOMを更新するとその更新は、画面に反映されると判断できる。

注意点
標準的な使い方でない場合、フリーズカウンタはマイナスの値を持つこともあるが、その場合も、描画は停止されていないことを意味する。 カウンタがマイナスで、DisplayService.freezeUiUpdates(true) が 呼ばれた場合、描画は停止されない。 標準的な使い方でなくても、このメソッドの利用価値はある。 例えば、イベントによって画面の描画の停止と再開を制御する方法では、このカウンタの値を参照することで描画の状態をつねに把握することができる。 カウンタの値を参照することで、画面が停止していない状態で停止を解除することを避けることもできるし、逆に画面が停止しているときに、さらに停止する処 理を呼び出すことも避けることができる。

新しい属性 "navigationWrapPolicy"

"navigationWrapPolicy" によって、table、 tree、treeTable のcell について、キーボードによるラップ(移動)の振る舞いを指定することができる(この指定は、シングルセレクションモードのときに有効となる)。

次の、4種類の振る舞いがある。

• vertically - row の最後に到達したとき、次の row の最初のcell に移動する。逆方向に移動して、row の最初のcellに移動してきたとき、前のrow の最後のcell に移動する。
• horizontally – column の最後に到達したとき、次の column の最初のcell に移動する。逆方向に移動して、column の最初のcellに移動してきたとき、前のcolumn の最後のcell に移動する。
• always – 水平方向にも垂直方向にもラップする
• never - ラップしない

属性が指定されていない場合のデフォルトの振る舞いは、"always"となる。

新しい属性 "dragIdList"

dragIdList には、ドラッグ対象となるウィジェットのid をコンマで区切りで指定する。 この属性は、マルチドラッグがサポートされているウィジェット(tableのrowと、listItem)に対して有効となる。 dragIdList は、 onDragStart、onDragEnd、onDragDroそれぞれのイベントのパラメータとなる。これまでは、複数行ドラッグしても、ひとつの dragId だけしか利用できなかった。

デバッグログの変更

Platform 4.5.8 で機能していなかったデバッグログは、Platform 4.5.13 で再び動作するようになった。デバッグログは、nexaweb-client.xml で設定する。

注意点
ログ名は、 "XUpdate" から "XModify" となった。

IME バッファに関する問題

onBeforeActiveLost() でsetAttribute() を呼び出したときにIMEのバッファがクリアされない問題があった。 onBeforeActiveLost()ハンドラで textField の text属性がリセットされたとき、テキストが確定されていない状態でIMEのバッファをクリアするよう修正した。 確定されていないテキストは、再び入力を開始しても表示されなくなる。

"XUpdate" のログ(modificationsログ)名を"XModify"に変更した

XMLの更新で記録されるログ名をXModifyに変更した。 これまでロギングは、実装したクラスに関連して、"XUpdate"が利用されていたが、今後は"XModify"とする。 クライアントサイドでログを記録する場合、nexaweb-client.xmlで、"XUpdate"を指定せず、"XModify"を指定する。

nexaweb-client.xmlのロギング設定の例:
<log name="XModify" log-level="debug"/>

onStateChange の振る舞いを変更

dragIdList を新規に追加したことで、onStateChange と listBox、table、treeTableを選択したときの振る舞いを見直す必要があった。 onStateChangeは、ウィジェットが実際に変化したとき(例えば、選択された状態が変化したとき)にのみ発生する。 単一のウィジェットが選択されているだけでは、そのウィジェットで何度マウスクリックがあっても、onStateChangeは発生しない。 しかし、マルチプル(複合)ウィジェットが選択されているときの状態の変化については、その振る舞いは異なる。 マルチプルウィジェットが選択された状態で、onMouseDown が発生した場合、どのウィジェットも選択状態は解除されない。 しかし、その後 onMouseUp が発生し、他のすべてのウィジェットの選択状態が解除されたときは、クリックされたウィジェットの状態は変化せず、選択された状態のままとなる。

マルチプルウィジェットが選択された状態で、その中のひとつのウィジェットを CTRL + マウスクリック(mouse down)すると、 そのウィジェットの選択は解除され、onStateChange イベントが発生する。 マルチプルウィジェットではなく、ひとつのウィジェットだけが選択されている状態でも、そのウィジェットの選択は解除され、onStateChange イベントが発生する。

onStateChange の振る舞いについて、これまでの動作との互換性を保つための設定をnexaweb-client.xml で指定することができる。 これまでの動作では、選択状態の row、cell、listItemでクリックするとonStateChangeが発生した。次のフラグを "true" にすることで、この動作と互換性を保つことができる。

nexaweb-client.xmlの互換性指定フラグ:
ensure-pre-bugfix-table-statechange-behavior-onmousedown

注意点
このフラグによりこれまでの動作を継続させることができるが、つぎのような振る舞いについては変更を加えた。
<table/> の選択モードが、multiCell か multiRow のとき、互換性指定フラグが設定されていれば、マウスダウンで<table/>に対して onStateChange が発生する。 しかし、他の row や cell の選択状態は解除されないので、複数のウィジェットの id がイベントに通知される。 また、マウスをリリースすると他の row や cell の選択状態は解除される。そのとき、選択した単一の row の状態が変化しそれを反映して、新しくonStateChange が発生する。

selectionMode="singleRow" でラップしない

selectionMode="singleRow" が設定されている table で、矢印キーで垂直方向にラップし水平に移動(セルをたてに循環しながらカラムを移動)しないようになった。 最終行を選択し、下矢印キーを押しても最初の行に戻ることはなく選択状態も変わらない。 また、最初の行を選択肢、上矢印キーを押しても最終行に移動することはなく選択状態も変わらない。