コンポーネントは、テキストボックス、コンボボックスなど、システムのユーザが直接操作する部品（コントロール）です。
コンポーネントは、Swingのそれを機能拡張した形で提供されます。
(したがってコンポーネントは、Swingの制限(不具合)に依存しますのでご了承ください。)
コンポーネントは、(ロジッククラスの実行による)イベントハンドリング、(トランザクションの実行による)サーバとの交信、(標準チェックの実行による)データの妥当性チェックの機能を持ちます。
コンポーネントの属性は、Client Application Management Consoleのコンポーネントタブの属性で設定します。ロジッククラス内からSwingのメソッドを直接呼び出すことによって設定することも可能です。
コンポーネントタブの属性の詳細はコンポーネント属性を参照してください。
これらコンポーネントの設定は方法はClient Application Management Consoleを参照してください。
また、コンポーネント作成のインターフェースは現在提供しておりません。独自のコンポーネントを使用したい場合にはフレームインターフェースにて実装するかメディア情報技術(株)までご相談ください。
- テキストフィールド (jp.ne.mki.wedge.run.client.component.text.DefaultTextField)
- バイト制限付テキストフィールド (jp.ne.mki.wedge.run.client.component.text.limited.ByteLimitedTextField)
Data Management Consoleのデータ型の長さをバイト数と捉え、それ以上の入力は受け付けないコンポーネント
注意このコンポーネント使用時は、チェッククラスのリアルタイムチェックは使用できません。
- 桁数制限付テキストフィールド (jp.ne.mki.wedge.run.client.component.text.limited.LengthLimitedTextField)
Data Management Consoleのデータ型の長さを文字数と捉え、それ以上の入力は受け付けないコンポーネント
注意このコンポーネント使用時は、チェッククラスのリアルタイムチェックは使用できません。
- フォーマットテキストフィールド (jp.ne.mki.wedge.run.client.component.text.DefaultFormattedTextField)
MaskFormatが使用できるコンポーネント
フォーマットクラスを指定したアイテムを使用することにより入力補助的としてのMaskを指定することが出来ます。
詳しくは フォーマット使用方法 を参照して下さい。
since:ver1.1.3
| Before |
Focus取得時 |
| After |
Focus紛失前(他のコンポーネントに制御が移る前) |
- パスワードテキストフィールド (jp.ne.mki.wedge.run.client.component.text.DefaultPasswordField)
- バイト制限付パスワードフィールド (jp.ne.mki.wedge.run.client.component.text.ByteLimitedPasswordField)
Data Management Consoleのデータ型の長さをバイト数と捉え、それ以上の入力は受け付けないコンポーネント
注意このコンポーネント使用時は、チェッククラスのリアルタイムチェックは使用できません。
- 桁数制限付パスワードフィールド (jp.ne.mki.wedge.run.client.component.text.LengthLimitedPasswordField)
Data Management Consoleのデータ型の長さを文字数と捉え、それ以上の入力は受け付けないコンポーネント
注意このコンポーネント使用時は、チェッククラスのリアルタイムチェックは使用できません。
| Before |
Focus取得時 |
| After |
Focus紛失前(他のコンポーネントに制御が移る前) |
- テキストエリア (jp.ne.mki.wedge.run.client.component.text.DefaultTextArea)
- 折返しテキストエリア (jp.ne.mki.wedge.run.client.component.text.LineCuffTextArea)
割当て幅に収まりきらない長さの行はワード境界 (空白部分) で折返されます。
- バイト制限付テキストエリア (jp.ne.mki.wedge.run.client.component.text.limited.ByteLimitedTextArea)
Data Management Consoleのデータ型の長さをバイト数と捉え、それ以上の入力は受け付けないコンポーネント
- 桁数制限付テキストエリア (jp.ne.mki.wedge.run.client.component.text.limited.LengthLimitedTextArea)
Data Management Consoleのデータ型の長さを文字数と捉え、それ以上の入力は受け付けないコンポーネント
| Before |
Focus取得時 |
| After |
Focus紛失前(他のコンポーネントに制御が移る前) |
jp.ne.mki.wedge.run.client.component.button.DefaultButton
「javax.swing.JButton」を拡張した、プッシュボタンのコンポーネントです。
プッシュ動作 は マウスクリック や SPACEキー押下 などにより行うことができます。
必要なアイテム
このコンポーネントは、1つのアイテムと関連付けます。
ボタンクリック時に アイテム の Before,After 処理が実行されます。
コンポーネント取得方法
ロジッククラスにてコンポーネントを取得するには、アイテムの「getComponent()」を使用します。
取得した「JComponent」を javax.swing.JButton にキャスト可能です
IME自動設定
フォーカス取得時は 英数半角入力モード になります。
補足
SwingJButtonの特性上、IME起動中は SPACEキーによるボタンクリック は行うことができません。
そのため、本製品では フォーカス取得のタイミングにて 英数半角入力モード の切替をおこないますが、
フォーカス取得後に 任意にIME起動した場合は SPACEキーによるボタンクリック は行えないことに注意してください。
- ボタン (jp.ne.mki.wedge.run.client.component.button.DefaultButton)
- 終了ボタン (jp.ne.mki.wedge.run.client.component.button.ExitButton)
フォーカスの遷移なしで反応するボタンです。
それにより、チェック＆Afterの処理は行わずに動作します。
基本的に画面終了などの処理割り当て、何も処理を介さず画面を閉じるなどに使用します。
処理が終了しても画面が存在したまま(画面終了がキャンセルされた)の時は、元々フォーカスが在ったコンポーネント
(After処理が未処理のコンポーネント)にフォーカスが残ったままになります。
「フォーカス移動処理」を入れてもフォーカスは移動しません。
理由として、直前のAfter実行なしのままフォーカス移動をすると 画面内に 「After未実行」のものが存在することになり、画面の
整合性が取れなくなる可能性があるためです。もし、画面内データの整合性を内部ロジックであわせてからフォーカス移動をする
"クリア処理"のような仕様であれば、下記の Clearボタン を使用するようにして下さい。
また、Tabによるフォーカス移動の際にもフォーカス取得は行いません。
- Clearボタン (jp.ne.mki.wedge.run.client.component.button.ClearButton)
フォーカス取得をせずに動作するボタンです。これにより、チェック＆Afterの処理は行わずに処理を行う事が可能です。
このコンポーネントは「フォーカス移動処理」を設定可能です。これがExitButtonの一番大きな差になります。
使用用途としては"取消ボタン"など、アプリケーション内部により整合性のある保証をするので「Afterは実行しない」というものに
使用して下さい。
また、Tabによるフォーカス移動の際にもフォーカス取得は行いません。
- プレスボタン (jp.ne.mki.wedge.run.client.component.button.ActionAtPressedButton)
通常ボタンは MouseRelease の際 もしくは (SPACE)KeyRelease の際に Action動作を行いますが、このボタンは MousePress、KeyPress
のタイミングにて Action動作 を行います。
Pressのタイミングで処理がおこなわれるため、マウスによる"ボタンクリックキャンセル動作"は行う事ができません。
SpaceKeyなどを押しつづけるとボタンのAction(Before,After)が複数回実行されます。(この動きはOSにより異なる場合があります。)
Modalの画面終了ボタンに使用した場合では、その後にフォーカス移動処理が含まれていてもフォーカス移動が行えない場合があります。
これは画面の終了タイミングが通常のボタンより早くなってしまうため親画面にフォーカスが当たる処理が実行される前にフォーカス移動処理が走ってしまう為になります。
その他、通常ボタンとの仕様の差のため動作差が発生する場合があります。ご了承の上お使いください。
補足プレスボタンが追加された目的は、Ver1.1.X (JDK1.4) 使用時 ボタン押下により発生するフォーカス移動処理にて直前のAfterが重い処理で、
MouseReleaseのタイミングが After処理終了に間に合わなかった場合、通常ボタンでは
Action実行なしになるのを回避するためでしたが、
Ver1.2.0(JDK1.5.0) 以降では 通常の ボタン でも
Action実行あり になるため、このボタンを特に使用する必要はありません。
補足
マウスによる"ボタンクリックキャンセル動作" とは、ボタンに対して MousePress を行い、ドラッグしつつボタン外に移動してから MouseRelease をする動作になります。
| Before |
Click時 |
| After |
Click時 |
jp.ne.mki.wedge.run.client.component.checkbox.DefaultCheckBox
「javax.swing.JCheckBox」を拡張した、チェックボックスのコンポーネントです。
プッシュ動作 は マウスクリック や SPACEキー押下 などにより行うことができます。
選択あるいは選択解除できる項目の実装で、その状態を表示します。
必要なアイテム
このコンポーネントは、1つのアイテムと関連付けます。入力されたデータは、そのアイテムに格納されます。
チェックされると「1」が、チェックされなかったら「0」がデータに設定されます。
ただし、アイテム/基本データ の「ENUM」 が設定されている場合は、チェックされると「ENUM」の一番目の値が、チェックされなかったら2番目の値が設定されます。
|
チェックあり |
チェックなし |
| ENUM設定あり |
ENUMの一番目の値 |
ENUMの二番目の値 |
| ENUM設定なし |
1 |
0 |
コンポーネント取得方法
ロジッククラスにてコンポーネントを取得するには、アイテムの「getComponent()」を使用します。
取得した JComponent を javax.swing.JCheckBox にキャスト可能です
- チェックボックス (jp.ne.mki.wedge.run.client.component.checkbox.DefaultCheckBox)
- プレスチェックボックス (jp.ne.mki.wedge.run.client.component.checkbox.ActionAtPressedCheckBox)
通常チェックボックスは MouseReleaseの際 もしくは (SPACE)KeyReleaseの際に Action動作を行いますが、このチェックボックスは MousePress、KeyPress
のタイミングにて Action動作 を行います。
Pressのタイミングで処理がおこなわれるため、マウスによる"ボタンクリックキャンセル動作"は行う事ができません。
SpaceKeyなどを押しつづけるとチェックボックスのAction(Before,After)が複数回実行されます。(この動きはOSにより異なる場合があります。)
Modalの画面終了ボタンに使用した場合では、その後にフォーカス移動処理が含まれていてもフォーカス移動が行えない場合があります。
これは画面の終了タイミングが通常のボタンより早くなってしまうため親画面にフォーカスが当たる処理が実行される前にフォーカス移動処理が走ってしまう為になります。
その他、通常ボタンとの仕様の差のため動作差が発生する場合があります。ご了承の上お使いください。
通常は チェックボックス を使用するようにしてください。
補足プレスチェックボックスが追加された目的は、Ver1.1.X (JDK1.4) 使用時 ボタン押下により発生するフォーカス移動処理にて直前のAfterが重い処理で、
MouseReleaseのタイミングが After処理終了に間に合わなかった場合、通常チェックボックスでは
Action実行なしになるのを回避するためでしたが、
Ver1.2.0(JDK1.5.0) 以降では 通常の チェックボックス でも
Action実行あり になるため、このボタンを特に使用する必要はありません。
| Before |
クリック時：値設定前 |
| After |
クリック時：値設定後 |
jp.ne.mki.wedge.run.client.component.combobox.DefaultComboBox
「javax.swing.JComboBox」を拡張した、コンボボックスのコンポーネントです。
コンボボックスとは、ボタン、または編集可能フィールドとドロップダウンリストを組み合わせたコンポーネントです。
ユーザは要求に応じて表示されるドロップダウンリストから値を選択できます。
選択された値と、アプリケーションとして保持したい値が異なる場合･･･例えば、表示は名称だが、選択値として保持したいのは、そのID など
･･･でもそれらの情報をコンボボックスに与える事により選択値が自動的に取得可能になるように拡張されています。
コンボボックスを編集可能にすると、編集可能なフィールドを持つようになり、ユーザが値を自由に入力できるようになります。
必要なアイテム
コンボボックスを画面で使用する場合はアイテムタイプが「TEXT」
「BOXKEY」「BOXDATA」の3種類のアイテムをセットにする必要が有ります。
「BOXKEY」のアイテムには ”コンボボックスが選択された時の値のリスト”、
「BOXDATA」のアイテムには ”コンボボックスに表示される値のリスト” をセットする必要が有ります。
「TEXT」のアイテムには ”コンボボックスが選択された時の値” が自動的にセットされます。
ロジッククラス等から「TEXT」のアイテムに値をセットすると、
「BOXKEY」のアイテムの中から同じ値を探し出し、対応する「BOXDATA」の値を自動で選択状態にします。
コンポーネント取得方法
ロジッククラスにてコンポーネントを取得するには、アイテムの「getComponent()」を使用します。
コンボボックス独自のメソッドが使用したい場合には、取得した「JComponent」を「DefaultComboBox」にキャストして下さい。
(javax.swing.JComboBox にキャストする事も可能です)
TEXTのアイテムは「DefaultComboBox.getItem()」、BOXKEYのアイテムは「DefaultComboBox.getKeyItem()」、BOXDATAのアイテムは「DefaultComboBox.getListItem()」により取得します。
編集可能コンボ since:Version.1.1.0
コンポーネント属性にて、editable=true の設定にすると 編集可能なコンボボックスになります。
編集可能にする為には、コンポーネントの属性にて設定を行ってください。
編集可能なコンボボックスは、入力エディタは「テキストフィールド」になります。Before,Afterの実行は テキストフィールドと同様になります。
表示されるコンボボックスのリストは、BOXDATA のものになり、リスト選択値は エディタに反映されます。
BOXKEYは使用しません
注意
「
BOXKEY」 に 存在しない値 を 「
TEXT」 に設定することはできません。
かならず
BOXKEY に 選択肢となるデータ を設定後、
TEXT に値を設定するようにしてください。
- コンボボックス (jp.ne.mki.wedge.run.client.component.combobox.DefaultComboBox)
- コンボボックスClear (jp.ne.mki.wedge.run.client.component.combobox.ComboBoxClear)
DeleteKeyを押されたとき、選択内容をクリアする
(編集可能はコンボボックスでは使用できません)
- Formattedコンボボックス (jp.ne.mki.wedge.run.client.component.combobox.FormattedEditorComboBox)
編集可能コンボボックスの際(editable=true)、入力テキスト部が FormattedTextField になる コンボボックスです。
MaskFormatをかけたい場合に使用します。since:Version.1.1.3
アイテムタイプがBOXKEYのアイテム
- 編集不可
| Before |
ポップアップ表示時 |
| After |
ポップアップが閉じた時 かつ 値が変更されていた時 もしくは KeyBindより値を変えられたとき(Endキーなど) |
- 編集可能
| Before |
Focus取得時 |
| After |
Focus紛失前(他のコンポーネントに制御が移る前) |
jp.ne.mki.wedge.run.client.component.list.DefaultList
「javax.swing.JList」を拡張した、リストボックスのコンポーネントです。
ユーザは、表示リストから任意の行を選択することにより、値を設定します。
選択された値と、アプリケーションとして保持したい値が異なる場合･･･例えば、表示は名称だが、選択値として保持したいのは、そのID など
･･･でもそれらの情報をコンボボックスに与える事により選択値が自動的に取得可能になるように拡張されています。
必要なアイテム
リストを画面で使用する場合はアイテムタイプが「TEXT」
「BOXKEY」「BOXDATA」の3種類のアイテムをセットにする必要が有ります。
「BOXKEY」のアイテムには ”リストボックスが選択された時の値のリスト”、
「BOXDATA」のアイテムには ”リストボックスに表示される値のリスト” をセットする必要が有ります。
「TEXT」のアイテムには ”リストボックスが選択された時の値” が自動的にセットされます。
ロジッククラス 等から「TEXT」のアイテムに値をセットすると、BOXKEYのアイテムの中から同じ値を探し出し、
対応するBOXDATAの値を自動で選択状態にします。
コンポーネント取得方法
ロジッククラスにてコンポーネントを取得するには、アイテムの「getComponent()」を使用します。
リスト独自のメソッドが使用したい場合には、取得した「JComponent」を「DefaultList」にキャストして下さい。
(javax.swing.JList にキャストする事も可能です)
TEXTのアイテムは「DefaultList.getItem()」、BOXKEYのアイテムは「DefaultList.getKeyItem()」、BOXDATAのアイテムは「DefaultList.getListItem()」により取得します。
- アイテムタイプがBOXKEYのアイテム
| Before |
Focus取得時 |
| After |
Focus紛失前(他のコンポーネントに制御が移る前) |
jp.ne.mki.wedge.run.client.component.button.DefaultToggleButton
「javax.swing.JToggleButton」を拡張した、トグルボタンのコンポーネントです。
グループ化内トグルボタンでは、常に1つ選択された状態になります。
(初期値設定無し時は、初期状態では選択は無し という状態になります。)
必要なアイテム
選択された値を保持するアイテムを1つ用意し、グループアイテムとして登録します。(Client Application Management Console/グループ 参照)
GUIより選択変更されると、グループアイテムの値が自動的に変更されます。
また、プログラム内部より グループアイテム の値が変更されると、GUI上の選択状態も自動的に変更されます。
コンポーネント取得方法
グループで割当てたアイテムに、コンポーネントと値のセットで設定した値がセットされます。
ロジッククラスにてコンポーネントを取得するには、アイテムの「getComponent()」を使用します。
リスト独自のメソッドが使用したい場合には、取得した「JComponent」を「DefaultTiggleButton」にキャストして下さい。
(javax.swing.JToggleButton にキャストする事も可能です)
グループ化している場合、グループのアイテムは、「DefaultToggleButton.getGroupItem()」にて取得します。
補足
初期値設定無しの場合、初期状態では、グループのボタンは 1 つも選択されていません。
一度選択状態にした ラジオボタン(グループ) に対して 「選択状態なし」の状態にする事はできません。
1つも選択されていない状態にするためには、表示不可(Visible=false)にしたボタンを作成し、そのボタンを選択状態に
することにより見かけ上実装が可能です。
詳細は JDK APIドキュメント：javax.swing.ButtonGroup を参照して下さい。
- トグルボタン (jp.ne.mki.wedge.run.client.component.button.DefaultToggleButton)
- プレストグルボタン (jp.ne.mki.wedge.run.client.component.button.ActionAtToggleButton)
通常トグルボタンは MouseReleaseの際 もしくは (SPACE)KeyReleaseの際に Action動作を行いますが、このトグルボタンは MousePress、KeyPress
のタイミングにて Action動作 を行います。
Pressのタイミングで処理がおこなわれるため、マウスによる"ボタンクリックキャンセル動作"は行う事ができません。
SpaceKeyなどを押しつづけるとトグルボタンのAction(Before,After)が複数回実行されます。(この動きはOSにより異なる場合があります。)
Modalの画面終了ボタンに使用した場合では、その後にフォーカス移動処理が含まれていてもフォーカス移動が行えない場合があります。
これは画面の終了タイミングが通常のボタンより早くなってしまうため親画面にフォーカスが当たる処理が実行される前にフォーカス移動処理が走ってしまう為になります。
その他、通常ボタンとの仕様の差のため動作差が発生する場合があります。ご了承の上お使いください。
通常は トグルボタン を使用するようにしてください。
補足トグルボタンが追加された目的は、Ver1.1.X (JDK1.4) 使用時 ボタン押下により発生するフォーカス移動処理にて直前のAfterが重い処理で、
MouseReleaseのタイミングが After処理終了に間に合わなかった場合、通常トグルボタンでは
Action実行なしになるのを回避するためでしたが、
Ver1.2.0(JDK1.5.0) 以降では 通常の トグルボタン でも
Action実行あり になるため、このボタンを特に使用する必要はありません。
- グループのアイテム
| Before |
Focus取得時 |
| After |
値変更時 |
- アイテム
jp.ne.mki.wedge.run.client.component.button.DefaultRadioButton
「javax.swing.JRadioButton」を拡張した、ラジオボタンのコンポーネントです。
グループ化内ラジオボタンでは、常に1つ選択された状態になります。
(初期値設定無し時は、初期状態では選択は無し という状態になります。)
必要なアイテム
選択された値を保持するアイテムを1つ用意し、グループアイテムとして登録します。(Client Application Management Console/グループ 参照)
GUIより選択変更されると、グループアイテムの値が自動的に変更されます。
また、プログラム内部より グループアイテム の値が変更されると、GUI上の選択状態も自動的に変更されます。
コンポーネント取得方法
ロジッククラスにてコンポーネントを取得するには、アイテムの「getComponent()」を使用します。
ラジオ独自のメソッドが使用したい場合には、取得した「JComponent」を「DefaultRadioButton」にキャストして下さい。
(javax.swing.JRadioButton にキャストする事も可能です)
グループ化している場合、グループのアイテムは、「DefaultRadioButton.getGroupItem()」にて取得します。
補足
初期値設定無しの場合、初期状態では、グループのボタンは 1 つも選択されていません。
一度選択状態にした ラジオボタン(グループ) に対して 「選択状態なし」の状態にする事はできません。
1つも選択されていない状態にするためには、表示不可(Visible=false)にしたボタンを作成し、そのボタンを選択状態に
することにより見かけ上実装が可能です。
詳細は JDK APIドキュメント：javax.swing.ButtonGroup を参照して下さい。
- ラジオボタン (jp.ne.mki.wedge.run.client.component.button.DefaultRadioButton)
- プレスラジオボタン (jp.ne.mki.wedge.run.client.component.button.ActionAtRadioButton)
通常ラジオボタンは MouseReleaseの際 もしくは (SPACE)KeyReleaseの際に Action動作を行いますが、このラジオボタンは MousePress、KeyPress
のタイミングにて Action動作 を行います。
Pressのタイミングで処理がおこなわれるため、マウスによる"ボタンクリックキャンセル動作"は行う事ができません。
SpaceKeyなどを押しつづけるとラジオボタンのAction(Before,After)が複数回実行されます。(この動きはOSにより異なる場合があります。)
Modalの画面終了ボタンに使用した場合では、その後にフォーカス移動処理が含まれていてもフォーカス移動が行えない場合があります。
これは画面の終了タイミングが通常のボタンより早くなってしまうため親画面にフォーカスが当たる処理が実行される前にフォーカス移動処理が走ってしまう為になります。
その他、通常プレスラジオボタンとの仕様の差のため動作差が発生する場合があります。ご了承の上お使いください。
通常は ラジオボタン を使用するようにしてください。
補足プレスラジオボタンが追加された目的は、Ver1.1.X (JDK1.4) 使用時 ボタン押下により発生するフォーカス移動処理にて直前のAfterが重い処理で、
MouseReleaseのタイミングが After処理終了に間に合わなかった場合、通常ラジオボタン では
Action実行なしになるのを回避するためでしたが、
Ver1.2.0(JDK1.5.0) 以降では 通常の ラジオボタン でも
Action実行あり になるため、このボタンを特に使用する必要はありません。
- グループのアイテム
| Before |
Focus取得時 |
| After |
値変更時 |
- アイテム
jp.ne.mki.wedge.run.client.component.table.DefaultTable
「javax.swing.JTable」を拡張した、
複数列、複数行に渡って 入力・表示 が可能な グリッドコンポーネントです。
必要なアイテム
1列に付き、1つのアイテムが必要です。
各列のアイテムとテーブルとの紐付けは、Client Application Management Console：テーブル タブにて別途登録する必要があります。
列アイテムの行数は同じにする必要があります。
GUIからの 行追加、行削除 などを行った場合には、"非表示列も含め" 各列アイテムに対して同等の処理を行われます。
コンポーネント取得方法
ロジッククラスにてコンポーネントを取得するには、アイテムの「getComponent()」を使用します。
テーブル独自のメソッドが使用したい場合には、取得した「JComponent」を「DefaultTable」にキャストして下さい。
(javax.swing.JTable にキャストする事も可能です)
テーブル内セルのコンポーネントは、
セルエディタ と セルレンダラ という 2つのコンポーネントの組合せで動作しています。(Swingデフォルト)
セルエディタ と セルレンダラ の説明は 後述の説明をご覧下さい。
入力位置
「データタイプ」にて数値・日付・日付時刻・時刻が選択されている場合には右寄せ、それ以外は左寄せになります。
(コンポーネント属性 / TextPosition が指定されている場合を除く)
IME自動設定
フォーカス取得時に「データ型」にて
JAPANESEが選択されている場合にはひらがな入力モード(InputSubset.KANJI)、
HALF_KANAが選択されている場合には半角カナモード(InputSubset.HALFWIDTH_KATAKANA)、
FULL_ALPHABETが選択されている場合には全角英数字モード(InputSubset.FULLWIDTH_LATIN)、
それ以外は英数半角入力モードになります。
データにフォーマットが指定されている場合には、セルレンダラにフォーマットされた値が表示されます。セルレンダラには入力値(フォーマットされていない値)になります。
項目チェックを実行する設定の場合には、編集終了時にデータ型の値に基づきチェックが実行されます。但しこのタイミングでは省略不可チェックは行いません。(省略不可チェックはトランザクションの標準チェックにて行います)
補足テーブルにて公開しているインターフェースは
jp.ne.mki.wedge.run.client.event.TableInterfaceになります。
DefaultTableにしかないメソッドにアクセスする場合には TableInterface 経由にてアクセスするようにしてください。
TableInterface 経由でないメソッドの場合、バージョンアップ や 不具合修正 の際に 削除 や 動作変更 などの 仕様変更が 行われる
可能性があり、各メソッドの永続的な保障は行われません。予めご了承ください。
- テーブル (jp.ne.mki.wedge.run.client.component.DefaultTable)
- 列のアイテム
補足この動作タイミングは、列に設定されている セルエディタ に依存します。
- テーブルの行
| クリック |
テーブル行Click時 |
| ダブルクリック |
テーブル行DoubleClick時 |
補足編集可能なセル に対してはクリックイベントは発生しません。(クリック動作により編集開始動作になるため)
注意テーブルの場合、「フォーカスが入ったタイミング」と「編集が始まったタイミング」、「フォーカスが出たタイミング」と「編集が終わったタイミング」を混同しない様に注意して下さい。「フォーカスが入ったタイミング」「フォーカスが出たタイミング」で何か動作を設定する事は出来ません。
jp.ne.mki.wedge.run.client.component.panel.DefaultPanel
Componentを格納するコンテナです。
- パネル (jp.ne.mki.wedge.run.client.component.panel.DefaultPanel)
- ボーダーパネル (jp.ne.mki.wedge.run.client.component.panel.BorderPanel)
ボーダー付のパネルです。ボーダーはEtchedLoweredになります。
- スクロールパネル (jp.ne.mki.wedge.run.client.component.panel.ScrollPanel)
スクロールバー付のパネルです。全ての子コンポーネントが表示できるようにスクロールが設定されます。
- タイトルパネル (jp.ne.mki.wedge.run.client.component.panel.TitlePanel)
表示文字列の文字列が、タイトルとして表示されます。タイトル文字の フォント・文字位置・前景色 は、パネルの属性が反映されます。
但し、背景色の設定はできません。
jp.ne.mki.wedge.run.client.component.label.DefaultLabel
文字列を表示します。入力は行えません。
通常は 1行の文字列 が表示されます。HTML 形式 にて文字を指定すると 複数行 の表示も可能です。
- ラベル (jp.ne.mki.wedge.run.client.component.label.DefaultLabel)
- スクロールラベル (jp.ne.mki.wedge.run.client.component.label.ScrollLabel)
スクロールバー付のラベルです。
- データ表示無しラベル (jp.ne.mki.wedge.run.client.component.label.NoPrintDataLabel)
アイテムの割当がある場合でも、「表示文字列」をラベルに表示します。
jp.ne.mki.wedge.run.client.component.tab.DefaultTab
指定されたタイトルを持つタブをクリックすることにより、ユーザがコンポーネントのグループを切替えられるようにするコンポーネントです。
Panelを追加することにより、タブが生成されます。
Tabのタイトルはパネルの論理名が表示されます。
jp.ne.mki.wedge.run.client.component.split.DefaultSplitPane
2 つの コンポーネント を分割するのに使います (2 つだけに分割)。2 つの コンポーネント はユーザが対話的にサイズ変更出来る様になります。
両ペインには パネル を貼り付けてその中に各種GUIコンポーネントを貼り付けるようにして下さい。
レイアウトにて最初に設定されているパネル が LEFT の位置に、後に設定されているパネルが RIGHT の位置に設定されます。
- スプリットペイン(横) (jp.ne.mki.wedge.run.client.component.split.DefaultSplitPane)
- スプリットペイン(縦) (jp.ne.mki.wedge.run.client.component.split.DefaultSplitPane_v)
jp.ne.mki.wedge.run.client.component.tree.DefaultTree
階層データのセットをアウトラインで表示するコンポーネントです。
デフォルトの表示では、アイテムの論理名が ノード に表示され、アイテム内データの値を 子ノード として表示します。
アイテム の 中に アイテムを 含めることにより、階層表示も可能です。
アイテム以外のノードについても ロジッククラス より追加が可能です。
追加するノードは javax.swing.tree.DefaultMutableTreeNode にて作成し、アイテム のデータとして
追加します。
実行エンジンでは、Before,After などの処理実行は行いません。
ノード選択時のイベントにて処理を実行したい場合には、javax.swing.JTree#addTreeSelectionListener などを行い、
イベントをトリガーして処理を組み込んでください。
Example...
//TreeNode を作成 するサンプルコード
Item treeTop = getOutItem(0);
//DefaultMutableTreeNode で ノードオブジェクト作成
DefaultMutableTreeNode node = new DefaultMutableTreeNode("取締役");
node.add(new DefaultMutableTreeNode("佐藤"));
//DefaultMutableTreeNode を アイテム の値 として追加もOK
treeTop.addObject(node);
//複数階層表示にするため、アイテムの中に 子アイテムの参照を追加
getInItem(0).addObject(getInItem(1));
getInItem(0).addObject(getInItem(2));
treeTop.addObject(getInItem(0));
treeTop.addObject(getInItem(3));
treeTop.addObject(getInItem(4));
getInItem(4).addObject("伊藤");
getInItem(4).addObject(getInItem(5));
getInItem(4).addObject(getInItem(6));
jp.ne.mki.wedge.run.client.component.table.editor.*
Table編集時の入力用コンポーネントです。
指定なしの場合には テキストフィールド になります。
入力位置
「データタイプ」にて数値・日付・日付時刻・時刻が選択されている場合には右寄せ、それ以外は左寄せになります。
(コンポーネント属性 / TextPosition が指定されている場合を除く)
IME自動設定
フォーカス取得時に「データ型」にて
JAPANESEが選択されている場合にはひらがな入力モード(InputSubset.KANJI)、
HALF_KANAが選択されている場合には半角カナモード(InputSubset.HALFWIDTH_KATAKANA)、
FULL_ALPHABETが選択されている場合には全角英数字モード(InputSubset.FULLWIDTH_LATIN)、
それ以外は英数半角入力モードになります。
注意
Ver1.1.0より、「マウスクリック時の編集状態可能有無」の判断が変更されました。
セルにフォーカスがある状態であれば、1回のクリックで編集状態になります。セルにフォーカスが無い状態の場合には2回のクリックで編集状態になります。
つまり、1回目のクリックは「セルへのフォーカス移動処理」、2回目のクリックは「セルの編集処理」に割り当てられます。
セル編集状態にて他のセルをクリックされた場合でも、正常に処理が行えるように配慮された為になります。
何回のセルクリックで編集状態にするかどうかの設定はセルエディタでコーディングすることで設定が可能ですが、
1回のクリックにより動作させる方法はSwingの不具合を招く可能性があるためお勧めしていません。
- テキストエディタ (TextFieldEditor)
設定がない場合に設定されるデフォルトのエディタです。
表示コンポーネントはJLabelになりますので、表示がしきれない文字列は .... にて表示されます。
- コンボエディタ (ComboBoxEditor)
データ型のENUMに指定されたリストが表示されます。アイテムの値を設定用に、標準ロジッククラスが提供されています。
- チェックボックスエディタ (CheckBoxEditor)
データ型のENUMに指定された値が設定されます。詳細はチェックボックスを参照ください。
文字列を設定する標準ロジッククラスが提供されています。
- ボタンエディタ (ButtonEditor)
ボタンクリック時点で編集を解除(Afterの実行)が行われます。
文字列を設定する標準ロジッククラスが提供されています。
- ラジオボタンエディタ (RadioButtonEditor)
ボタンクリック時点で、クリックのセルを選択状態にし同列他行のセルを非選択状態にします。
選択状態、非選択状態の切替の際には内部のデータが変更されます。値はチェックボックスと同じ仕様に基づき取得します。
文字列を設定する標準ロジッククラスが提供されています。
- バイト制限付きテキストフィールドエディタ (ByteLimitedTextFieldEditor)
Data Management Consoleのデータ型の長さをバイト数と捉え、それ以上の入力は受け付けないコンポーネント
- 桁数制限付テキストフィールドエディタ (LengthLimitedTextFieldEditor)
Data Management Consoleのデータ型の長さを文字数と捉え、それ以上の入力は受け付けないコンポーネント
jp.ne.mki.wedge.run.client.component.table.renderer.*
Table表示時の表示用コンポーネントです。設定なしの場合は、ラベルになります。
入力位置
「データタイプ」にて数値・日付・日付時刻・時刻が選択されている場合には右寄せ、それ以外は左寄せになります。
(コンポーネント属性 / TextPosition が指定されている場合を除く)
IME自動設定
フォーカス取得時に「データ型」にて
JAPANESEが選択されている場合にはひらがな入力モード(InputSubset.KANJI)、
HALF_KANAが選択されている場合には半角カナモード(InputSubset.HALFWIDTH_KATAKANA)、
FULL_ALPHABETが選択されている場合には全角英数字モード(InputSubset.FULLWIDTH_LATIN)、
それ以外は英数半角入力モードになります。
セルレンダラについては独自で作成が可能です。詳しい情報は コンポーネント / Tableレンダラ を参照して下さい。
- 行番号セルレンダラ (LINENOCELLRENDERER)
データの値に関わらず、行番号を表示します。
- カンマ区切りレンダラ (CommaPauseRenderer)
データの値が数値の場合、カンマ区切り表示します。
- ボタンレンダラ (ButtonRenderer)
エディタもボタンが選択された場合には、Click時にBefore/After処理を行い、セルの編集解除されます。
- コンボボックスレンダラ (ComboBoxRenderer)
データの値をコンボボックス上に表示します。同列のエディタの設定にてコンボボックスが設定されている場合には、選択されているBoxDataの値を取得し表示します。
- チェックボックスレンダラ (CheckBoxRenderer)
データの値を元にチェックボックスの選択有無を判断し表示します。
- ラジオボタンレンダラ (RadioButtonRenderer)
データの値を元にラジオボタンボックスの選択有無を判断し表示します。
- On/Offレンダラ (OnOffRenderer)
データの値が "0" もしくは "false" の場合には ○、"1" もしくは "true" の場合には ● を表示します。
- テキストエリアレンダラ (TextAreaRenderer)
表示コンポーネントをテキストエリアにて表示します。折り返し設定されているためセル内に収まらない文字列は折り返して表示されます。
行の幅は自動的に変更されませんので、折り返した文字列を表示するには、テーブル タブ の 「高さ」により 幅を大きくする必要があります。
各コンポーネントに実装しているインターフェースは以下になります。使用用途により実装しているものが変わります。
- jp.ne.mki.wedge.run.client.event.ComponentInterface
コンポーネントとして標準的に実装が必要なインターフェース。
表示文字列の設定や、前景色・背景色設定などのメソッドがあります。
標準で提供しているコンポーネントは全て実装しています。
- jp.ne.mki.wedge.run.client.event.FocusEventInterface
Tabによるフォーカス移動(Order)関連で実装が必要なインターフェース。
次フォーカスコンポーネントの設定・取得、前フォーカスコンポーネントの設定・取得のメソッドがあります。
Client Application Management Consoleのフォーカス移動順にて指定できるコンポーネントになります。
このインターフェースを実装していないコンポーネントは「フォーカス移動順」に設定できません
- jp.ne.mki.wedge.run.client.event.ExecutableInterface
Before,Afterなどイベント実行対象であるコンポーネントに実装が必要なインターフェース。
このインターフェースを実装しているもののみ、イベントへの割り当てが可能です。
- jp.ne.mki.wedge.run.client.event.GroupInterface
コンポーネントを1つのグループとして扱うもののインターフェース。
ラジオボタン、トグルボタンにて使用しています。
- jp.ne.mki.wedge.run.client.event.ListInterface
1つのコンポーネントに、BoxKey,BoxData,TEXTのアイテムを設定するインターフェース。
コンボボックス、リストボックスにて使用しています。
|
ComponentInterface |
FocusEventInterface |
ExecutableInterface |
GroupInterface |
ListInterface |
| テキストフィールド |
○ |
○ |
○ |
× |
× |
| テキストエリア |
○ |
○ |
○ |
× |
× |
| ボタン |
○ |
○ |
○ |
× |
× |
| チェックボックス |
○ |
○ |
○ |
× |
× |
| コンボボックス |
○ |
○ |
○ |
× |
○ |
| リスト |
○ |
○ |
○ |
× |
○ |
| トグルボタン |
○ |
○ |
○ |
○ |
× |
| ラジオボタン |
○ |
○ |
○ |
○ |
× |
| テーブル(セル) |
○ |
○ |
○ |
× |
× |
| パネル |
○ |
× |
× |
× |
× |
| ラベル |
○ |
× |
× |
× |
× |
| タブ |
○ |
○ |
○ |
× |
× |
| スプリットペイン |
○ |
× |
× |
× |
× |
|
Before |
After |
| テキストフィールド |
Focus取得時 |
Focus紛失前(他のコンポーネントに制御が移る前) |
| パスワードフィールド |
Focus取得時 |
Focus紛失前(他のコンポーネントに制御が移る前) |
| テキストエリア |
Focus取得時 |
Focus紛失前(他のコンポーネントに制御が移る前) |
| ボタン |
押された時 |
押された時 |
| チェックボックス |
値設定前 |
値設定後 |
| コンボボックス |
ポップアップ表示時 |
ポップアップが閉じた時 かつ 値が変更されていた時 もしくは KeyBindより値を変えられたとき(Endキーなど) |
| リスト |
Focus取得時 |
Focus紛失前(他のコンポーネントに制御が移る前) |
| トグルボタン |
値設定前(GroupItem:Focus取得時) |
値設定後(GroupItem:値変更時) |
| ラジオボタン |
値設定前(GroupItem:Focus取得時) |
値設定後(GroupItem:値変更時) |
| テーブル |
編集開始時 |
編集終了時 |
| パネル |
実行なし |
実行なし |
| ラベル |
実行なし |
実行なし |
| タブ |
実行なし |
実行なし |
| スプリットペイン |
実行なし |
実行なし |
|
文字位置設定 |
IME |
| テキストフィールド |
データ型による自動設定 |
データ型による自動設定 |
| パスワードフィールド |
Swingデフォルト(Left) |
データ型による自動設定 |
| テキストエリア |
Swingデフォルト(Left) |
データ型による自動設定 |
| ボタン |
Swingデフォルト(Center) |
英数モード |
| チェックボックス |
Swingデフォルト(Left) |
英数モード |
| コンボボックス |
Swingデフォルト(Left) |
英数モード |
| リスト |
Swingデフォルト(Left) |
英数モード |
| トグルボタン |
Swingデフォルト(Center) |
英数モード |
| ラジオボタン |
Swingデフォルト(Left) |
英数モード |
| テーブル |
レンダラコンポーネントに依存 |
エディタコンポーネントに依存 |
| パネル |
Swingデフォルト |
設定なし |
| ラベル |
Swingデフォルト(Left) |
設定なし |
| タブ |
Swingデフォルト |
設定なし |
| スプリットペイン |
Swingデフォルト |
設定なし |
「javax.swing.JTextArea」を拡張した、複数行のテキストの編集を可能にする、軽量コンポーネントです。