コンポーネントおよびウィジェットの説明と設定
HATS が提供するホスト・コンポーネントとウィジェットは、ホスト画面のエレメントを、Web ページで表示できるオブジェクトに変換するために使用されます。一部のコンポーネント設定およびウィジェット設定は、HATS Toolkit のウィザードやエディターを使用して変更できます。この章では、HATS ホスト・コンポーネント、ウィジェット、および変更可能な設定について説明します。
HATS ウィザードを使用して、ユーザー独自のカスタム・コンポーネントおよびウィジェットを作成することもできます。ウィザードを起動するには、「HATS」メニューから「HATS」>「新規」>「コンポーネント」または「HATS」>「新規」>「ウィジェット」を選択します。「ファイル」>「新規」>「HATS コンポーネント」または「ファイル」>「新規」>「HATS ウィジェット」を選択して、ウィザードを起動することもできます。
カスタム・コンポーネントとウィジェットを作成するウィザードの使用方法の詳細については、アプリケーション環境に応じて、「HATS Web アプリケーション・プログラマーズ・ガイド」または「HATS リッチ・クライアント・プラットフォーム・プログラマーズ・ガイド」を参照してください。
コンポーネントおよびウィジェットの設定
HATS が提供するコンポーネントおよびウィジェットには、変更可能なデフォルト設定があり、プロジェクト・エディターを使用するプロジェクト全体用と、「ホスト・コンポーネントを挿入」ウィザードを使用する個別変換用があります。ただし、必ずしもすべてのコンポーネントおよびウィジェットに、カスタマイズ可能な設定が存在するわけではありません。
注:
縦線 (|) 文字は OR を暗黙指定します。この文字は多くのコンポーネントおよびウィジェット設定で有効です。例えば、ファンクション・キー・コンポーネントには、開始区切り文字と呼ばれる設定があります。ここでは開始区切り文字の値に PF|F を指定できます。これは、HATS が、ファンクション・キーを検索するときにホスト画面上で、PFxxxx または Fxxxx を探すことを意味します。
ホスト・コンポーネントの設定
ホスト・コンポーネントの設定では、そのコンポーネントがホスト画面で認識される方法を指定します。
中には、複雑な設定のホスト・コンポーネントもあります。例えば、いくつかの設定は、ファンクション・キーや選択リストを認識するために使用されます。これらの設定については、各ホスト・コンポーネントの箇所で説明します。
以降のセクションでは、HATS のホスト・コンポーネントについて説明します。
__________________________________________________________________________
コマンド行
コマンド行コンポーネントは、入力フィールドの前に特定の文字ストリング (トークン) を持つ入力フィールドを認識します。
認識されたコマンド行は、以下のウィジェットによるレンダリングが可能になります。
次の図に、ホスト画面上のコマンド行コンポーネントの表示例を示します。
- フィールドの表題 (抽出)
以下の設定が、このコンポーネントに対して構成できます。
- トークン
- 入力フィールドに先行することが必要な文字列
- フィールドの表題を抽出
- 選択した入力フィールドの使用可能な表題を抽出する場合は、このチェック・ボックスを選択します。
- 表題のスペースをトリム (Trim spaces on caption)
- 詳細については、入力フィールドを参照してください。
- 選択領域にクリップ
- 詳細については、入力フィールドを参照してください。
__________________________________________________________________________
ダイアログ
ダイアログ・コンポーネントを使用して、デフォルトのレンダリングによるホスト画面上のモーダル (ポップアップ) フレームの認識を支援できます。
ダイアログ・コンポーネントの概念とは、モーダル・ダイアログを使用して作業していることを前提として、境界の記述に対応する、カーソルを囲む長方形の最も小さな領域を検出することです。モーダル・ダイアログは、開いている間、入力フォーカスを維持します。ユーザーは、別のウィンドウに切り替えるには、ダイアログを閉じるか、またはダイアログにすべてを入力する必要があります。
データを入力してモーダル・ダイアログを完了する際に、HATS ではカーソルがダイアログの境界線内に位置していることを前提とします。HATS は、「垂直境界文字」設定で定義されている有効な垂直境界文字を、画面上のカーソル文字の座標から開始し、左側へ検索します。有効な左側の垂直境界文字が検出されると、HATS は同一カーソル座標へ戻り、右側に向かって有効垂直境界文字を検索します。カーソル座標の左右両側で有効垂直境界文字が検出されると、HATS はこの 2 つの文字の間の距離を計測し、有効な長さであることを確認します。
HATS はまた、垂直境界文字の検索と同様の方法で、「水平境界文字」設定で定義されている上下の水平境界文字も検索します。
ダイアログ・ウィンドウは長方形であるため、HATS では左右の境界線の列と、上下の境界線の行を使用して、列がモーダル・ダイアログの垂直条件に対応しているかどうか、および行がモーダル・ダイアログの水平条件に対応しているかどうかを判別します。「最小行数」属性が満たされていることを前提として、長方形の外側の行と列が位置合わせされると、ダイアログ・コンポーネントはそのウィンドウを一致として宣言し、認識される領域がレンダリングされます。
このコンポーネントを構成するには、HATS プロジェクトの「プロジェクト設定」を表示し、「レンダリング」タブを選択して「デフォルト・レンダリング」をクリックします。
注:
ダイアログ・コンポーネントは、デフォルトのレンダリングでのみ使用可能です。
ダイアログ・コンポーネントは、ダイアログ・ウィジェットを使用してレンダリングされます。
次の図に、ホスト画面上のダイアログ・コンポーネントの表示例を示します。
- 水平境界文字
- 垂直境界文字
- カーソルをダイアログ内に配置
以下の設定が、このコンポーネントに対して構成できます。
- 水平境界文字
- ダイアログの上下の境界として使用する文字を指定します。デフォルトでは、水平境界文字として保護反転表示文字、ピリオド (.)、ハイフン (-)、アンダースコアー (_) のいずれかを使用できます。複数の文字を使用する場合は、各文字を縦線 (|) で区切ります。これらの文字は、左から右へ順に評価されます。
- 垂直境界文字
- ダイアログの左右の境界として使用する文字を指定します。デフォルトでは、垂直境界文字として保護反転表示文字、コロン (:)、縦線 (|) のいずれかを使用できます。複数の文字を使用する場合は、各文字を縦線 (|) で区切ります。これらの文字は、左から右へ順に評価されます。
注:
縦線 (|) は複数の文字を指定するときの分離文字として使用されるため、垂直境界文字として縦線 (|) を指定するには、&vl.を使用してください。
このコンポーネントの「水平境界文字」と「垂直境界文字」設定には、文字だけでなく、境界文字のフィールド属性も指定できます。フィールドの属性を指定するときに使用するインディケーターを以下に示します。各フィールドの指定を、中括弧 ({...}) で囲みます。各インディケーターをスペースで区切ります。否定 (NOT) を示すには、インディケーターの前に接頭部として感嘆符 (!) を追加します。インディケーターと感嘆符の間にはスペースを入れないでください。
- 保護フィールド: p
- 隠しフィールド: h
- 数値のみフィールド: no
- 高輝度フィールド: hi
- フィールドの前景色、後続の 16 進文字によって指示される (例: f_7)
- 反転表示フィールド: rv
- 下線フィールド: ul
- 明滅フィールド: b
- 列分離子フィールド: c
例: {!p hi no} は、無保護の強調表示された数値のみのフィールドを示します。
注:
- 境界文字のフィールド属性を指定するときに、指定部分の直前にデータがある場合は、指定内容はそのデータの修飾子となります。例えば、次のようになります。
- {p rv} は、任意の保護されている反転表示文字に一致します。
- :{p rv} は、保護されている 1 つの反転表示コロンに一致します。
- {p rv}: は、任意の保護されている反転表示文字に一致します。これは、コロンがフィールド指定の後に位置されていることから、コロンには反映されないためです。
- フィールド属性定義の中のインディケーターの順序は関係ありません。これは、中括弧内のすべてのインディケーターは、認識される境界文字に対し一致する必要があるためです。
- 最小行数
- ダイアログとして認識するために領域に含まれる必要がある最小行数。デフォルトは 3 です。
- 最小列数
- ダイアログとして認識するために領域に含まれる必要がある最小列数。デフォルトは 3 です。
- カーソルをダイアログ内に配置
- ダイアログとして認識される領域内にカーソルを配置する必要があるかどうかを指定します。これを選択しない場合は、ダイアログとして認識される領域内にカーソルが配置されている必要はありません。モーダル・ダイアログの場合は、予期しない結果が生じることがあります。
- ダイアログ外部対話の許可
- 境界の外側のエリアを使用不可にするかどうかを指定します。
注:
ダイアログ境界内部のテキストの置換は、ダイアログ・コンポーネントの設定で定義することはできません。ダイアログ・コンポーネント自体は、ダイアログ・ウィンドウの境界 (まわりのボックス) でしかありません。境界内の内容は、デフォルト・レンダリングのその他のコンポーネントによってレンダリングされます。ダイアログの内容のテキスト置換を実行するために、ダイアログの内容をレンダリングするデフォルト・レンダリング項目のテキスト置換を指定できます。例えば、フィールド・コンポーネントに対しテキスト置換を指定できます。 ダイアログ・コンポーネントとその他のコンポーネントを組み合わせた正確な表示を取得するには、「全ページのプレビュー」をクリックします。
__________________________________________________________________________
ENPTUI
ENPTUI (拡張非プログラマブル端末ユーザー・インターフェース) を使用すると、5250 フルスクリーン・メニュー方式インターフェースを利用する非プログラマブル端末 (NPT) およびプログラマブル・ワークステーション (PWS) 上で拡張インターフェースを使用できるため、5250 表示データ・ストリーム拡張機能を利用できます。HATS は、グラフィカル・インターフェース構成を含む ENPTUI 機能のサブセットをサポートします。これらの構成は、2 つの HATS コンポーネントである「スクロール・バー」および「選択フィールド」で表されます。
新規 HATS プロジェクトの作成中に ENPTUI サポートを追加するには、HATS ツールバーから「HATS」>「新規」>「プロジェクト」 (または「ファイル」>「新規」>「HATS プロジェクト」) を選択して、「プロジェクトの作成」ウィザードを起動します。「接続設定」パネルが表示されたら、接続タイプとして「5250」または「5250W」を選択し、「グラフィカル・インターフェース DDS キーワード (ENPTUI) レンダリング・サポートの追加」チェック・ボックスを選択してサポートを使用可能にします。
注:
このオプションは、モバイル装置に対して最適化されているプロジェクトでは、使用できません。
このチェック・ボックスを選択すると、application.hap ファイル内に設定されているデフォルト・レンダリングに標準 ENPTUI レンダリング項目が含まれます。また、デフォルト・レンダリングかカスタム変換のいずれかが含まれるように、コンポーネントおよびウィジェットのレジストリー (ComponentWidget.xml) に ENPTUI コンポーネントおよびウィジェットが含まれます。また、作成されるデフォルト接続オブジェクトの拡張接続プロパティーに ENPTUI=true が追加されます。この値は、HATS がホストから ENPTUI データを受信するために必要です。
このチェック・ボックスをクリアされたままにすると、「プロジェクトの作成」ウィザードによってコンポーネントおよびウィジェットのレジストリーと application.hap ファイルが編集され、ウィザードが新規プロジェクト内に配置したファイルから ENPTUI レンダリング項目、コンポーネント、およびウィジェットが除去されます。
注:
これは、HATS が ENPTUI コンポーネントおよびウィジェットをプロジェクトに追加できる唯一の機会です。作成後に ENPTUI をプロジェクトに追加する場合は、ComponentWidget.xml、application.hap、および main.hco に対するすべての編集を手動で実行する必要があります (比較して必要な変更を見つけることによって実行します)。この方法はお勧めできません。新規プロジェクトを作成して ENPTUI サポートを追加する方法をお勧めします。
ENPTUI コンポーネントとその設定を以下に示します。Page Designer の「パレット」ビューの「HATS コンポーネント」セクションには、これらのコンポーネントは表示されません。ENPTUI サポートが上記の手順で使用可能にされている場合にこれらのコンポーネントを操作するには、Rational® SDP メニュー・バーから「HATS ツール」>「ホスト・コンポーネントを挿入」をクリックします。
スクロール・バー・フィールド (ENPTUI)
スクロール・バー・フィールド (ENPTUI) コンポーネントは、5250 データ・ストリームからの ENPTUI スクロール・バー・フィールドの認識を担当します。このコンポーネントは、選択された任意のホスト画面領域を認識し、スクロール・バー (ENPTUI) ウィジェットを使用してレンダリングできます。このコンポーネントには、カスタマイズ可能な設定はありません。
選択フィールド (ENPTUI)
認識された ENPTUI 選択フィールドは、以下のウィジェットによるレンダリングが可能になります。
以下の設定が、このコンポーネントに対して構成できます。
- 選択フィールド・タイプ認識 (Selection Field Type Recognition)
- コンポーネントの指定された任意のインスタンスで一致させる選択フィールド・タイプ。
- プッシュボタン (Push Buttons)
- プッシュボタン ENPTUI 選択フィールドを認識させる場合は、このボックスを選択します。
- 単一選択フィールド (Single Choice Fields)
- 単一選択 ENPTUI 選択フィールドを認識させる場合は、このボックスを選択します。
- 複数選択フィールド (Multiple Choice Fields)
- 複数選択 ENPTUI 選択フィールドを認識させる場合は、このボックスを選択します。
- メニュー・バー (Menu Bars)
- メニュー・バー ENPTUI 選択フィールドを認識させる場合は、このボックスを選択します。
- 選択フィールド属性認識 (Selection Field Attribute Recognition)
- コンポーネントの指定された任意のインスタンスで一致させる選択フィールド属性。
- 自動入力を使用できるフィールドの認識 (Recognize fields having auto-enter)
- 自動入力が使用可能または使用不可のどちらの ENPTUI 選択フィールドを認識させるか (あるいはその両方を認識させるか) をドロップダウン・リストから選択します。
次の図に、ホスト画面上の ENPTUI コンポーネントの表示例を示します。
- 選択フィールド・コンポーネント
- スクロール・バー・フィールド・コンポーネント
__________________________________________________________________________
フィールド
フィールド・コンポーネントは、保護テキストと入力フィールドの認識を担当します。このコンポーネントは、選択された任意のホスト画面領域を認識し、フィールド ウィジェットを使用してレンダリングできます。
注:
フィールド・コンポーネントは、ユーザーによる指定領域のみを含みます。選択領域が、実際のホスト画面フィールドを通り抜けている場合は、選択領域内の部分のみがレンダリングされます。
次の図に、ホスト画面上のフィールド・コンポーネントの表示例を示します。
このコンポーネントには、以下の設定を構成できます。
- 保護フィールドのサポート文字レベル属性
-
この設定により、保護フィールドの先頭文字の色と属性でフィールド全体をレンダリングするのではなく、保護フィールドのすべての文字の色と拡張属性を正確にレンダリングできます。
これが選択されていない (デフォルト) 場合は、色などの属性がフィールドの中間で変化する場合でも、フィールドの先頭文字によってフィールド内のすべての文字の属性が決定します。
これが選択されている場合は、一連の類似した文字のセグメントとしてフィールド・コンポーネント・エレメントがレンダリングされ、フィールド内で各種の色および拡張属性 (反転表示など) の情報がサポートされます。例えば、長さ 10 文字のフィールドにおいて、先頭 5 文字が緑色、その後の 5 文字が赤色の場合、このフィールドは 2 つのフィールド・コンポーネント・エレメントにより表現されます。
注:
この設定は、保護フィールドにのみ適用されます。入力フィールドには適用されません。
__________________________________________________________________________
ファンクション・キー
ファンクション・キー・コンポーネントは、ファンクション (PF) キーを認識します。このコンポーネントを使用して、ホスト画面上にあるファンクション・キーを表す静的テキストを、ユーザーがクリック可能なボタンまたはリンクに変換できます。ファンクション・キーは、ホスト・システム間で表示が異なるため、HATS では、そのさまざまな部分を構成する柔軟性が用意されています。例えば、ホスト画面には以下のようなファンクション・キーが含まれます。
ファンクション・キーは、以下のウィジェットによるレンダリングが可能になります。
次の図に、ホスト画面上のファンクション・キー・コンポーネントの表示例を示します。
図 17. ファンクション・キー・コンポーネントの例
- 先行トークンの前のストリング (スペース)
- 開始区切り文字 (#、数値を示す)
- 区切り文字 (等号 (=))
- 説明の後のストリング (スペース)
以下の設定が、このコンポーネントに対して構成できます。
- 先行トークンの前のストリング
- オプションです。開始区切り文字に先行する必要のあるストリングです。縦線 (|) 文字で区切って複数の値を指定することができます。認識対象のファンクション・キーの場合、この値が先行する必要があります。
- 開始区切り文字
- 必須です。ファンクション・キーになる可能性のあるものの開始をマークするストリングです。縦線 (|) 文字で区切って複数の値を指定することができます。いずれの値でもファンクション・キーの開始として認識されます。この値は、1 つの「#」(ポンド記号) を含むことができます。認識中に「1 つの番号」に評価されます。
- 区切り文字
- オプションです。開始区切り文字を説明から区切るストリングです。縦線 (|) 文字で区切って複数の値を指定することができます。
- 説明の後のストリング
- オプションです。説明の直後に続くストリングです。デフォルトは " " (ダブル・スペース) です。これは、ファンクション・キーの複数語からなる説明の検出を有効にします。
ファンクション・キー・コンポーネント設定を使用する際には、次に説明する例を考慮してください。ホスト画面に次のファンクション・キー説明が示されるとします。
F1=Help F2=Open F3=Exit
この場合、各説明の間がシングル・スペースで区切られています。「説明の後のストリング」設定のデフォルト値は " " (ダブル・スペース) ですが、HATS ではこれは 3 つの個別のファンクション・キーとして認識されます。これは、ファンクション・キー・コンポーネントが開始区切り文字、区切り文字、説明の後のストリングの順に検索するためです。ただし、説明の後のストリングが検出される前に新しい開始区切り文字が検出されると、これは新規ファンクション・キー説明の開始と解釈されます。
注:
- HATS ファンクション・キー・コンポーネントは、F# キー、PA キー、Enter およびクリアのみを認識およびレンダリングします。Enter とクリアの認識を使用不可にするには、開始区切り文字の定義から最後の # を除去します。
- HATS ファンクション・キー・コンポーネントは、ヘルプ、前ページ (ロールアップ)、次ページ (ロールダウン)、システム要求、アテンション、印刷などのその他のホスト・ファンクション・キーを認識しません。これらのその他の機能は、ホスト・キーパッド上で使用できます。「HATS ツール」メニュー項目を使用して、これらのホスト・キーを HATS 変換に追加することもできます。
- ドロップダウン (選択) ウィジェットを使用してファンクション・キー・コンポーネントをデフォルトのレンダリングでレンダリングする場合、プレビュー時および実行時に複数のドロップダウン・ウィジェットがレンダリングされる可能性があります。実行時にこの問題を修正するためには、application.hap ファイルのソースで、SLDropdownWidget が指定された FunctionKeyComponent に対する <renderingItem
...> タグを見つけます。次に、設定 keepOutputTogether の値を false から true に変更しますプレビューでは、引き続き複数のドロップダウン・ウィジェットが表示されます。
- 複数のファンクション・キー・コンポーネントをデフォルトのレンダリングで使用していて、変換の中でこれらを別々の行に表示したい場合には、<BR> タグを使用するか、テーブルにマップして、強制的に移動する必要があります。
これを行うには、「ソース」タブで変換を表示して編集します。
__________________________________________________________________________
HTML DDS キーワード Web のみ
IBM® i ディスプレイ・ファイル内で HTML DDS キーワードを使用すると、HTML フラグメントを 5250 データ・ストリームとともに送信できます。この機能は、標準エミュレーション・プログラムでの表示を目的としたものではありません。HTML フラグメントは、ブラウザー内でこの HTML データを表示するように拡張された 5250 Workstation Gateway デバイスおよび HATS などのホスト・アクセス製品にのみ送信されます。
HTML DDS は、ホスト・タイプが 5250 として指定されたときにコンポーネントとして使用できます。このコンポーネントの使用はデフォルトのレンダリングの一部ではないため、必要な場合にはデフォルトのレンダリングまたはカスタム変換に追加する必要があります。
HTML DDS キーワード・コンポーネントは、この HTML データが 5250 データ・ストリーム内に存在する場合に HTML データを認識します。
このコンポーネントは、ラベル ウィジェットを使用してレンダリングが可能です。
以下の設定が、このコンポーネントに対して構成できます。
- フィルターを使用して DDS データを無視 (Ignore DDS data using filter)
- DDS データを 5250 データ・ストリーム内で送信されたままの形で認識させる場合、またはこれらの「無視」フィルターで指定されたタグを除いて送信されたままの形で認識させる場合は、このボタンをクリックします。
- これらのタグを無視 (Ignore these tags)
- 無視する任意のタグ (< および > 文字を除く) を入力します。このタグとその終了タグの間のデータは保持されます。例えば、太字タグで囲まれたデータを保持し、タグ自体は保持しない <b>b</b> を指定します。
- これらのタグ内のすべての DDS データを無視 (Ignore all DDS data in these tags)
- このタグとその終了タグの間のデータを無視する任意のタグ (< および > 文字を除く) を入力します。
- フィルターを使用して DDS データを受け入れ (Accept DDS data using filter)
- 5250 データ・ストリーム内の HTML DDS データからこれらの「受け入れ」フィルターを通過した HTML タグのみを認識させる場合は、このボタンをクリックします。これらのフィルターを通過しなかった HTML DDS データは無視されます。
- これらのタグを受け入れ (Accept these tags)
- 保持する任意のタグ (< および > 文字を除く) を入力します。このタグとその終了タグの間のデータは無視されます。
- これらのタグ内のすべての DDS データを受け入れ (Accept all DDS data in these tags)
- このタグとその終了タグの間のデータを保持する任意のタグ (< および > 文字を除く) を入力します。
キーワード HTML を追加すると、ブラウザー形式の受信者のみが解釈する生の HTML データをデータ・ストリームに埋め込むことができます。
HATS でこの機能がサポートされたことにより、ホスト・アプリケーションから HTML DDS キーワード内で送信されたデータを、デフォルトのレンダリングまたはカスタム変換で使用できます。
接続定義の HTML DDS キーワード・サポートを使用可能にするには、以下のステップを実行します。
- 「HATS プロジェクト」ビュー内のメイン HATS 接続をクリックして、「接続エディター」を開きます。
- 「拡張」タブを選択し、「追加」ボタンをクリックして拡張接続設定を構成します。
- ドロップダウン・リストから「名前」に「HTMLDDS」を選択し、「値」フィールドに「true」と入力します。
- 「OK」をクリックします。
__________________________________________________________________________
入力フィールド・コンポーネントは、入力フィールド (無保護フィールド) を認識するためのものです。このコンポーネントは、入力フィールドを認識する以外に、フィールド付随の表題の抽出も行います。入力フィールドの表題を見つけるため、まず、このコンポーネントは、(同じ行上の) 入力フィールドの直前の保護テキストを探します。アルゴリズムは、表題を発見できない場合、保護テキストの入力フィールドの直上を探します。
認識された入力フィールドは、以下のウィジェットによるレンダリングが可能になります。
次の図に、ホスト画面上の入力フィールド・コンポーネントの表示例を示します。
- フィールドの表題 (コンポーネントから抽出)
以下の設定が、このコンポーネントに対して構成できます。
- フィールドの表題を抽出
- これを選択した場合、認識された入力フィールドの表題が抽出されます (このアルゴリズムの詳細については、上記の説明を参照してください)。ここで抽出された表題は、ウィジェットが使用できます。
- 表題を選択領域に制限
- 選択した場合は、表題が、画面の選択部分のテキスト内のみに制限されます。
- 表題の終了を除去
- これを選択した場合、「この後を除去」設定に指定された値が最初に出現した後 (値も含む) から表題の最後までが除去されます。この設定は、抽出した表題を完全に取り去る場合に有効です。
- この後除去 (Strip after)
- 必須です。抽出された表題を除去するために使用するストリング (またはストリングの集合) です。例えば、抽出された表題が 「Command ==>」で、この設定値が「=」の場合は、最初の「=」から後 (「=」も含む) のすべてが除去されます。
- 次と置き換え
- オプションです。表題の除去された部分に置き換わるストリングです (該当する場合)。
- 表題のスペースをトリム (Trim spaces on caption)
- これを選択した場合、抽出 (および除去) された表題の両端から空白文字 (スペース、タブなど) が削除されます。
- 入力フィールドを選択領域にクリップ
- これを選択した場合、選択領域内の入力フィールドの一部のみが認識および表示されます。クリアした場合は、選択領域内に入力フィールドの一部が存在すると、入力フィールド全体が認識および表示されます。この設定は、大きなホスト画面入力フィールドを細分化した複数の Web ページ入力フィールドに分割する必要のある場合に有効です。
__________________________________________________________________________
ヒント付き入力フィールド
ヒント付き入力フィールド・コンポーネントは、付随するヒント (同一行にある入力フィールドの直後のテキスト) を持つ入力フィールド (無保護フィールド) を認識するためのものです。このコンポーネントは機能的には入力フィールド・コンポーネントと同じですが、入力候補の隣にヒントが存在していなければならない点が異なります。例えば、以下の入力フィールドが存在するホスト画面を考えてみます。
製品コード (Product code): [ ] (Valid codes: A, B, C, D)
この例では、ヒントの開始部分が「Valid codes:」、ヒントの最後が閉じ括弧「[)]」、分離文字がコンマ「(,)」、先行トークンのタイプが「None」です。
認識された入力フィールドは、以下のウィジェットによるレンダリングが可能になります。
この入力フィールドは、有効な値ヒントも使用します。デフォルトでは、この入力フィールドはヒントを認識しないため、ユーザーがコンポーネント設定を変更して、ヒントをレンダリング・ウィジェットに引き渡す必要があります。
次の図に、ホスト画面上のヒント付き入力フィールド・コンポーネントの表示例を示します。
図 19. ヒント付き入力フィールド・コンポーネントの例
- 区切り文字: 区切り文字の位置。ただし、先行トークンのタイプは「None」に設定されていた。
- ヒントの開始: 開き括弧 (
- 分離文字: or
- ヒントの終了: 閉じ括弧 )
先行トークンのタイプがマークされていません。この例では、先行トークンのタイプは「None」です。ヒントに先行する文字または数字はありません。
以下の設定が、このコンポーネントに対して構成できます。
- フィールドの表題を抽出
- これを選択した場合、認識された入力フィールドの表題が抽出されます (このアルゴリズムの詳細については、上記の説明を参照してください)。ここで抽出された表題は、ウィジェットが使用できます。
- 表題を選択領域に制限
- 選択した場合は、表題が、画面の選択部分のテキスト内のみに制限されます。
- 表題の終了を除去
- これを選択した場合、「この後を除去」設定に指定された値が最初に出現した後 (値も含む) から表題の最後までが除去されます。この設定は、抽出した表題を完全に取り去る場合に有効です。
- この後除去 (Strip after)
- 必須です。抽出された表題を除去するために使用するストリング (またはストリングの集合) です。例えば、抽出された表題が 「Command ==>」で、この設定値が「=」の場合は、最初の「=」から後 (「=」も含む) のすべてが除去されます。
- 次と置き換え
- オプションです。表題の除去された部分に置き換わるストリングです (該当する場合)。
- 表題のスペースをトリム (Trim spaces on caption)
- これを選択した場合、抽出 (および除去) された表題の両端から空白文字 (スペース、タブなど) が削除されます。
- 入力フィールドを選択領域にクリップ
- これを選択した場合、選択領域内の入力フィールドの一部のみが認識および表示されます。クリアした場合は、選択領域内に入力フィールドの一部が存在すると、入力フィールド全体が認識および表示されます。この設定は、大きなホスト画面入力フィールドを細分化した複数の Web ページ入力フィールドに分割する必要のある場合に有効です。
- ヒントの開始
- オプションです。ヒント集合の開始位置を指定する文字列です。この設定には複数の値を指定できます。値は縦線 (|) 文字で分離します。
- ヒントの終了
- オプションです。ヒント集合の終了位置を指定する文字列です。この設定には複数の値を指定できます。値は縦線 (|) 文字で分離します。
- 分離文字
- 必須です。ヒント集合で各ヒントを区切る文字列です。この設定には複数の値を指定できます。値は縦線 (|) 文字で分離します。
- 先行トークンのタイプ
- 各ヒントのタイプを指定します。例えば、ヒントのセットが「A=Apple,O=Orange,G=Grape」である場合、A、O、および G がすべて文字であるため、この値には「文字」 (または 「文字または数字」) をセットすることになります。区切り文字には「=」を設定します。
- 先行トークンの最大長 (Maximum length of leading token)
- 先行トークンの最大長を指定します。デフォルトは 4 です。
- 区切り文字
- 必須です。ヒント説明から先行トークンを区切る文字列です。この設定は、先行トークンのタイプが「None」でない場合に限り適用されます。
- 最小限必要なヒント
- このコンポーネントが、入力フィールドを認識するための必要最小限のヒント数です。この設定は、誤認識を避ける場合に有効です。
__________________________________________________________________________
項目の選択
項目選択コンポーネントは、項目リストを含む画面を認識します。このような画面では、項目の横にある文字を選択して対話を行います。
項目選択コンポーネントは、以下のウィジェットによってレンダリングできます。
次の図に、ホスト画面上の項目選択コンポーネントの表示例を示します。
- 入力フィールド
- 表題
以下の設定が、このコンポーネントに対して構成できます。
- フィールドの表題を抽出
- 選択した入力フィールドで使用可能な表題を抽出する場合は、このボックスを選択します。
- 表題の終了を除去
- 「フィールドの表題を抽出」が選択されている場合にのみ使用可能です。表題の終了テキストを削除するには、このボックスを選択します。「この後を除去」に削除を開始する位置を指定し、「置換後」に削除した表題テキストを置換する文字を指定します。
- 表題のスペースをトリム (Trim spaces on caption)
- 「フィールドの表題を抽出」が選択されている場合にのみ使用可能です。表題の両端にある余分なスペースをすべて除去するには、このボックスを選択します。
- 入力フィールドの後の表題 (Captions are after input fields)
- 「フィールドの表題を抽出」が選択されている場合にのみ使用可能です。抽出する表題が入力フィールドの右側にある場合は、このボックスを選択します。表題が入力フィールドの左側にある場合は、このボックスをクリアします。
- 入力フィールドに表題が必要 (Input fields must have a caption)
- ホスト画面上で表題付き入力フィールドのみを認識させる場合は、このボックスを選択します。
- 入力フィールドを選択領域にクリップ
- 入力フィールドの選択部分のみをレンダリングする場合は、このボックスを選択します。フィールドの一部が選択されている場合でもフィールド全体をレンダリングする場合は、このボックスをクリアします。
__________________________________________________________________________
ライト・ペン (アテンション)
ライト・ペン (アテンション) コンポーネントは、3270 ホスト画面上のライト・ペン (セレクター・ペンとも呼ばれる) アテンション・フィールドの認識を担当します。
注:
このコンポーネントは、Page Designer の「パレット」ビューの「HATS コンポーネント」セクションには表示されません。3270 または 3270E プロジェクトの初期作成時に「ライト・ペン・レンダリング・サポートの追加」チェック・ボックスを選択してライトペン・サポートを有効にしている場合、このコンポーネントを使用するには Rational SDP メニュー・バーから「HATS ツール」>「ホスト・コンポーネントを挿入」をクリックします。
認識されたライト・ペン・アテンション・フィールドは、以下のウィジェットによってレンダリングできます。
指定文字 (フィールドの先頭文字) に従って、レンダリング・ウィジェット (ボタン、リンク、またはラジオ・ボタン) をクリックすると、[enter] または [cursel] アテンション識別子 (AID) がホストに送信されます。指定子がアンパーサンド文字 (&) の場合は、[enter] AID が送信されます。指定子がブランク文字の場合は、[cursel] AID が送信されます。
次の図に、ホスト画面上のライト・ペン (アテンション) コンポーネントの表示例を示します。
図 21. ライト・ペン (アテンション) コンポーネントの例
- 指定文字 (フィールドの先頭文字)
以下の設定が、このコンポーネントに対して構成できます。
- フィールドの残りを消費
- ウィジェットが消費およびレンダリングする対象が、フィールド全体またはフィールドの先頭文字のみのいずれであるかを指定します。フィールド全体を消費およびレンダリングすることを指定するには、このチェック・ボックスを選択します。例えば、フィールドの内容がレンダリング・ウィジェット (ボタン、リンク、またはラジオ・ボタン) の表題としてレンダリングされます。ウィジェットにより先頭文字のみをレンダリングすることを指定するには、このチェック・ボックスをクリアします。これは、フィールドの先頭文字より後の部分の色や拡張属性を保持する場合に便利です。デフォルト・レンダリングでは、このチェック・ボックスをクリアすると、フィールドの残りの部分 (フィールドの先頭文字を除くすべての部分) が他のウィジェット (ほとんどの場合はフィールド・ウィジェット) によりレンダリングされます。デフォルトでは選択されています。
__________________________________________________________________________
ライト・ペン (選択)
ライト・ペン (選択) コンポーネントは、3270 ホスト画面上のライト・ペン (セレクター・ペンとも呼ばれる) 選択フィールドの認識を担当します。
注:
このコンポーネントは、Page Designer の「パレット」ビューの「HATS コンポーネント」セクションには表示されません。3270 または 3270E プロジェクトの初期作成時に「ライト・ペン・レンダリング・サポートの追加」チェック・ボックスを選択してライトペン・サポートを有効にしている場合、このコンポーネントを使用するには Rational SDP メニュー・バーから「HATS ツール」>「ホスト・コンポーネントを挿入」をクリックします。
認識されたライト・ペン選択フィールドは、チェック・ボックス・ウィジェットによってレンダリングできます。
指定文字 (フィールドの先頭文字) が疑問符 (?) の場合、レンダリングされたチェック・ボックスは選択されません。指定文字がより大記号 (>) の場合は、レンダリング・チェック・ボックスが選択されます。
次の図は、ホスト画面上のライト・ペン (選択) コンポーネントの表示例を示します。
図 22. ライト・ペン (選択) コンポーネントの例
- 指定文字 (フィールドの先頭文字)
以下の設定が、このコンポーネントに対して構成できます。
- フィールドの残りを消費
- ウィジェットが消費およびレンダリングする対象が、フィールド全体またはフィールドの先頭文字のみのいずれであるかを指定します。フィールド全体を消費およびレンダリングすることを指定するには、このチェック・ボックスを選択します。例えば、フィールドの内容がレンダリング・ウィジェット (チェック・ボックス) の表題としてレンダリングされます。ウィジェットにより先頭文字のみをレンダリングすることを指定するには、このチェック・ボックスをクリアします。これは、フィールドの先頭文字より後の部分の色や拡張属性を保持する場合に便利です。デフォルト・レンダリングでは、このチェック・ボックスをクリアすると、フィールドの残りの部分 (フィールドの先頭文字を除くすべての部分) が他のウィジェット (ほとんどの場合はフィールド・ウィジェット) によりレンダリングされます。デフォルトが選択されています。
__________________________________________________________________________
選択リスト
選択リスト・コンポーネントは、選択リストの認識を担当します。選択リストはメニューに似ていますが、オプションのリストとして表示される点が違い、以下の例に示すように、各オプションの前に、先行トークンと区切り文字が置かれます。
| Option 1. Prepare form |
| Option 2. Work with forms you submitted |
| Option 3. Work with forms requiring
action |
この例では、Option が先行トークンに先立つストリング、1、2、3 が先行トークン、区切り文字がピリオドとその後のスペース (. ) です。
リスト項目を選択すると (ウィジェットに基づきクリックまたは選択すると)、その先行トークンが、ターゲットのホストの入力フィールドに置かれます。
認識された選択リストは、以下のウィジェットによるレンダリングが可能になります。
次の図は、ホスト画面上の選択リスト・コンポーネントの表示例を示します。
- 先行トークンの前のストリング (スペース)
- 先行トークンのタイプ (数字)
- 区切り文字 (ピリオド (.))
- 終了区切り文字 (スペース)
- リスト・オプション (または項目)
以下の設定が、このコンポーネントに対して構成できます。
- 先行トークンの前のストリング
- オプションです。各リスト項目の先行トークンの前に置かれるストリングです。
- 先行トークンのタイプ
- 各リスト項目が、文字、数字、英数字のいずれで始まるかを指定します。
- 先行トークンの最大長 (Maximum length of leading token)
- 先行トークンの最大長を指定します。デフォルトは 4 です。
- 区切り文字
- 必須です。先行トークンと説明の間を区切る文字列です。縦線 (|) 文字で区切って複数の値を指定することができます。
- 終了区切り文字
- オプションです。各リスト項目に続く必要のある文字列です。
- 最小限必要なオプション
- 選択領域が、選択リストとして認識されるための必要最小限のリスト項目の数です。
- 項目を個別にグループ化 (Group Items Individually)
- 項目を個別にグループ化する場合は、このボックスを選択します。
- 選択ターゲット・フィールド
- 選択内容を受け取る入力フィールドを指定します。オプション: 「画面の先頭」、「画面の最後」、「前のフィールド」、「次のフィールド」、「カーソル位置」、または「ユーザー定義」。
- 行
- 選択内容を受け取る入力フィールドの行を指定します。
注:
この設定は、「ユーザー定義」が選択ターゲットとして選択されている場合に限り適用されます。
- 列
- 選択内容を受け取る入力フィールドの列を指定します。
注:
この設定は、「ユーザー定義」が選択ターゲットとして選択されている場合に限り適用されます。
- 選択時に自動的に実行依頼
- 選択されている場合、AID キーは、入力フィールドがブランクでも、自動的にホストに送信されます。クリアにされると、AID キーは、自動的に送信されません。
- アクション・キー
- オプションです。ターゲット入力フィールドがユーザーの選択で更新された後に押すホスト補助キーを指定します。デフォルト値は 「enter」 で、エンド・ユーザーが選択を行った後に Enter キーを押すことを示します。
- リスト・オプションをソート
- これを選択した場合、リスト項目が先行トークンまたは説明に従ってソートされます (他の設定の詳細については、以下を参照してください)。
- ソート基準
- リスト・オプションの集合をその先行トークンまたは説明のいずれでソートするかを指定します。
- ソート順序
- リスト・オプションの集合を昇順または降順のいずれでソートするかを指定します。
注:
この操作を行うには、Java™ に組み込まれたロケール依存ソート方式が使用されます。
- プレースホルダー・オプション (Placeholder options)
- リスト項目間にギャップ (空のスペースなど) が存在する場合にプレースホルダー・リスト項目を埋め込むかどうかを指定します。オプション: 「実」、「なし」、または「単一」。
注:
DBCS をサポートするこのコンポーネントの使用の詳細については、
選択リストを参照してください。
__________________________________________________________________________
サブファイル
サブファイル・コンポーネントは、5250 サブファイルを認識します。このコンポーネントは、Page Designer の「パレット」ビューの「HATS コンポーネント」セクションには表示されません。5250 プロジェクトの場合、このコンポーネントを使用するには、Rational SDP メニュー・バーから「HATS ツール」>「ホスト・コンポーネントを挿入」をクリックします。
認識されたサブファイルは、以下のウィジェットによってレンダリングできます。
次の図は、ホスト画面上のサブファイル・コンポーネントの表示例を示します。
- アクション領域
- ヘッダー領域
- データ領域
- マーカー領域
アクション設定
- 先行トークンの前のストリング (スペース)
- 先行トークンのタイプ (数字)
- 区切り文字 (等号 (=))
ヘッダー設定
- ヘッダーの開始テキスト (オプション)
データ設定
- 列区切り文字 (スペース)
マーカー設定
- マーカー・テキスト (続き...)
「サブファイルの設定」を起動するには、以下のステップを行います。
- 「HATS プロジェクト」ビューに移動し、「プロジェクト設定」をクリックします。
- 「レンダリング」タブを選択します。
- 「レンダリング」タブで、「コンポーネント」ツリーを展開し、「サブファイル」コンポーネントを選択します。
- 右側にある「設定」ボタンをクリックして、「サブファイルの設定」ウィンドウを表示します。
サブファイル・コンポーネント設定は、「アクション」、「ヘッダー」、「データ」、および「マーカー」の 4 つのタブからなります。各タブは、サブファイルの特定のエレメントを認識する基準を定義します。各タブのアイコンは、以下の状態を表します。
- 認識: この状態は、サブファイルのエレメントが、選択された画面で認識されていることを意味します。「一致」オプションが選択されている場合、認識されたエレメントは強調表示されます。強調表示の色を変更するには、HATS 設定の「画面キャプチャーの強調表示時の色」セクションの「パターン・マッチング」設定を使用します。詳しくは、HATS プリファレンスの使用を参照してください。
- 非認識: この状態は、サブファイルのエレメントが、認識されていないことを意味します。認識されるまで、画面領域または認識基準を調整し、設定を微調整する必要があります。
- 不明: この状態は、このエレメントの認識が、まだ認識されていない別のエレメントに依存していることを表しています。最初に他のタブの認識されていない設定を微調整してから、このタブに戻ってください。
4 つのタブすべてが認識されたという標識を表示している場合、「OK」をクリックします。 ウィジェットのプレビューで認識された結果を表示することができます。
各認識タブの説明を以下に示します。
アクション
使用する画面をドロップダウン・リストから選択します。マウスを使用するかまたは以下のボックス内に領域の座標を入力して、ホスト画面上の「選択」エリアの領域を指定することもできます。
- 開始行
- サブファイル・アクションが検索される最初の行です。デフォルトは 3 です。
- 終了行
- サブファイル・アクションが検索される最後の行です。デフォルトは 12 です。
- 開始列
- サブファイル・アクションが検索される最初の列です。デフォルトは 1 です。
- 終了列
- サブファイル・アクションが検索される最後の列です。デフォルトは 80 です。
ホスト画面の特定のフィールドを強調表示するには、「フィールドを強調表示 (Highlight fields)」の隣にある各オプションを選択します。入力フィールドが画面上で定義されている位置を表示するには、「入力」を選択します。保護フィールドを表示するには、「保護」を選択します。隠しフィールドを強調表示するには、「非表示」を選択します。 一致するパターンを表示するには、「一致」を選択します。入力フィールド、保護フィールド、隠しフィールド、またはパターン・マッチング・フィールドの強調表示の色を変更する方法については、HATS プリファレンスの使用を参照してください。
- アクションの認識
- 以下の個別設定を選択すると、追加のアクションの認識基準を構成できます。
- 先行トークンの前のストリング
- ストリング。この値は先行トークンの前のストリングを指定します。デフォルト値はスペースです。
- 先行トークンのタイプ
- ストリング。この値は、ホスト・コマンドに対して、ホスト・アプリケーションが使用するトークンのタイプです。「1=Edit」という例では、1 トークンがホスト・コマンドで、そのタイプは数字となります。「A=Edit」という例では、A トークンがホスト・コマンドで、そのタイプは文字となります。許容値は、「数字」、「文字」、「両方を表示」です。デフォルトは「両方を表示」です。
- 先行トークンの最大長 (Maximum length of leading token)
- 先行トークンの最大長。デフォルトは 4 です。
- 区切り文字
- ストリング。この値は、サブファイル・アクションで使用されるトークンであり、ホスト・コマンド内の説明からホスト・コマンドを区切ります。「1=Edit」という例では、「1」がホスト・コマンド、= トークンが区切り文字、「Edit」 がホスト・コマンドの説明です。許容値は、縦線 (|) で連結された 1 つ以上のストリングです。デフォルトは = です。例: =| = |-| - |:。
- 終了区切り文字
- ストリング。これは、サブファイル・アクション項目の説明の終了を認識するために使用されます。複数の文字を指定する場合は縦線 (|) で区切ります。
- 指定の色でなければならない
- このボックスは前の設定と連動して使用し、サブファイル・アクションのホスト・コマンドが特定のタイプでなければならないこと、およびサブファイル・アクションが特定の色でなければならないことを示します。例えば、サブファイル・アクションは数字に、色は青にすると指定できます。
- 色
- 前の設定の説明を参照してください。
- 高輝度
- ストリング。この値は、サブファイル・アクションが高輝度フィールド属性を使用するかどうかを指定します。許容値は、「はい」、「いいえ」、「どちらでも可」です。デフォルトは「どちらでも可」です。
- アクションは不要 (Actions not required)
- サブファイルにアクションがなくてもサブファイルを認識させる場合は、このボックスを選択します。アクションがなくてもサブファイル・ヘッダー、データ、およびマーカーが認識およびレンダリングされます。
- アクションのすぐ上にある空でない行を消費
- アクションの真上およびすぐ隣にあるテキストを含む画面上の行 (色および/または輝度の認識基準を満たす) をサブファイル・ウィジェットで消費するが表示しない場合、このボックスを選択します。
マウスを使用するかまたは以下のボックス内に領域の座標を入力して、ホスト画面上の「選択」エリアの領域を指定します。
- 開始行
- サブファイル・ヘッダーが検索される最初の行です。デフォルトは 3 です。
- 終了行
- サブファイル・ヘッダーが検索される最後の行です。デフォルトは 16 です。
- 開始列
- サブファイル・ヘッダーが検索される最初の列です。デフォルトは 1 です。
- 終了列
- サブファイル・ヘッダーが検索される最後の列です。デフォルトは 80 です。
ホスト画面の特定のフィールドを強調表示するには、「フィールドを強調表示 (Highlight fields)」の隣にある各オプションを選択します。入力フィールドが画面上で定義されている位置を表示するには、「入力」を選択します。保護フィールドを表示するには、「保護」を選択します。隠しフィールドを強調表示するには、「非表示」を選択します。 一致するパターンを表示するには、「一致」を選択します。入力フィールド、保護フィールド、隠しフィールド、またはパターン・マッチング・フィールドの強調表示の色を変更する方法については、HATS プリファレンスの使用を参照してください。
- ヘッダーの認識
- 以下の個別設定を選択すると、追加のヘッダーの認識基準を構成できます。
- テキストによって認識
- ブール値です。この値は、サブファイル・ヘッダーがストリングに基づいて認識されるかどうかを指定します。許容値は、true または false です。デフォルトは
true です。
- 開始
- ストリング。サブファイル・ヘッダーの識別に使用できるストリングです。複数行のヘッダーを定義するには、¥n を使用します。複数の許容値は縦線 (|) で連結します。より具体的なヘッダーを最初にリストします。例えば、「Option」、「Opt 」、および 「Opt」がすべて考えられるヘッダーである場合、それらは、最も具体的なヘッダーが最初にリストされるような順序で「Option|Opt
|Opt」とリストされます。デフォルトは true です。例: Description¥nof Record|Option|Opt
|?
- 指定の色でなければならない
- ブール値です。この値は「テキスト」設定と連動して使用して、サブファイル・ヘッダーが特定のストリングを持ち、特定の色でなければならないことを示します。例えば、サブファイル・ヘッダーは「Opt.」という語を含み、色は青でなければなりません。許容値は、true または false です。デフォルトは false です。
- 色
- サブファイル・ヘッダーの色を指定します。
- 高輝度
- サブファイル・ヘッダーが、高輝度フィールド属性を使用するデータ・テーブル上部のテキストによって認識できるかどうかを指定するには、このボックスを選択します。
- 指定の色
- データ・テーブルの最初にある特定の色のテキストがサブファイル・ヘッダーを認識できるかどうかを指定するには、このボックスを選択します。
- 色
- サブファイル・ヘッダーの色を指定します。
データ
マウスを使用するかまたは以下のボックス内に領域の座標を入力して、ホスト画面上の「選択」エリアの領域を指定します。
- 開始行
- サブファイル・データが検索される最初の行です。デフォルトは 4 です。
- 終了行
- サブファイル・データが検索される最後の行です。デフォルトは 22 です。
- 開始列
- サブファイル・データが検索される最初の列です。デフォルトは 1 です。
- 終了列
- サブファイル・データが検索される最後の列です。デフォルトは 80 です。
ホスト画面の特定のフィールドを強調表示するには、「フィールドを強調表示 (Highlight fields)」の隣にある各オプションを選択します。入力フィールドが画面上で定義されている位置を表示するには、「入力」を選択します。保護フィールドを表示するには、「保護」を選択します。隠しフィールドを強調表示するには、「非表示」を選択します。 一致するパターンを表示するには、「一致」を選択します。入力フィールド、保護フィールド、隠しフィールド、またはパターン・マッチング・フィールドの強調表示の色を変更する方法については、HATS プリファレンスの使用を参照してください。
- データの認識
- 以下の個別設定を選択して、追加のデータの認識基準を構成できます。
- 認識オプション: (Recognition Option:)
- この設定では、サブファイル・データ領域の認識方法が指定されます。
- フィールド Web のみ
- サブファイル・データを行単位で認識します。
注:
リッチ・クライアント・アプリケーションの場合は、サブファイルを行単位でレンダリングするには、以下のサブファイル・ウィジェット設定を使用します。
- 「行の代替色の表示」を選択する
- 「格子線の表示」をクリアする
- 「列見出しのソース」の「コンポーネントから」を選択する
- 「クラシック見出しスタイルを使用」を選択する
- 「フォントのオーバーライド」を選択し、モノスペース・フォントを選択する
- テーブル (フィールド) Web のみ
- サブファイル・データをフィールド情報により認識します。
- テーブル (可視)
- 可視の垂直列区切り文字を使用するテーブルとして表示されるサブファイル・データを認識します。
- テーブル
- ユーザー定義の列の切れ目を使用するテーブルとして表示されるサブファイル・データを認識します。
- 列区切り文字:
- 「認識オプション:」が「テーブル (可視)」に設定されている場合にのみ使用可能です。テーブルの列としてマークされる対象のホスト画面の列に対して、選択領域のすべての行の同一列に含まれている必要がある文字ストリングです。連続する列が、それぞれ区切り列としてマークされている場合は、最後の列のみが、生成されるテーブルの区切り列として実際にレンダリングされます。デフォルトはスペース文字です。
- 列の切れ目:
- 「認識オプション:」が「テーブル」に設定されている場合にのみ使用可能です。列の切れ目として使用する必要がある列番号をコンマで区切ってリストします。例えば 1,7,22 は、列 1、7、および 22 から新しい列が開始されることを示します。「デフォルトの復元」ボタンをクリックすると、「列の切れ目」フィールドに、「テーブル (可視)」のデフォルト認識値に基づく値が入ります。
注:
- 列の切れ目を追加または除去するには、マウスを使用してホスト画面ビューで列を選択し、右クリックして「追加」または「除去」を選択します。ホスト画面ビューでは、列の切れ目は縦の点線として示されます。
- 列の切れ目によって入力フィールドを分割することはできません。
- DBCS がサポートされている状態でのこの設定の使用の詳細については、サブファイルを参照してください。
- アクション入力フィールド開始列をオーバーライド (Override action input field start column)
- これを選択した場合は、アクション入力フィールドの開始列をオーバーライドして他の入力フィールドが誤ってドロップダウン・リストとしてレンダリングされないようにできます。
- 列開始 (Column Start)
- アクション入力フィールドの開始列。デフォルト値は 1 です。
- アクション入力フィールド長をオーバーライド (Override action input field length)
- これを選択した場合は、アクション入力フィールドの長さをオーバーライドして、他の入力フィールドが誤ってドロップダウン・リストとしてレンダリングされないようにできます。
- フィールド長
- アクション入力フィールドのフィールド長。デフォルト値は 1 です。
- データは不要 (Data not required)
- サブファイルにデータがない場合でもサブファイルを認識させる場合は、このボックスを選択します。サブファイル・アクションが検出された場合は、ドロップダウン・リストとしてレンダリングされます。
- 空行を含める
- ホスト画面上のテーブルにある空の行を、テーブルの変換時に含める場合は、このボックスを選択します。空の行を破棄する場合は、このボックスをクリアします。
マーカー
マウスを使用するかまたは以下のボックス内に領域の座標を入力して、ホスト画面上の「選択」エリアの領域を指定します。
- 開始行:
- サブファイル・マーカーが検索される最初の行です。デフォルトは 4 です。
- 終了行:
- サブファイル・マーカーが検索される最後の行です。デフォルトは 22 です。
- 開始列
- サブファイル・マーカーが検索される最初の列です。デフォルトは 1 です。
- 終了列
- サブファイル・マーカーが検索される最後の列です。デフォルトは 80 です。
ホスト画面の特定のフィールドを強調表示するには、「フィールドを強調表示 (Highlight fields)」の隣にある各オプションを選択します。入力フィールドが画面上で定義されている位置を表示するには、「入力」を選択します。保護フィールドを表示するには、「保護」を選択します。隠しフィールドを強調表示するには、「非表示」を選択します。 一致するパターンを表示するには、「一致」を選択します。入力フィールド、保護フィールド、隠しフィールド、またはパターン・マッチング・フィールドの強調表示の色を変更する方法については、HATS プリファレンスの使用を参照してください。
- マーカーの認識
- 以下の個別設定を選択すると、追加のマーカーの認識基準を構成できます。
- テキストによって認識
- これを選択した場合、指定されたテキスト・ストリングによってサブファイルの終了マーカーを認識できます。
- テキスト
- ストリング。これは、サブファイル終了マーカーの識別に使用できます。複数の値が使用できます。例: More...|Bottom|End|+。デフォルト値は More...|Bottom|+ です。
- 高輝度
- これを選択した場合、データ・テーブルの下にある高輝度フィールドによってサブファイルの終了マーカーを認識できます。
- 可視テキストは不要です
- これを選択した場合は、高輝度フィールドに空ストリングを挿入できます。
- 空行
- これを選択した場合、データ・テーブルの下にある指定された領域内の空行によってサブファイルの終了マーカーを認識できます。
__________________________________________________________________________
テーブル
テーブル・コンポーネントは、テーブルを認識します。求められる結果を得るために列の切れ目として特定の列番号を指定する必要がある場合は、テーブル (可視) コンポーネントの代わりにこのコンポーネントを使用できます。
デフォルト・レンダリング設定でテーブル・コンポーネントを使用する場合は注意してください。これは、テーブル・コンポーネントは選択されている領域でほぼすべての画面を認識し、リスト内のこれより下位のレンダリング項目が認識されないためです。
認識されたテーブルは、以下のウィジェットによるレンダリングが可能になります。
次の図は、ホスト画面上のテーブル・コンポーネントの表示例を示します。
- タイトル行
- 列の切れ目
以下の設定が、このコンポーネントに対して構成できます。
- 列の切れ目:
- 列の切れ目として使用する必要がある列番号をコンマで区切ってリストします。例えば 1,7,22 は、列 1、7、および 22 から新しい列が開始されることを示します。「デフォルトの復元」ボタンをクリックすると、「列の切れ目」フィールドに、「表示されるテーブル」のデフォルト認識値に基づく値が入ります。
注:
- 列の切れ目を追加または除去するには、マウスを使用してホスト画面ビューで列を選択し、右クリックして「列を追加」または「列を除去」を選択します。列の左クリック操作でも、列の切れ目を追加または除去できます。ホスト画面ビューでは、列の切れ目は縦の点線として示されます。
- 列の切れ目によって入力フィールドを分割することはできません。
- DBCS がサポートされている状態でのこの設定の使用の詳細については、テーブルを参照してください。
- 空行を含める
- これを選択した場合、表示されたテーブルまたはグラフに空行 (表示テキストまたは入力フィールドがない行) が含まれます。
- 除外するテーブル行
- 認識されたテーブルから除外するコンマで区切られた行や範囲指定された行セット。この設定は、テーブルまたはグラフ上の特定の複数行のデータを隠す場合に有効です。この値で表される行は、実際のホスト画面ではなく、認識されるテーブルに基づきます。値の例: 1,2,3....、1、2 から 4、3 から 5。
- 除外するテーブル列
- 認識されたテーブルから除外するコンマで区切られた論理列や範囲指定された論理列セット。この値で表される列は、実際のホスト画面ではなく、認識されるテーブルに基づきます。値の例: 1,2,3....、1、2 から 4、3 から 5。
- タイトル行の数
- ヘッダーとしてレンダリングする行の領域上部からの行数を指定します。1 よりも大きい値を指定すると、列ごとにヘッダー行が単一行のストリングとしてレンダリングされます。
__________________________________________________________________________
テーブル (フィールド)
テーブル (フィールド) コンポーネントは、縦方向に位置合わせされたフィールドの論理列を認識します。テーブル (フィールド) として認識される領域の場合、選択領域内に含まれる各フィールド (部分フィールドも含む) の左右の境界線は、その直上のフィールド (問題のフィールドが最初の行でない場合) および直下のフィールド (問題のフィールドが最後の行でない場合) の左右の境界線と同じである必要があります。
認識されたテーブル (フィールド) は、以下のウィジェットによってレンダリングできます。
次の図に、ホスト画面上のテーブル (フィールド) コンポーネントの表示例を示します。
図 27. テーブル (フィールド) コンポーネントの例
- 行
- 列
以下の設定が、このコンポーネントに対して構成できます。
- 空行を含める
- これを選択した場合、表示されたテーブルまたはグラフに空行 (表示テキストまたは入力フィールドがない行) が含まれます。
- 除外する行
- 認識されたテーブルから除外するコンマで区切られた行や範囲指定された行セット。この設定は、テーブルまたはグラフ上の特定の複数行のデータを隠す場合に有効です。この値で表される行は、実際のホスト画面ではなく、認識されるテーブルに基づきます。値の例: 1,2,3...、1、2 から 4、3 から 5。
- 除外する列
- 認識されたテーブルから除外するコンマで区切られた論理列や範囲指定された論理列セット。この値で表される列は、実際のホスト画面ではなく、認識されるテーブルに基づきます。値の例: 1,2,3...、1、2 から 4、3 から 5。
- 最小行数
- 指定された領域が、テーブルと認識されるために含むべき必要最小限の行数です。
注:
認識された行の数は、指定した行が除外される前に評価されます (『除外する行』を参照してください)。
- 最小列数
- 指定された領域が、テーブルと認識されるために含むべき必要最小限の (ホスト画面列ではなく) 論理列の数です。
注:
認識された列の数は、指定した列が除外される前に評価されます (『除外する列』を参照してください)。
- テーブルの上の行から列見出しテキストを抽出
- テーブルの上の行にあるテキストをテーブルの列ヘッダーとして使用する場合は、このボックスを選択します。列ヘッダーは保護フィールド内に位置している必要があります。
注:
テーブルを作成したホスト画面マップへのアクセス権限がない場合、テーブル (可視) コンポーネントを使用してテーブル領域を認識します。この操作が可能でない場合、「ホスト・コンポーネントを挿入」ウィザードの最初のページの「入力」、「保護」、および「非表示」の各オプションをオンにして、選択したホスト画面領域内のフィールドの区切りを判別しやすくします。
__________________________________________________________________________
テーブル (可視)
テーブル (可視) コンポーネントは、テーブルを認識します。テーブル (可視) コンポーネントは、基底のホスト画面フィールドが垂直方向に整列されている必要がない点でテーブル (フィールド) コンポーネントと異なります。このコンポーネントは、選択領域で、選択内の各行に列区切り文字を含む列を検索します。経験法則: 領域がテーブルのように示されている場合は、通常、テーブル (可視) コンポーネントがその領域を認識できます。
認識されたテーブルは、以下のウィジェットによるレンダリングが可能になります。
次の図に、ホスト画面上のテーブル (可視) コンポーネントの表示例を示します。
図 28. テーブル (可視) コンポーネントの例
- 行 (最小行数 = 1)
- 列 (最小列数 = 1)
- 列区切り文字 (スペース)
以下の設定が、このコンポーネントに対して構成できます。
- 列区切り文字
- 必須です。テーブルの列としてマークされているホスト画面列の選択された領域の各行に存在している必要がある文字ストリング。連続する列が、それぞれ区切り列としてマークされている場合は、最後の列のみが、生成されるテーブルの区切り列として実際にレンダリングされます。
- 空行を含める
- これを選択した場合、表示されたテーブルまたはグラフに空行 (表示テキストまたは入力フィールドがない行) が含まれます。
- 除外する行
- 認識されたテーブルから除外するコンマで区切られた行や範囲指定された行セット。この設定は、テーブルまたはグラフ上の特定の複数行のデータを隠す場合に有効です。この値で表される行は、実際のホスト画面ではなく、認識されるテーブルに基づきます。値の例: 1,2,3....、1、2 から 4、3 から 5。
- 除外する列
- 認識されたテーブルから除外するコンマで区切られた論理列や範囲指定された論理列セット。この値で表される列は、実際のホスト画面ではなく、認識されるテーブルに基づきます。値の例: 1,2,3....、1、2 から 4、3 から 5。
- 最小行数
- 指定された領域が、テーブルと認識されるために含むべき必要最小限の行数です。
注:
認識された行の数は、指定した行が除外される前に評価されます (『除外する行』を参照してください)。
- 最小列数
- 指定された領域が、テーブルと認識されるために含むべき必要最小限の (ホスト画面列ではなく) 論理列の数です。
注:
認識された列の数は、指定した列が除外される前に評価されます (『除外する列』を参照してください)。
- テーブルの上の行から列見出しテキストを抽出
- テーブルの上の行にあるテキストをテーブルの列ヘッダーとして使用する場合は、このボックスを選択します。列ヘッダーは保護フィールド内に位置している必要があります。
グラフ・ウィジェットを使用してテーブル (可視) コンポーネントをレンダリングする一部の HATS V4 アプリケーションでは、HATS V7.5.1 にマイグレーションした後に変更が必要です。この問題は、HATS アプリケーションが以下のような空の列があるテーブル・データを含むホスト画面をレンダリングする場合に発生します。
| Col1 |
Col2 |
Col3 |
| aaa |
|
bbb |
| ccc |
|
ddd |
| eee |
|
fff |
| ggg |
|
hhh |
HATS V4 テーブル (可視) コンポーネントは、このホスト画面領域に 3 つの列が含まれると認識しました。これを 2 つの行のある棒グラフとして表示するには、行 2 のデータをホスト画面領域の列 3 から取得するように指定する必要がありました。HATS バージョン 5 以降では、テーブル (可視) コンポーネントはこのホスト画面領域に 2 つの列が含まれているものとして認識します。3 番目の列がないため、グラフ・ウィジェットの 2 番目の行にはデータが表示されません。この問題を修正するには、2 番目の行のデータをホスト画面領域の列 2 から取得するように棒グラフ設定を変更する必要があります。
__________________________________________________________________________
テキスト
テキスト・コンポーネントは、入力フィールド内のテキストを含めて、表示されるテキストの認識を担当します。
このコンポーネントは、ラベル ウィジェットを使用してレンダリングが可能です。
次の図は、ホスト画面上のテキスト・コンポーネントの表示例を示します。
- 改行 (保存)
以下の設定が、このコンポーネントに対して構成できます。
- 改行を保存
- これを選択した場合、選択した複数の行が、結果の Web ページ上で複数の行としてレンダリングされます。クリアした場合は、各行のテキストが単一のストリングに連結されます。
__________________________________________________________________________
URL
URL コンポーネントは、リンクの認識を担当します。このコンポーネントは、保護された非隠しフィールド内のみを検索します。 このコンポーネントは、リンク ウィジェットを使用してレンダリングが可能です。
次の図は、ホスト画面上の URL コンポーネントの表示例を示します。
- 開始標識 (http://)
以下の設定が、このコンポーネントに対して構成できます。
- 開始標識
- ホスト画面上で URL の開始を認識する 1 つ以上の文字ストリングを指定します。
ウィジェット設定
ホスト・コンポーネントをカスタマイズする場合、ホスト・コンポーネントを認識する方法を指定します。ウィジェットをカスタマイズするのは、ウィジェットが Web ページ上で表示される方法を指定するためです。
以降のセクションでは、カスタマイズ可能なウィジェットの設定について説明します。
ウィジェット設定ダイアログでウィジェット設定を設定または変更すると、ユーザーが「OK」をクリックして変更内容をコミットする前に、ウィジェット・プレビュー領域が自動的に更新され、行った変更の結果が表示されます。
__________________________________________________________________________
ボタン・ウィジェットは、HTML ボタンのレンダリングを担当します。HTML ボタンの 1 つをクリックすると、普通、ホスト指定アクションが実行されます (例えば、補助キーがホストに送信されるか、入力フィールドが更新されます)。
このウィジェットは、以下のコンポーネントが提供するデータをレンダリングします。
次の図に、変換においてファンクション・キー・コンポーネントの例のデータを入力として使用するボタン・ウィジェットの表示例を示します。
- 行
- 列 (1 行あたり 3)
- 表題のタイプ (説明を表示)
以下の設定が、このウィジェットに対して構成できます。
- 表題のタイプ
- 各ボタンの表題を決定する方法を指定します。コンポーネントから先行トークンの値および説明が取り込まれます。つまり、ボタンの表題上に表示される項目を選択できます。例えば、ホスト画面に「4. メール」というメニュー項目が存在する場合、表題表示として「4」、「メール」、または「4. メール」を選択できます。
- 表題のスペースをトリム (Trim spaces on caption)
- これを選択した場合、表題の両端から空白 (余分なスペース) が除去されます。
- レイアウト
- HTML ページでのボタンの配置方法を指定します。オプション: 「テーブル」、「分離」。
注:
- この設定はファンクション・キー・コンポーネントが使用されている場合、デフォルト・レンダリングでは適用されません。
- ウィジェットのプレビューは必ずしも全ページのプレビューと一致するとは限りません。これはウィジェットのプレビューが単にコンポーネントの出力をレンダリングしているだけであるために起こります。ウィジェットのプレビューは、全ページのプレビューで行われているように、レンダリングしたときに画面の配置を保存しようとはしません。
- 1 行あたりの列数
- 次の行に折り返されるまでに、水平方向に表示されるボタンの数です。この設定を微調整して、ボタンを垂直方向に (この値が 1 の場合) または水平方向に (この値が、レンダリング対象ボタンの数以上の場合) 表示することができます。
- 分離文字
- HTML ページ上でレンダリングされたボタンを区切るために使用する分離文字を指定します。ドロップダウン・リストから選択するか入力フィールドに手動で入力するかを選択できます。
- 前景色を使用可能にする Web のみ
- これを選択した場合、ボタン・テキストが、ホスト画面から抽出された色を使用して、コンポーネントによってレンダリングされます (ファンクション・キー・コンポーネントの使用時に限り適用可能)。
色情報は、ファンクション・キーのいずれかの部分を含む最初のホスト・フィールドに対して抽出されます。 ファンクション・キーが、F12= および Exit などの 2 つのフィールドに分割された場合、F12= を含むフィールドの色情報が抽出されます。
- ボタンのスタイル・クラス Web のみ
- オプションです。生成される各ボタンに関連する CSS スタイル・クラスです。HTML ボタン・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSBUTTON です。詳細については、スタイル・シートの使用を参照してください。
- スタイル Web のみ
- オプションです。オーバーライドする任意の CSS プロパティー。例えば、このフィールドに「font-color: red; font-size:
18pt;」と指定して、このウィジェットのフォントの色およびサイズを変更できます。入力したプロパティーは、このウィジェットの各エレメントに適用されます。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
__________________________________________________________________________
ボタン・テーブル
ボタン・テーブル・ウィジェットは、垂直方向に並んでいる HTML ボタンのテーブルのレンダリングを担当します。
このウィジェットは、以下のコンポーネントが提供するデータをレンダリングします。
次の図に、変換においてファンクション・キー・コンポーネントの例のデータを入力として使用するボタン・テーブル・ウィジェットの表示例を示します。
- 行
- 1 行あたりの列数 (2)
- 表題
以下の設定が、このウィジェットに対して構成できます。
- 1 行あたりの列数
- 次の行に折り返されるまでに、水平方向に表示されるボタンの数です。
注:
- この設定はファンクション・キー・コンポーネントが使用されている場合、デフォルト・レンダリングでは適用されません。
- ウィジェットのプレビューは必ずしも全ページのプレビューと一致するとは限りません。これはウィジェットのプレビューが単にコンポーネントの出力をレンダリングしているだけであるために起こります。ウィジェットのプレビューは、全ページのプレビューで行われているように、レンダリングしたときに画面の配置を保存しようとはしません。
- ボタンのスタイル・クラス Web のみ
- オプションです。生成される各ボタンに関連する CSS スタイル・クラスです。HTML ボタン・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSBUTTON です。詳細については、スタイル・シートの使用を参照してください。
- 表題のスタイル・クラス Web のみ
- オプションです。(生成されるボタンの右側の) 各項目の説明に関連する CSS スタイル・クラスです。デフォルト値は HATSCAPTION です。詳細については、スタイル・シートの使用を参照してください。
- テーブルのスタイル・クラス Web のみ
- オプションです。生成されるテーブルに関連する CSS スタイル・クラスです。HTML テーブル・タグの class 属性の値には、この値がセットされます。デフォルトは HATSTABLE です。詳細については、スタイル・シートの使用を参照してください。
- スタイル Web のみ
- オプションです。オーバーライドする任意の CSS プロパティー。例えば、このフィールドに「font-color: red; font-size:
18pt;」と指定して、このウィジェットのフォントの色およびサイズを変更できます。入力したプロパティーは、このウィジェットの各エレメントに適用されます。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
- 色のオーバーライド RCP のみ
- 前景色と背景色を指定変更する場合は、このオプションを選択して、提供されている「前景色」と「背景色」の設定コントロールを使用します。
__________________________________________________________________________
カレンダー Web のみ
カレンダー・ウィジェットは、関連のランチャー・ボタン、リンク、またはイメージを持つ入力フィールドのレンダリングを担当します。このランチャーでは、日付を選択するのに使用できるカレンダー日付ピッカーが開きます。選択された日付は、関連入力フィールドに挿入されます。
注:
- Rational SDP に組み込まれた Web ブラウザーを使用して WebSphere® テスト環境でプロジェクトをテストする場合は、予想よりも大きなブラウザー・ウィンドウ内にカレンダー・ウィジェットが表示され、追加の不要なコントロールが表示されることがあります。外部ブラウザーでアプリケーションを実行する場合またはデプロイ済みアプリケーションを実行する場合には、この問題は発生しません。
- このウィジェットを使用する際の DBCS に関する考慮事項については、SBCS での最大長の除去を参照してください。
次の図は、「インライン・カレンダーを使用 (Use inline calendar)」設定が選択されているときに、変換でカレンダー・ウィジェットとその日付ピッカーがどのように表示されるかを示しています。
図 33. インライン日付ピッカーを使用したカレンダー・ウィジェットの例
次の図は、「インライン・カレンダーを使用 (Use inline calendar)」設定がクリアされているときに、変換でカレンダー・ウィジェットとその日付ピッカーがどのように表示されるかを示しています。
図 34. ウィンドウ日付ピッカーを使用したカレンダー・ウィジェットの例
- 1 行あたりの列数 (1)
- 表題 (コンポーネントから)
- ランチャー・タイプ (イメージ)
注:
これらの例では、ランチャーはイメージであるため、ランチャーに対する表題はありません。ランチャーがボタンまたはリンクである場合は、ランチャーの表題がボタンまたはリンクに表示されます。
以下の設定が、このウィジェットに対して構成できます。
- パターン
-
必須です。ユーザーがカレンダー・ウィジェットから日付を選択すると、選択された日付をホスト・アプリケーションの入力フィールドで予期されるフォーマットに正しくマップするようにフォーマット設定する必要があります。この設定は、選択された日付を正しくフォーマット設定するために HATS が使用するパターンを指定します。パターン内の記号の意味については、http://java.sun.com/j2se/1.3/docs/api/java/text/SimpleDateFormat.html を参照してください。
パターンを入力して保存すると、HATS Toolkit は正しい記号が使用されていることを確認するために以下の変換を実行します。
- 大文字の D から小文字の d
- 大文字の Y から小文字の y
- 小文字の m から大文字の M
- 小文字の e から大文字の E
注:
HATS Toolkit は、常にパターンを大文字で表示します。パターン・シンボルの実際の大/小文字を参照するには、application.hap ファイルのソースで com.ibm.hats.transform.widgets.CalendarWidget クラスのパターン設定を参照してください。
パターン要素をチルド (~) で区切ることによって、選択されている日付を複数の連続ホスト入力フィールドに分散させることができます。例えば、ホスト画面上に以下の入力フィールドが存在するものとします。
Month: [ ] Day: [ ] Year: [ ]
MM~DD~YYYY というパターンを指定すると、単一のランチャーが作成されます。ユーザーが日付を選択すると、日付は 3 つの入力フィールドに挿入されます。月 (2 桁) が最初の入力フィールド、日 (2 桁) が 2 番目の入力フィールド、および年 (4 桁) が 3 番目の入力フィールドに挿入されます。
注:
複数のホスト入力フィールドにわたるパターンを指定する補助機能を使用するには、「ビルド」ボタンをクリックします。
- パターン・ロケール
- パターンのロケールを指定します。この設定は、曜日の名前 (例: 水曜日) を出力するパターン・セグメントを入力した場合に便利です。オプション: 「サーバーのロケールを使用」、「ブラウザーのロケールを使用」、または「指定のロケールを使用」。
- ロケール (Locale)
- 「指定のロケールを使用」を指定した場合は、ユーザーによって指定された日付をフォーマット設定するロケールを選択します。
- 選択可能な最も古い日付を制限
- これを選択した場合、指定される値は、ユーザーがポップアップ・カレンダーから選択可能な最も古い日付となります。
注:
- すべてのロケールで、日付パターンは MM/DD/YYYY です。
- この設定では、関連する入力フィールドにユーザーが古い日付を手動で直接入力する操作は防止されません。
- 選択可能な最も新しい日付を制限
- これを選択した場合、指定される値は、ユーザーがポップアップ・カレンダーから選択可能な最新の日付となります。
注:
- すべてのロケールで、日付パターンは MM/DD/YYYY です。
- この設定では、関連する入力フィールドにユーザーが新しい日付を手動で直接入力する操作は防止されません。
- デフォルト値
- オプションです。このフィールドの値は、ホスト・アプリケーションで関連の入力フィールドに、有効な日付 (指定された日付制限の間の日付) が事前に設定されなかった場合、ポップアップ・カレンダーで選択される初期日付です。また、ユーザーがポップアップ・カレンダー・コントロールを選択する前に入力した日付が誤っている場合 (範囲外の日付など) にも使用されます。このフィールドと関連するホスト入力フィールドとの間の相互作用は、次のように処理されます。
- ホスト・アプリケーションにより入力フィールドにゼロまたは不適切な日付形式が事前に設定されると、このホスト・フィールドのデータはデフォルト値によって上書きされません。関連の入力フィールドを更新するには、ユーザーが手動で日付を入力するか、またはポップアップ・カレンダーから日付を選択する必要があります。
- デフォルト値が指定されていないか、またはデフォルト値のフォーマットが誤っている場合、本日の日付が最初にポップアップ・カレンダーで選択されます。
- 関連の入力フィールドにデータを事前に設定するには、変換を適用する前に、画面カスタマイズ・イベントに「データを挿入」アクションを追加します。
注:
すべてのロケールで、日付パターンは MM/DD/YYYY です。
- 表題ソース (Caption source)
- 生成される入力フィールドの表題を決定する方法を指定します。オプション: 「コンポーネントから」 (コンポーネントから取り出した表題を使用) または「カスタム」(指定された表題を使用)。
- カスタム表題
- オプションです。入力フィールドの表題を指定します。
注:
入力フィールドの表題を生成しない場合は、この設定をブランクのままにしてください。
- 1 行あたりの列数
- レンダリングした Web ページの各行に表示するこのウィジェットのインスタンスの数を指定します。
注:
- この設定はデフォルト・レンダリングでは適用されません。
- ウィジェットのプレビューは必ずしも全ページのプレビューと一致するとは限りません。これはウィジェットのプレビューが単にコンポーネントの出力をレンダリングしているだけであるために起こります。ウィジェットのプレビューは、全ページのプレビューで行われているように、レンダリングしたときに画面の配置を保存しようとはしません。
- ランチャー・タイプ
- ランチャーのスタイルを指定します。ランチャーを使用して、カレンダー日付ピッカーを開きます。オプション: 「ボタン」、「リンク」、または「イメージ」。
- 表題
- ランチャー・ボタンまたはリンクの表題。
- ボタンのスタイル・クラス
- オプションです。生成されるランチャー・ボタンに関連する CSS スタイル・クラスです。HTML ボタン・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSBUTTON です。詳細については、スタイル・シートの使用を参照してください。
- リンクのスタイル・クラス
- オプションです。生成されるランチャー・リンクに関連する CSS スタイル・クラスです。HTML リンク・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSLINK です。詳細については、スタイル・シートの使用を参照してください。
注:
Web ブラウザーに応じて、
「リンク」スタイルまたは
「イメージ」スタイルのいずれかが選択されている場合、タブ・キーを使用したこのランチャーへのタブ移動に制限が存在する可能性があります。サポートされる Web ブラウザーと制約事項のリストについては、HATS インフォメーション・センター (
http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp) の HATS 前提条件のセクションを参照してください。
- インライン・カレンダーを使用
- 選択されている場合、カレンダー日付ピッカーが起動され、現在の Web ページ内に表示されます。クリアされている場合、日付ピッカーは新規ブラウザー・ウィンドウに表示されます。新規に作成されるプロジェクトでは、デフォルトで選択されています。HATS V7.5.1 より前のリリースからマイグレーションされるプロジェクトの場合、デフォルトでクリアされています。
注:
- インライン・カレンダー日付ピッカーの使用は、ポップアップ・ブロッカーにより新規ブラウザー・ウィンドウで日付ピッカーを表示できない場合に役立ちます。
- インライン・カレンダー日付ピッカーの使用は、モバイル装置用の HATS アプリケーションの場合はサポートされません。
- 読み取り専用
- これを選択した場合、レンダリングされた入力フィールドは読み取り専用になります。読み取り専用の入力フィールドは通常の入力フィールドのように表示されますが、ユーザーはこのフィールドの内容を変更できません。これは、無保護フィールドの内容をユーザーに対して表示するが、ユーザーがフィールドの内容を変更できないようにする場合に便利です。
- 入力フィールドの下線文字を除去 (Strip underscores on input field)
- テキストをレンダリングするときにテキストから下線文字を除去する場合は、このボックスを選択します。
- 入力フィールドのスペースをトリム
- 入力フィールドから先行および後続のスペースをトリムする場合は、このボックスを選択します。
- 前景色を使用可能にする
- これを選択した場合、ホスト画面の前景色がレンダリングされます。
色はその色を表す CSS スタイルシート・クラスにマップされています。例えば、ホスト画面フィールドが RED とマークされている場合、フィールド・ウィジェットは、そのフィールド用に生成された HTML を、クラス名属性が HRED に設定されているタグで囲みます。この処理によって、ユーザーは、生成される Web ページ上にホスト画面の色を再マップすることができます。
注:
blacktheme.css は、ホスト画面フィールドの前景色を直接マップします (例えば、ホスト画面上の赤色のテキストは、生成された Web ページ上で赤色のテキストとして表示されます)。ただし、monochrome.css などの他のスタイルシート・ファイルは、フィールドの色を別の方法でマップし、一貫性のある、最新のスタイルを作成しようとします。
- 拡張属性を使用可能にする
- これを選択した場合、拡張フィールド属性 (明滅、反転表示、下線、および列分離子) が表示されます。また、3270 Web アプリケーションの場合、拡張フィールドの色もマップされます (詳細については、「前景色を使用可能にする」の設定を参照してください)。詳細については、スタイル・シートの使用を参照してください。
- 明滅スタイル
- ホスト画面における明滅テキストのレンダリングに使用する CSS スタイル設定。
- 反転表示スタイル (Reverse video style)
- ホスト画面における反転表示テキストのレンダリングに使用する CSS スタイル設定。
- 下線スタイル (Underline style)
- ホスト画面における下線付きテキストのレンダリングに使用する CSS スタイル設定。
- 列分離子スタイル (Column separator style)
- ホスト画面における列分離子のレンダリングに使用する CSS スタイル設定。
- 入力フィールドのスタイル・クラス
- オプションです。生成される入力フィールドに関連する CSS スタイル・クラスです。HTML 入力タグの class 属性の値には、この値がセットされます。デフォルト値は HATSINPUT です。詳細については、スタイル・シートの使用を参照してください。
- 表題のスタイル・クラス
- オプションです。生成される入力フィールドの表題に関連する CSS スタイル・クラスです。デフォルト値は HATSCAPTION です。詳細については、スタイル・シートの使用を参照してください。
- テーブルのスタイル・クラス
- オプションです。生成されるテーブルに関連する CSS スタイル・クラスです。入力フィールドの複数の集合がレンダリングされる場合、1 つの HTML テーブルが生成され、それらの入力フィールドを囲みます。HTML テーブル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLE です。詳細については、スタイル・シートの使用を参照してください。
- スタイル
- オプションです。オーバーライドする任意の CSS プロパティー。例えば、このフィールドに「font-color: red; font-size:
18pt;」と指定して、このウィジェットのフォントの色およびサイズを変更できます。入力したプロパティーは、このウィジェットの各エレメントに適用されます。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
__________________________________________________________________________
チェック・ボックス
チェック・ボックス・ウィジェットは、HTML チェック・ボックスのレンダリングを担当します。
このウィジェットは、以下のコンポーネントが提供するデータをレンダリングします。
次の図に、変換においてヒント付き入力フィールド・コンポーネントの例の入力フィールドのデータを入力として使用するチェック・ボックス・ウィジェットの表示例を示します。
- 1 行あたりの列数 (1)
- 表題 (コンポーネントから)
以下の設定が、このウィジェットに対して構成できます。
- 選択された値
- 必須です。チェック・ボックスの選択時にホスト画面の入力フィールドに挿入されるストリングです。この値は、Web ページのロード時のチェック・ボックスの初期状態を設定するためにも使用されます。
- 選択解除された値
- 必須です。チェック・ボックスの選択解除時にホスト画面の入力フィールドに挿入されるストリングです。この値は、Web ページのロード時のチェック・ボックスの初期状態を設定するためにも使用されます。
- 表題ソース (Caption source)
- 生成されるチェック・ボックスの表題を決定する方法を指定します。オプション: 「コンポーネントから」 (コンポーネントから取り出した表題を使用) または「カスタム」(指定された表題を使用)。
- カスタム表題
- オプションです。チェック・ボックスの表題を指定します。
注:
チェック・ボックスの表題を生成しない場合は、この設定をブランクのままにしてください。
- 表題のスペースをトリム (Trim spaces on caption)
- これを選択した場合、表題の両端から空白 (余分なスペース) が除去されます。
- 1 行あたりの列数
- 次の行に折り返されるまでに、水平方向に表示されるチェック・ボックスの数です。
注:
- この設定はデフォルト・レンダリングでは適用されません。
- ウィジェットのプレビューは必ずしも全ページのプレビューと一致するとは限りません。これはウィジェットのプレビューが単にコンポーネントの出力をレンダリングしているだけであるために起こります。ウィジェットのプレビューは、全ページのプレビューで行われているように、レンダリングしたときに画面の配置を保存しようとはしません。
- チェック・ボックスのスタイル・クラス Web のみ
- オプションです。生成されるチェック・ボックスに関連する CSS スタイル・クラスです。HTML 入力タグの class 属性の値には、この値がセットされます。デフォルト値は HATSCHECKBOX です。詳細については、スタイル・シートの使用を参照してください。
- 表題のスタイル・クラス Web のみ
- オプションです。生成されるチェック・ボックスの表題に関連する CSS スタイル・クラスです。デフォルト値は HATSCAPTION です。詳細については、スタイル・シートの使用を参照してください。
- テーブルのスタイル・クラス Web のみ
- オプションです。生成されるテーブルに関連する CSS スタイル・クラスです。チェック・ボックスが複数レンダリングされる場合、1 つの HTML テーブルが生成され、それらのチェック・ボックスを囲みます。HTML テーブル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLE です。詳細については、スタイル・シートの使用を参照してください。
- スタイル Web のみ
- オプションです。オーバーライドする任意の CSS プロパティー。例えば、このフィールドに「font-color: red; font-size:
18pt;」と指定して、このウィジェットのフォントの色およびサイズを変更できます。入力したプロパティーは、このウィジェットの各エレメントに適用されます。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
__________________________________________________________________________
コンボ RCP のみ
コンボ・ウィジェットは、編集可能なドロップダウン組み合わせボックスをレンダリングします。
注:
- セキュリティー上の理由から、コンボ・ウィジェットを使用してパスワード・フィールドをレンダリングしないでください。コンボ・ウィジェットでレンダリングしたパスワード・フィールドに文字を入力すると、ユーザー入力文字として表示されます。
- このウィジェットを使用する際の DBCS に関する考慮事項については、AutoIME 切り替えを参照してください。
このウィジェットは、以下のコンポーネントが提供するデータをレンダリングします。
次の図に、変換においてヒント付き入力フィールド・コンポーネントの例のデータを入力として使用するコンボ・ウィジェットの表示例を示します。
- 表題 (コンポーネントから)
- 1 行あたりの列数 (デフォルトは 1)
- 設定 (ヒントから)
以下の設定が、このウィジェットに対して構成できます。
- グローバル変数から設定
- これを選択した場合、指定したグローバル変数がドロップダウンに設定されます。
- リストの値を含むグローバル変数
- 値の集合を含む索引付きグローバル変数の名前を指定します。グローバル変数内の各索引に対する項目が、ドロップダウンに作成されます。
- 共用
- HATS のローカル・グローバル変数と共用グローバル変数は同じ名前を持つことができます。共用グローバル変数を使用してリスト項目にデータを取り込む場合は、このボックスを選択します。このボックスをクリアした場合は、ローカル・グローバル変数が使用されます。
- リストの表題を含むグローバル変数
- オプションです。表題の集合を含む索引付きグローバル変数の名前を指定します。この値によって指定されるグローバル変数のサイズは、前の設定で指定されたサイズ以上である必要があります。この索引付きグローバル変数の索引は、グローバル変数の値の索引と一致する必要もあります (その結果、ユーザーに表示される実際の値と表題が同期します)。この値が指定されない場合は、ドロップダウン中の各項目の表題が、その値になります。
- ストリングから設定
- これを選択した場合、指定したストリングがドロップダウンに設定されます。
- リスト項目
- オプションです。ドロップダウンに含まれる項目のストリングを指定します。項目はセミコロン (;) で分離する必要があります。リスト項目の表題とリスト項目の値が異なるようにするには、等号 (=) を入力してから表題を指定します。例えば、Apple=A;Grape=G の値を指定すると、2 つの項目「Apple」と「Grape」を持つドロップダウンがレンダリングされます。最初の項目を選択すると、関連するホスト画面の入力フィールドに「A」が挿入されます。
ドロップダウンの項目とホスト画面に挿入される値を同一にするには、項目のみを入力します。例えば Apple=A;G などです。この例では、ドロップダウンとホスト画面の入力フィールドに G が表示されます。
- ヒントから設定
- これを選択した場合、コンポーネントによって認識されたヒントがドロップダウンに設定されます (「ヒント付き入力フィールド」コンポーネントの使用時に限り適用可能)。
- 表題ソース (Caption source)
- 生成されるドロップダウンの表題を決定する方法を指定します。オプション: 「コンポーネントから」 (コンポーネントから取り出した表題を使用) または「カスタム」(指定された表題を使用)。
- カスタム表題
- オプションです。ドロップダウンの表題を指定します。
注:
ドロップダウンの表題を生成しない場合は、この設定をブランクのままにしてください。
- 1 行あたりの列数
- 次の行に折り返されるまでに、水平方向に表示されるドロップダウンの数です。デフォルトは 1 です。
注:
- この設定はデフォルト・レンダリングでは適用されません。
- ウィジェットのプレビューは必ずしも全ページのプレビューと一致するとは限りません。これはウィジェットのプレビューが単にコンポーネントの出力をレンダリングしているだけであるために起こります。ウィジェットのプレビューは、全ページのプレビューで行われているように、レンダリングしたときに画面の配置を保存しようとはしません。
- 最大長をオーバーライド
- これを選択した場合、各生成入力フィールドに指定された最大長の値が設定されます。この設定は、入力フィールドに入力可能な文字数を手動で制限する場合に便利です。クリアした場合は、入力文字の最大許容数は、認識する側のコンポーネントによって決定されます。
- 最大長
- 各入力フィールドに入力可能な最大文字数です。
- 前景色を使用可能にする
- これを選択した場合、ホスト画面の前景色がレンダリングされます。
色は、リッチ・クライアント・テンプレートによってマップされます。
注:
この設定は、「色のオーバーライド」>「前景色」の設定によってオーバーライドされます。
- 拡張属性を使用可能にする
- これを選択した場合、拡張フィールド属性 (明滅、反転表示、下線、および列分離子) が表示されます。
拡張フィールド属性は、リッチ・クライアント・テンプレートによってマップされます。
- フォントのオーバーライド
- デフォルトのフォント名、フォント・スタイル、およびフォント・サイズをオーバーライドするには、このオプションを選択し、提供される「フォント」 設定コントロールを使用します。
- 色のオーバーライド
- 前景色と背景色をオーバーライドするには、このオプションを選択し、提供される「前景色」および「背景色」設定コントロールを使用します。
__________________________________________________________________________
ダイアログ
ダイアログ・ウィジェットは、ダイアログ・ボックスをレンダリングします。ダイアログ コンポーネントの提供するデータをレンダリングします。
次の図に、変換においてダイアログ・コンポーネントの例のデータを入力として使用するダイアログ・ウィジェットの表示例を示します。
- 使用不可領域
- 特殊な境界
- 除去された境界文字
以下の設定が、このウィジェットに対して構成できます。
- ダイアログ外部の使用不可領域の非表示
- ダイアログの外側の領域を非表示にするかどうかを指定します。
- 使用不可エリアのスタイル・クラス (Disabled area style class) Web のみ
- 使用不可エリアで使用する CSS スタイル・クラスを指定します。
- 特別な境界の使用 Web のみ
- 元のテキストの代わりに特別な境界を使用するかどうかを指定します。
- 境界文字の除去 (Remove border characters) Web のみ
- 元の境界文字を表示するかどうかを指定します。
- 境界のスタイル・クラス (Border style class)
- 境界で使用する CSS スタイル・クラスを指定します。
- 境界のスタイル Web のみ
-
- 左方
- 左の境界で使用する CSS スタイル・クラスを指定します。
- 右方
- 右の境界で使用する CSS スタイル・クラスを指定します。
- 上部
- 上の境界で使用する CSS スタイル・クラスを指定します。
- 下部
- 下の境界で使用する CSS スタイル・クラスを指定します。
- コーナーのスタイル Web のみ
-
- 左上
- 境界の左上隅で使用する CSS スタイル・クラスを指定します。
- 右上
- 境界の右上隅で使用する CSS スタイル・クラスを指定します。
- 左下
- 境界の左下隅で使用する CSS スタイル・クラスを指定します。
- 右下
- 境界の右下隅で使用する CSS スタイル・クラスを指定します。
__________________________________________________________________________
ドロップダウン (データ入力)
ドロップダウン (データ入力) ウィジェットは、ドロップダウンをレンダリングします。
このウィジェットは、以下のコンポーネントが提供するデータをレンダリングします。
次の図に、変換において ヒント付き入力フィールド・コンポーネントの例のデータを入力として使用するデータ入力ドロップダウン・リスト・ウィジェットの表示例を示します。
図 38. データ入力ドロップダウン・リスト・ウィジェットの例
- 表題 (コンポーネントから)
- 1 行あたりの列数 (1)
- 設定 (ヒントから)
以下の設定が、このウィジェットに対して構成できます。
- グローバル変数から設定
- これを選択した場合、指定したグローバル変数がドロップダウンに設定されます。
- リストの値を含むグローバル変数
- 値の集合を含む索引付きグローバル変数の名前を指定します。グローバル変数内の各索引に対する項目が、ドロップダウンに作成されます。
- 共用
- HATS のローカル・グローバル変数と共用グローバル変数は同じ名前を持つことができます。共用グローバル変数を使用してリスト項目にデータを取り込む場合は、このボックスを選択します。このボックスをクリアした場合は、ローカル・グローバル変数が使用されます。
- リストの表題を含むグローバル変数
- オプションです。表題の集合を含む索引付きグローバル変数の名前を指定します。この値によって指定されるグローバル変数のサイズは、前の設定で指定されたサイズ以上である必要があります。この索引付きグローバル変数の索引は、グローバル変数の値の索引と一致する必要もあります (その結果、ユーザーに表示される実際の値と表題が同期します)。この値が指定されない場合は、ドロップダウン中の各項目の表題が、その値になります。
- ストリングから設定
- これを選択した場合、指定したストリングがドロップダウンに設定されます。
- リスト項目
- オプションです。ドロップダウンに含まれる項目のストリングを指定します。項目はセミコロン (;) で分離する必要があります。リスト項目の表題とリスト項目の値が異なるようにするには、等号 (=) を入力してから表題を指定します。例えば、Apple=A;Grape=G の値を指定すると、2 つの項目「Apple」と「Grape」を持つドロップダウンがレンダリングされます。最初の項目を選択すると、関連するホスト画面の入力フィールドに「A」が挿入されます。
ドロップダウンの項目とホスト画面に挿入される値を同一にするには、項目のみを入力します。例えば Apple=A;G などです。この例では、ドロップダウンとホスト画面の入力フィールドに G が表示されます。
- ヒントから設定
- これを選択した場合、コンポーネントによって認識されたヒントがドロップダウンに設定されます (「ヒント付き入力フィールド」コンポーネントの使用時に限り適用可能)。
- 表題ソース (Caption source)
- 生成されるドロップダウンの表題を決定する方法を指定します。オプション: 「コンポーネントから」 (コンポーネントから取り出した表題を使用) または「カスタム」(指定された表題を使用)。
- カスタム表題
- オプションです。ドロップダウンの表題を指定します。
注:
ドロップダウンの表題を生成しない場合は、この設定をブランクのままにしてください。
- 1 行あたりの列数
- 次の行に折り返されるまでに、水平方向に表示されるドロップダウンの数です。
注:
- この設定はデフォルト・レンダリングでは適用されません。
- ウィジェットのプレビューは必ずしも全ページのプレビューと一致するとは限りません。これはウィジェットのプレビューが単にコンポーネントの出力をレンダリングしているだけであるために起こります。ウィジェットのプレビューは、全ページのプレビューで行われているように、レンダリングしたときに画面の配置を保存しようとはしません。
- 選択時に自動的に実行依頼
- これを選択した場合、ドロップダウンで選択操作が行われると、その選択内容が実行依頼されます。
- 送信ボタンを表示
- これを選択した場合、ドロップダウンの横に送信ボタンがレンダリングされます。
- 送信ボタンの表題
- オプションです。送信ボタンの表題を指定します。
- ドロップダウンのスタイル・クラス Web のみ
- オプションです。生成されるドロップダウンに関連する CSS スタイル・クラスです。HTML ドロップダウン・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSDROPDOWN です。詳細については、スタイル・シートの使用を参照してください。
- リスト・オプションのスタイル・クラス Web のみ
- オプションです。ドロップダウンの各オプションに関連する CSS スタイル・クラスです。デフォルト値は HATSOPTION です。詳細については、スタイル・シートの使用を参照してください。
- 表題のスタイル・クラス Web のみ
- オプションです。生成されるドロップダウンの表題に関連する CSS スタイル・クラスです。デフォルト値は HATSCAPTION です。詳細については、スタイル・シートの使用を参照してください。
- テーブルのスタイル・クラス Web のみ
- オプションです。生成されるテーブルに関連する CSS スタイル・クラスです。ドロップダウンが複数レンダリングされる場合、1 つの HTML テーブルが生成され、それらのドロップダウンを囲みます。HTML テーブル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLE です。詳細については、スタイル・シートの使用を参照してください。
- スタイル Web のみ
- オプションです。オーバーライドする任意の CSS プロパティー。例えば、このフィールドに「font-color: red; font-size:
18pt;」と指定して、このウィジェットのフォントの色およびサイズを変更できます。入力したプロパティーは、このウィジェットの各エレメントに適用されます。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
- 色のオーバーライド RCP のみ
- 前景色と背景色を指定変更する場合は、このオプションを選択して、提供されている「前景色」と「背景色」の設定コントロールを使用します。
__________________________________________________________________________
ドロップダウン (選択)
ドロップダウン (選択) ウィジェットは、HTML ドロップダウンのレンダリングを担当します。
このウィジェットは、以下のコンポーネントが提供するデータをレンダリングします。
次の図に、変換において選択リスト・コンポーネントの例のデータを入力として使用する選択リスト・ドロップダウン・リスト・ウィジェットの表示例を示します。
図 39. 選択リスト・ドロップダウン・リスト・ウィジェットの例
- 表題のタイプ (両方を表示)
- 先行トークン (両方を表示)
- 説明 (両方を表示)
- 送信ボタン (送信ボタンを表示)
- 送信ボタンの表題 (送信)
以下の設定が、このウィジェットに対して構成できます。
- 表題のタイプ
- リスト項目の先行トークンの表示方法を指定します。コンポーネントから先行トークンの値および説明が取り込まれます。つまり、ドロップダウン内に表示される項目を選択できます。例えば、ホスト画面に「4. メール」というメニュー項目が存在する場合、表題表示として「4」、「メール」、または「4. メール」を選択できます。
- 選択時に自動的に実行依頼
- これを選択した場合、ドロップダウンで選択操作が行われると、その選択内容が実行依頼されます。ドロップダウンに、ファンクション・キーが含まれている場合は、選択したリストの項目のキーがホストに送信されます。ドロップダウンに選択リスト項目が含まれている場合は、選択した項目の値がターゲット・フィールドに挿入され、指定したアクション・キーがホストに送信されます。
- 送信ボタンを表示
- これを選択した場合、ドロップダウンの横に送信ボタンがレンダリングされます。ファンクション・キー・コンポーネントとこのウィジェットを併用しているときには、適用しないでください。
- 送信ボタンの表題
- オプションです。送信ボタンの表題を指定します。
- ボタンのスタイル・クラス Web のみ
- オプションです。生成される送信ボタンに関連する CSS スタイル・クラスです。HTML ボタン・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSBUTTON です。詳細については、スタイル・シートの使用を参照してください。
- ドロップダウンのスタイル・クラス Web のみ
- オプションです。生成されるドロップダウンに関連する CSS スタイル・クラスです。HTML ドロップダウン・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSDROPDOWN です。詳細については、スタイル・シートの使用を参照してください。
- リスト・オプションのスタイル・クラス Web のみ
- オプションです。ドロップダウンの各オプションに関連する CSS スタイル・クラスです。デフォルト値は HATSOPTION です。詳細については、スタイル・シートの使用を参照してください。
- 表題のスタイル・クラス Web のみ
- オプションです。生成されるドロップダウンの表題に関連する CSS スタイル・クラスです。デフォルト値は HATSCAPTION です。詳細については、スタイル・シートの使用を参照してください。
- テーブルのスタイル・クラス Web のみ
- オプションです。生成されるテーブルに関連する CSS スタイル・クラスです。ドロップダウンが複数レンダリングされる場合、1 つの HTML テーブルが生成され、それらのドロップダウンを囲みます。HTML テーブル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLE です。詳細については、スタイル・シートの使用を参照してください。
- スタイル Web のみ
- オプションです。オーバーライドする任意の CSS プロパティー。例えば、このフィールドに「font-color: red; font-size:
18pt;」と指定して、このウィジェットのフォントの色およびサイズを変更できます。入力したプロパティーは、このウィジェットの各エレメントに適用されます。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
- 色のオーバーライド RCP のみ
- 前景色と背景色を指定変更する場合は、このオプションを選択して、提供されている「前景色」と「背景色」の設定コントロールを使用します。
__________________________________________________________________________
フィールド
フィールド・ウィジェットは、フィールド・コンポーネントによって認識される入力フィールドとテキストのレンダリングを担当します。
注:
このウィジェットを使用する際の DBCS に関する考慮事項については、
SBCS での最大長の除去を参照してください。
次の図に、変換においてフィールド・コンポーネントの例のデータを入力として使用するフィールド・ウィジェットの表示例を示します。
- 保護テキスト
フィールド・ウィジェットのテーブル・レイアウトの主要な目標は、GUI でホスト画面をレンダリングするときに、元のホスト画面のレイアウトを維持することです。デフォルト・レンダリングでは、テーブルを使用して画面のレイアウトが維持されます。このテーブルは通常、80 列および 24 行で構成されます。フィールド・ウィジェットの各種位置合わせ設定 (「通常」、「文字ごと Web のみ 」、および「ワードごと」) により、このテーブルのテーブル・セルの作成方法が変更されます。
通常の位置合わせでは、各ホスト・フィールドはテーブル内のテーブル・セルにより表わされます。セルが 1 つ以上の列を使用することがあります。詳細については、「colspan」HTML 属性を参照してください。ホスト画面上で列 10 から開始するフィールドは、テーブル内の列 10 に位置付けられます。通常の位置合わせでは、各フィールドが正しい列位置から開始されることが保証されます。
グローバル規則では一般に、変換元のフィールドよりも多くのページ・スペースが使用されるため、グローバル規則がページの位置合わせに影響することがあります。例えば、長さ 5 文字の入力フィールドがあるとします。デフォルト・レンダリングでは、このフィールドに対しテーブル内で 5 列が割り振られます。6 文字以上のスペースを使用するグローバル規則によりこのフィールドがレンダリングされると、このフィールドが位置するテーブル・セルが強制的に拡張されます。つまり、セルの幅が増加します。列全体が影響を受けるため、これはテーブル全体に影響します。一般に、どの行においても、フィールドの右側のセルは右側に移動します。これは、変換されたフィールドが含まれている列の幅が大きくなったためです。したがって、行 5 の列 60 から始まるフィールドは常に、行 20 の列 60 から開始されるフィールドに位置合わせされます。
文字ごとの位置合わせは、HATS Web プロジェクトでのみサポートされています。この位置合わせオプションを選択すると、入力フィールド以外のフィールドの各文字が、それぞれ個別のテーブル・セルの中でレンダリングされます。このオプションを使用すると、画面上のすべての文字が正しい開始位置に合わせられますが、生成されるページのサイズが非常に大きくなります。
ワードごとの位置合わせでは、画面上の各ワードがそれぞれ個別のテーブル・セルの中でレンダリングされます。つまり、複数のワードからなる単一フィールドは、複数のテーブル・セルでレンダリングされます。これにより、画面上のすべてのワードが正しい位置でレンダリングされます。このオプションは一般に、ホスト画面全体でさまざまな入力フィールドが分散している場合に使用します。入力フィールドでは通常のテキストよりも多くのページ・スペースが使用されるため、入力フィールドが原因でページが不適切に位置合わせされることがあります。
次の例に、デフォルト・レンダリングでの各種位置合わせオプションによるフィールドおよび文字のテーブル・セルへのマッピングを示します。実際のデフォルト・レンダリングでは、テーブル・セルは不可視です。
図 41. フィールド・ウィジェットの位置合わせの例
以下の設定が、このウィジェットに対して構成できます。
- 読み取り専用
- これを選択した場合、入力フィールドはレンダリングされません。入力フィールドにテキストが含まれている (かつパスワード保護されていない) 場合、代りにそのテキストが表示されます。この設定は、ページの情報を表示するが編集させたくない場合に便利です。
- レイアウト
-
この設定を使用して、このウィジェットによりレンダリングされる出力のレイアウトを指定します。元のホスト画面のレイアウトを保存するために、「テーブル」を選択して、テーブルの出力をレンダリングします。 これは、モバイル装置に対して最適化されていない Web アプリケーションのデフォルトです。HTML の量とブランク・スペースを削減するために、「分離」を選択し、インライン・スパン・タグを使用して出力をレンダリングし、フィールドを区別します。これは、モバイル装置に対して最適化されている Web アプリケーションのデフォルトです。
- 位置合わせ
- テーブル・レイアウトを使用する場合、位置合わせを改善するため、HATS でのテキスト文字をテーブル・セルへマップする方法 (「通常」、「文字ごと」 Web のみ 、または「ワードごと」) を指定します。
- テーブルのスタイル・クラス Web のみ
- オプションです。生成されるテーブルに関連する CSS スタイル・クラスです。HTML テーブル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSFIELDTABLE です。詳細については、スタイル・シートの使用を参照してください。
- nowrap Web のみ
-
位置合わせ設定として「ワードごと」を指定すると、変換時に複数フィールドがワード単位で位置合わせされます。ただし、別のウィジェットによる出力が原因で、デフォルト・レンダリング・テーブルのセルが圧縮され、テキストが折り返すことがあります。テキストが折り返さないようにするため、ワードごとの位置合わせを使用する場合は nowrap フラグが HTML 出力に自動的に追加されます。HTML 出力への nowrap フラグの自動追加を無効にするには、この nowrap 設定を使用します。
位置合わせ設定をどの値に設定する場合でも、nowrap を false に設定すると、フィールド・ウィジェットの HTML 出力に nowrap フラグが追加されず、セル内のテキストが折り返し可能になります。ワードごとの位置合わせを使用し、継続的に位置合わせの問題が発生する場合にのみ、nowrap を false に設定します。
デフォルト・レンダリングでは、テーブル・セルが折り返すと、垂直位置合わせおよび水平位置合わせの両方に悪影響が及び、不適切な出力が作成される原因となります。
位置合わせ設定をどの値に設定する場合でも、nowrap を true に設定すると、テーブル・セル内でテキストが次の行に折り返すことがありません。
注:
GUI では
nowrap 設定は構成可能な設定として示されません。これは application.hap ファイルのソースで設定する必要があります。例えば、
nowrap を
false に設定するには、「HATS プロジェクト」ビューのプロジェクト・フォルダーの
「プロジェクト設定」ファイルをダブルクリックし、application.hap ファイルのエディターを起動します。
「ソース」タブで、<classSettings> タグの中のクラス name="com.ibm.hats.transform.widgets.FieldWidget" を見つけ、次の設定を追加します。
<setting name="nowrap" value="false"/>
- 保護フィールド上でのカーソルの位置決めを許可します
- これを選択した場合、保護フィールドの 1 つをクリックすると、ホスト・カーソルがその特定の位置に設定されます。この設定は、ホスト・アプリケーションがカーソル位置に依存し、ホスト・アプリケーションでカーソルを保護フィールド上に配置する必要がある場合に便利です。
Web アプリケーションの場合は、カーソル位置設定の精度は、「位置合わせ」設定 (「通常」、「文字ごと Web のみ 」、または「ワードごと」) によって決まります。
リッチ・クライアント・アプリケーションの場合は、フィールド内の任意の位置にカーソル位置を設定できます。「位置合わせ」設定は、カーソル位置の設定の精度に影響しません。
ブラウザーでの実行時に、これらのフィールドの 1 つがクリックされると、HATS に対してその旨が通知されます。HATS はカーソル位置を内部で更新し、ユーザーに対して新しいカーソル位置を視覚的に示します。デフォルトでは、テキストの背景色を黄色に設定することで視覚的に示します。Web アプリケーションの場合は、開発者が CSS スタイル HCURSORINDICATOR を使用して視覚的な表示を制御できます。詳細については、スタイル・シートの使用を参照してください。この設定を有効にすると、以下の操作が可能になります。
- 保護フィールドの領域をクリックしてカーソルの位置を決めることができる。
- カーソルが無保護フィールド内にない場合でも、ページの読み込み時にカーソルの初期位置を確認できる。
注:
フィールド・ウィジェットを使用して画面上の同一領域が複数回レンダリングされる場合は、この設定のみでは正しく機能しません。例えば、タブ付きフォルダーの複数のタブで画面上の同一領域がレンダリングされる場合は、さらに、ユーザーが画面上のその領域にカーソルの位置を設定できるようにするため、保護フィールドをリンクとしてレンダリングする必要があります (以下の「リンクを使用するタブ操作を許可」を参照)。
- リンクを使用するタブ操作を許可 Web のみ
- これを選択した場合、各保護フィールドは HTML リンクとしてレンダリングされます。これにより、保護フィールド間でのタブ操作が可能になります。カーソル位置は下線付き文字として表示されます。
注:
このオプションを選択すると、ページの各保護フィールドに対して HTML アンカー <A> タグが生成されます。このため、Web ページのサイズが大きくなります。
生成される Web ページのサイズが不必要に大きくなることを防ぐため、デフォルトではこのオプションは選択されていません。
- リンクのスタイル・クラス Web のみ
- 生成される各リンクに関連する CSS スタイル・クラスです。HTML リンク・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSPROTLINK です。詳細については、スタイル・シートの使用を参照してください。
- アクション・キー
- オプションです。保護フィールドの選択時、ホストに送信されるホスト AID キー・ニーモニックを指定します。例えば、[enter] はカーソルを指定の位置に設定し、enter を送信します。また、[pf1] は、カーソルを指定の位置に設定し、pf1 を送信します。
- リンクのスペースをトリム (Trim spaces on links)
- これを選択した場合、保護フィールド・リンクの両端から空白 (余分なスペース) が除去されます。この設定は、リンクとしてレンダリングされるテキストの容量を減少する場合に便利です。
- 入力フィールドのカーソル位置オプションを使用可能にする Web のみ
- このボックスを選択して、ユーザーが入力フィールドでデータ入力モードからカーソル位置決めモードに切り替えができるようにします。データ入力モードのときは、ユーザーは入力フィールドにデータを入力できます。カーソル位置決めモードのときは、タブ移動または別の方法で、入力フィールドの任意の文字上にカーソルを配置できます。この設定は他のカーソル位置決め機能を持たないモバイル装置用に最適化されている Web プロジェクトでは便利です。HATS Toolkit
GUI に表示されないこのオプションの他の設定のついては、モバイル装置に関する考慮事項および制約事項を参照してください。
- 前景色を使用可能にする
- これを選択した場合、ホスト画面の前景色がレンダリングされます。
Web アプリケーションの場合は、前景色はその色を表す CSS スタイルシート・クラスにマップされます。例えば、ホスト画面フィールドが RED とマークされている場合、フィールド・ウィジェットは、そのフィールド用に生成された HTML を、クラス名属性が HRED に設定されているタグで囲みます。この処理によって、ユーザーは、生成される Web ページ上にホスト画面の色を再マップすることができます。
注:
blacktheme.css は、ホスト画面フィールドの前景色を直接マップします (例えば、ホスト画面上の赤色のテキストは、生成された Web ページ上で赤色のテキストとして表示されます)。ただし、monochrome.css などの他のスタイルシート・ファイルは、フィールドの色を別の方法でマップし、一貫性のある、最新のスタイルを作成しようとします。
リッチ・クライアント・アプリケーションの場合、色はリッチ・クライアント・テンプレートによってマップされます。
注:
この設定は、「色のオーバーライド」>「前景色」の設定によってオーバーライドされます。
- フィールドのスタイル・クラス Web のみ
- オプションです。生成されたフィールドに関連する CSS スタイル・クラスです。HTML タグの class 属性の値には、この値がセットされます。デフォルト値は HATSFIELD です。詳細については、スタイル・シートの使用を参照してください。
- 拡張属性を使用可能にする
- これを選択した場合、拡張フィールド属性 (明滅 Web のみ 、反転表示、下線、および列分離子) がレンダリングされます。また、3270 Web アプリケーションの場合、拡張フィールドの色もマップされます (詳細については、「前景色を使用可能にする」の設定を参照してください)。
リッチ・クライアント・アプリケーションの場合は、反転表示のレンダリングでは、背景色としてリッチ・クライアント・テンプレートでマップされている色が使用され、前景色として黒が使用されます。列分離子は、フィールドの下の破線としてレンダリングされます。
- 明滅スタイル Web のみ
- ホスト画面における明滅テキストのレンダリングに使用する CSS スタイル設定。
- 反転表示スタイル (Reverse video style) Web のみ
- ホスト画面における反転表示テキストのレンダリングに使用する CSS スタイル設定。
- 下線スタイル (Underline style) Web のみ
- ホスト画面における下線付きテキストのレンダリングに使用する CSS スタイル設定。
- 列分離子スタイル (Column separator style) Web のみ
- ホスト画面における列分離子のレンダリングに使用する CSS スタイル設定。
詳細については、スタイル・シートの使用を参照してください。
- モノスペース・フォントを使用してレンダリング
- 選択されている場合、フィールドはモノスペース・フォントを使用してレンダリングされます。選択されていない場合、ロケール環境のデフォルト・フォントを使用してレンダリングされます。
- 3270 数値ロックを有効にする
- 選択されている場合、ユーザーは、0 から 9 までの数字、正符号、負符号、ピリオド、コンマ、およびヒンディ数字のみを、3270 数値フィールドに入力できます。クリアされている場合、任意の文字を入力できます。デフォルトではクリアされています。
注:
Web アプリケーションの場合、必要に応じて lxgwfunctions.js ファイル の allowNumLockOnly() 関数および allowNumLockOnlyForIEMobile() 関数で文字コード値を使用して、受け入れられるキーのリストをカスタマイズできます。
- 入力フィールドの下線文字を除去 (Strip underscores on input field)
- テキストをレンダリングするときにテキストから下線文字を除去する場合は、このボックスを選択します。
- 入力フィールドのスペースをトリム
- 入力フィールドから先行および後続のスペースをトリムする場合は、このボックスを選択します。
- スタイル Web のみ
- オプションです。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
注:
このウィジェットによって多数のタグが生成されるため、この設定に値を指定すると、ページのダウンロード時間が大幅に増加する場合があります。囲んでいる変換または組み込みスタイルシート・ファイルにスタイル・オーバーライドを指定します。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
- 色のオーバーライド RCP のみ
- 前景色と背景色を指定変更する場合は、このオプションを選択して、提供されている「前景色」と「背景色」の設定コントロールを使用します。
__________________________________________________________________________
グラフ (水平棒、折れ線、垂直棒)
グラフ・ウィジェットは、JPEG グラフ・イメージのレンダリングを担当します。
このウィジェットは、以下のコンポーネントが提供するデータをレンダリングします。
注:
このウィジェットは、非常に大きな範囲のデータをレンダリングするには、適していない場合があります。
変換においてテーブル (可視)・コンポーネントの例のデータを入力として使用する水平棒グラフ、折れ線グラフ、および垂直棒グラフの表示例を次に示します。
- データ・セット (6)
- X 軸のタイトル (年、水平棒グラフ上では数量)
- Y 軸のタイトル (数量、水平棒グラフ上では年)
- データ・ポイント・ラベル (抽出)
- データ・セット・ラベル (抽出)
以下の設定が、このウィジェットに対して構成できます。
- データ・セットの数
- グラフに描画するデータ・セットの数を指定します。この設定は、「ホスト・コンポーネントを挿入」ウィザードでのみ表示されます。
- データ・セットのソース
- 1 つ以上のデータ・セットに対する値を取得する方法を指定します。オプション: 「行」(テーブルの各行がグラフ化する 1 つのデータ・セットで構成される) または「列」(テーブルの各列がグラフ化する 1 つのデータ・セットで構成される)。
- 幅 (ピクセル)
- グラフのピクセル単位の幅。
- 高さ (ピクセル)
- グラフのピクセル単位の高さ。
- 背景色
- グラフの背景に使用する色を指定します。色セレクター・ボタンをクリックして、カラー・パレットを表示します。
- 背景イメージ
- グラフの背景に使用するイメージの名前 (Web プロジェクトの Web Content¥Common¥Images フォルダーまたはリッチ・クライアント・プロジェクトの Rich Client Content¥Images フォルダーからの相対パス) を入力します。「参照」ボタンをクリックして、使用中のシステムからイメージをインポートします。
- デフォルト・フォント (Default Font)
- フォント、タイプ、およびフォント・サイズを指定します。
- X 軸のタイトル
- オプションです。グラフの X 軸のラベルを指定するストリングです。
- Y 軸のタイトル
- オプションです。グラフの Y 軸のラベルを指定するストリングです。
- 軸の色
- グラフの軸を描画するときの色を指定します。色セレクター・ボタンをクリックして、カラー・パレットを表示します。
- ラベルの色 (Label color)
- グラフのラベルを描画するときの色を指定します。色セレクター・ボタンをクリックして、カラー・パレットを表示します。
- テキストのエイリアス除去
- これを選択した場合、テキストのエイリアス除去が使用され、描画されるテキストの端が平滑化されます。
- 代替テキスト
- オプションです。ユーザーのクライアント・ブラウザーがレンダリングされたグラフ・イメージをロードできない場合に表示するテキストを指定します。
「データ・セットの数」設定の場合のように、以下の設定は、「ホスト・コンポーネントを挿入」ウィザードに限り表示されます。
- データ・ポイント・ラベルを抽出
- グラフのデータ・ポイントのラベルを、テーブルの行 (または列) から抽出する場合は、このボックスを選択します。
- 行 (または列) (Row (or Column))
- データ・ポイント・ラベルの抽出元である行 (または列) の数を指定します。この入力フィールドのラベル (行または列) は、「データ・セットのソース」の設定で指定された値に依存しています。
- 凡例用にデータ・セットのラベルを抽出
- グラフのデータ・セットのラベルを、テーブルの行 (または列) から抽出する場合は、このボックスを選択します。
- 行 (または列) (Row (or Column))
- データ・セット・ラベルの抽出元である行 (または列) の数を指定します。この入力フィールドのラベル (行または列) は、「データ・セットのソース」の設定で指定された値に依存しています。
- データ・セット
- このボタンをクリックして、データ・ソース設定ダイアログを表示します。このダイアログでは、データ・ソースに関する以下の追加設定を指定できます。
- データ・セット「n」、「行」、または「列」
- これらのフィールドの番号 (「n」) は、データ・セット・ソースの設定で指定された値と一致しています。データ・セットに使用するデータの任意の行または列の番号を入力します。こうすると、グラフ内の一連のデータを再配列または複写することができます。この入力フィールドのラベルの最終部分は、「データ・セットのソース」の設定で指定された値に依存しています。入力フィールド・ラベルは、「データ・セットのソース」の設定で指定された値と一致しています。
- 色
- データ・セット「n」、「行」、「列」のそれぞれの設定にカラー・ボタンがあります。ボタンは、グラフ内のデータ・セットに使用する色を表示しています。データ・セットの色を変更する場合は、ボタンをクリックしてカラー・パレットを表示します。
- 凡例のラベル
- 凡例に使用するラベルを指定してください。「凡例用にデータ・セットのラベルを抽出」が選択されていない場合のみ使用可能になります。
__________________________________________________________________________
ラベル
ラベル・ウィジェットは、テキストのレンダリングを担当します。
このウィジェットは、以下のコンポーネントが提供するデータをレンダリングします。
次の図に、変換においてテキスト・コンポーネントの例のデータを入力として使用するラベル・ウィジェットの表示例を示します。
- ラベル
以下の設定が、このウィジェットに対して構成できます。
- スペースのトリム
- これを選択した場合、選択されたテキストの両端から空白 (余分なスペース) が削除されます。
- スタイル・クラス Web のみ
- オプションです。生成されるテキストに関連する CSS スタイル・クラスです。デフォルト値は HATSCAPTION です。詳細については、スタイル・シートの使用を参照してください。
- スタイル Web のみ
- オプションです。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
- 色のオーバーライド RCP のみ
- 前景色と背景色を指定変更する場合は、このオプションを選択して、提供されている「前景色」と「背景色」の設定コントロールを使用します。
__________________________________________________________________________
リンク
リンク・ウィジェットは、HTML リンクのレンダリングを担当します。
このウィジェットは、以下のコンポーネントが提供するデータをレンダリングします。
次の図に、変換において選択リスト・コンポーネントの例のデータを入力として使用するリンク・ウィジェットの例を示します。
- 行
- 1 行あたりの列数 (1)
- 先行トークン (両方を表示)
- 説明 (両方を表示)
以下の設定が、このウィジェットに対して構成できます。
- 表題のタイプ
- 各リンクの表題を決定する方法を指定します。コンポーネントから先行トークンの値および説明が取り込まれます。つまり、リンクのテキストとして表示される項目を選択できます。例えば、ホスト画面に「4. メール」というメニュー項目が存在する場合、テキスト表示として「4」、「メール」、または「4. メール」を選択できます。
- 表題のスペースをトリム (Trim spaces on caption)
- これを選択した場合、表題の両端から空白 (余分なスペース) が除去されます。
- レイアウト
- HTML ページでのリンクの配置方法を指定します。オプション: 「テーブル」、「分離」。
注:
- この設定はファンクション・キー・コンポーネントが使用されている場合、デフォルト・レンダリングでは適用されません。
- ウィジェットのプレビューは必ずしも全ページのプレビューと一致するとは限りません。これはウィジェットのプレビューが単にコンポーネントの出力をレンダリングしているだけであるために起こります。ウィジェットのプレビューは、全ページのプレビューで行われているように、レンダリングしたときに画面の配置を保存しようとはしません。
- 1 行あたりの列数
- 次の行に折り返されるまでに、水平方向に表示されるリンクの数です。
- 分離文字
- HTML ページ上でレンダリングされたリンクを区切るために使用する分離文字を指定します。ドロップダウン・リストから選択するか入力フィールドに手動で入力するかを選択できます。
- ターゲット (Target) Web のみ
- リンクされた URL のコンテンツを表示するターゲット (同じ、新規、親、またはトップのウィンドウ) をドロップダウン・リストから選択します。
- リンクのスタイル・クラス Web のみ
- オプションです。生成される各リンクに関連する CSS スタイル・クラスです。HTML リンク・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSLINK です。詳細については、スタイル・シートの使用を参照してください。
- スタイル Web のみ
- オプションです。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
- 色のオーバーライド RCP のみ
- 前景色と背景色を指定変更する場合は、このオプションを選択して、提供されている「前景色」と「背景色」の設定コントロールを使用します。
__________________________________________________________________________
リンク (項目選択)
リンク (項目選択) ウィジェットは、項目選択コンポーネントをリンクとしてレンダリングします。
次の図に、変換において項目の選択コンポーネントの例のデータを入力として使用するリンク (項目選択) ウィジェットの例を示します。
図 47. リンク (項目選択) ウィジェットの例
- 入力フィールドの表示 (いいえ)
- 1 行あたりの列数 (デフォルトは 1)
- レイアウト (テーブル)
以下の設定が、このウィジェットに対して構成できます。
- レイアウト
- HTML ページでのリンクの配置方法を指定します。オプション: 「テーブル」、「分離」。
- 1 行あたりの列数
- レンダリングした HTML ページの各行に表示するこのウィジェットのインスタンスの数を指定します。
- 分離文字
- HTML ページ上でレンダリングされたリンクを区切るために使用する分離文字を指定します。ドロップダウン・リストから選択するか入力フィールドに手動で入力するかを選択できます。
- 入力フィールドの表示
- 各リンクの入力フィールドを表示するかどうかおよび入力フィールドの位置 (リンクの左側/右側) を指定します。オプション: 「いいえ」、「表題の左」、「表題の右」
- 選択値 (Selection value)
- 入力フィールドの左側に配置する文字を指定します。
- 自動的に送信するキー
- ホストに送信する AID キーを指定するか、送信するキーがないことを指定します。
- リンクのスタイル・クラス
- オプションです。生成されるランチャー・リンクに関連する CSS スタイル・クラスです。HTML リンク・タグの class 属性の値には、この値がセットされます。デフォルト値は、HATSPROTLINK
HBLANK です。詳細については、スタイル・シートの使用を参照してください。
- スタイル
- オプションです。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
__________________________________________________________________________
リスト
リスト・ウィジェットは、リスト・ボックスをレンダリングします。
このウィジェットは、以下のコンポーネントが提供するデータをレンダリングします。
次の図に、変換におけるリスト・ウィジェットの表示例を示します。
- 表題 (カスタム)
- 設定 (ストリングから)
- 表示可能な行数 (デフォルトは 5)
- 1 行あたりの列数 (デフォルトは 1)
以下の設定が、このウィジェットに対して構成できます。
- グローバル変数から設定
- これを選択した場合、指定したグローバル変数がリストに設定されます。
- リストの値を含むグローバル変数
- 値の集合を含む索引付きグローバル変数の名前を指定します。リストに、グローバル変数の各索引の項目が作成されます。
- 共用
- HATS のローカル・グローバル変数と共用グローバル変数は同じ名前を持つことができます。共用グローバル変数を使用してリスト項目にデータを取り込む場合は、このボックスを選択します。このボックスをクリアした場合は、ローカル・グローバル変数が使用されます。
- リストの表題を含むグローバル変数
- オプションです。表題の集合を含む索引付きグローバル変数の名前を指定します。この値によって指定されるグローバル変数のサイズは、前の設定で指定されたサイズ以上である必要があります。この索引付きグローバル変数の索引は、グローバル変数の値の索引と一致する必要もあります (その結果、ユーザーに表示される実際の値と表題が同期します)。この値が指定されていない場合、リスト内の各項目の表題がその値になります。
- ストリングから設定
- これを選択した場合、指定したストリングがリストに設定されます。
- リスト項目
- オプションです。リストに含まれる項目のストリングを指定します。項目はセミコロン (;) で分離する必要があります。リスト項目の表題とリスト項目の値が異なるようにするには、等号 (=) を入力してから表題を指定します。例えば、Apple=A;Grape=G の値は、2 つの項目「Apple」と「Grape」を持つリストをレンダリングします。最初の項目を選択すると、関連するホスト画面の入力フィールドに「A」が挿入されます。
リストの項目とホスト画面に挿入される値を同一にするには、項目のみを入力します。例えば、Apple=A;G です。この例では、リストとホスト画面の入力フィールドに G が表示されます。
- ヒントから設定
- これを選択した場合、コンポーネントに認識されたヒントがリストに設定されます (「ヒント付き入力フィールド」コンポーネントの使用時に限り適用可能)。
- 表題ソース (Caption source)
- 生成されるリストの表題を決定する方法を指定します。オプション: 「コンポーネントから」 (コンポーネントから取り出した表題を使用) または「カスタム」(指定された表題を使用)。
- カスタム表題
- オプションです。リストの表題を指定します。
注:
リストの表題を生成しない場合は、この設定はブランクのままにしてください。
- 表示可能な行数
- ユーザーに対してリスト・ボックス内に表示される行の行数。リスト内の項目数がこの数よりも多い場合は、スクロール・バーが表示されます。これにより、ユーザーはリスト全体をスクロールできます。デフォルトは 5 です。
- 1 行あたりの列数
- 次の行に折り返されるまでに水平方向に表示されるリストの数です。デフォルトは 1 です。
注:
- この設定はデフォルト・レンダリングでは適用されません。
- ウィジェットのプレビューは必ずしも全ページのプレビューと一致するとは限りません。これはウィジェットのプレビューが単にコンポーネントの出力をレンダリングしているだけであるために起こります。ウィジェットのプレビューは、全ページのプレビューで行われているように、レンダリングしたときに画面の配置を保存しようとはしません。
- 選択時に自動的に実行依頼
- これを選択した場合、リストで選択操作が行われると、その選択内容が実行依頼されます。
- 送信ボタンを表示
- これを選択した場合、リストの横に送信ボタンがレンダリングされます。
- 送信ボタンの表題
- オプションです。送信ボタンの表題を指定します。
- リストのスタイル・クラス Web のみ
- オプションです。生成されたリストに関連する CSS スタイル・クラスです。HTML リスト・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSDROPDOWN です。詳細については、スタイル・シートの使用を参照してください。
- リスト・オプションのスタイル・クラス Web のみ
- オプションです。リストの各オプションに関連する CSS スタイル・クラスです。デフォルト値は HATSOPTION です。詳細については、スタイル・シートの使用を参照してください。
- 表題のスタイル・クラス Web のみ
- オプションです。生成されたリストの表題に関連する CSS スタイル・クラスです。デフォルト値は HATSCAPTION です。詳細については、スタイル・シートの使用を参照してください。
- テーブルのスタイル・クラス Web のみ
- オプションです。生成されるテーブルに関連する CSS スタイル・クラスです。複数のリストがレンダリングされる場合、HTML テーブルはこれらのリストを囲むように生成されます。HTML テーブル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLE です。詳細については、スタイル・シートの使用を参照してください。
- スタイル Web のみ
- オプションです。オーバーライドする任意の CSS プロパティー。例えば、このフィールドに「font-color: red; font-size:
18pt;」と指定して、このウィジェットのフォントの色およびサイズを変更できます。入力したプロパティーは、このウィジェットの各エレメントに適用されます。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
- 色のオーバーライド RCP のみ
- 前景色と背景色を指定変更する場合は、このオプションを選択して、提供されている「前景色」と「背景色」の設定コントロールを使用します。
__________________________________________________________________________
ポップアップ・ウィジェットは、関連のランチャー・ボタン、リンク、またはイメージを持つ入力フィールドのレンダリングを担当します。このランチャーは、関連の入力フィールドの有効な値を選択するのに使用できるポップアップを開きます。
このウィジェットは、以下のコンポーネントが提供するデータをレンダリングします。
注:
このウィジェットを使用する際の DBCS に関する考慮事項については、
SBCS での最大長の除去を参照してください。
次の図に、変換においてヒント付き入力フィールド・コンポーネントの例のデータを入力として使用するポップアップ・ウィジェットの表示例を示します。
- 表題 (コンポーネントから)
- 1 行あたりの列数 (1)
- 設定 (ヒントから)
- ランチャー・タイプ (ボタン)
- ランチャーの表題 (値)
以下の設定が、このウィジェットに対して構成できます。
- グローバル変数から設定
- これを選択した場合、指定したグローバル変数がポップアップ・リストに設定されます。
- リストの値を含むグローバル変数
- 値の集合を含む索引付きグローバル変数の名前を指定します。グローバル変数内の各索引に対するリンクが、ポップアップ・ウィンドウに作成されます。
- 共用
- HATS のローカル・グローバル変数と共用グローバル変数は同じ名前を持つことができます。共用グローバル変数を使用してリスト項目にデータを取り込む場合は、このボックスを選択します。このボックスをクリアした場合は、ローカル・グローバル変数が使用されます。
- リストの表題を含むグローバル変数
- オプションです。表題の集合を含む索引付きグローバル変数の名前を指定します。この値によって指定されるグローバル変数のサイズは、前の設定で指定されたサイズ以上である必要があります。この索引付きグローバル変数の索引は、グローバル変数の値の索引と一致する必要もあります (その結果、ユーザーに表示される実際の値と表題が同期します)。この値が指定されない場合は、各リンクのテキストが、その値になります。
- ストリングから設定
- これを選択した場合、指定したストリングがポップアップ・リストに設定されます。
- リスト項目
- オプションです。ポップアップ・ウィンドウに含む項目のストリングを指定します。項目はセミコロン (;) で分離する必要があります。リスト項目の表題とリスト項目の値が異なるようにするには、等号 (=) を入力してから表題を指定します。例えば、Apple=A;Grape=G の値は、2 つの項目「Apple」と「Grape」を持つポップアップ・ウィンドウをレンダリングします。最初の項目を選択すると、関連するホスト画面の入力フィールドに「A」が挿入されます。
ポップアップ・ウィンドウの項目とホスト画面に挿入される値を同一にするには、項目のみを入力します。例えば、Apple=A;G です。この例では、ポップアップ・ウィンドウとホスト画面の入力フィールドに G が表示されます。
- ヒントから設定
- これを選択した場合、コンポーネントによって認識されたヒントがポップアップにロードされます (「ヒント付き入力フィールド」コンポーネントの使用時に限り適用可能)。
- 表題ソース (Caption source)
- 生成される入力フィールドの表題を決定する方法を指定します。オプション: 「コンポーネントから」 (コンポーネントから取り出した表題を使用) または「カスタム」(指定された表題を使用)。
- カスタム表題
- オプションです。入力フィールドの表題を指定します。注: 関連する入力フィールドの表題を生成しない場合は、この設定をブランクのままにしてください。
- 1 行あたりの列数
- 次の行に折り返されるまでに、水平方向に表示される入力フィールドの数です。
注:
- この設定はデフォルト・レンダリングでは適用されません。
- ウィジェットのプレビューは必ずしも全ページのプレビューと一致するとは限りません。これはウィジェットのプレビューが単にコンポーネントの出力をレンダリングしているだけであるために起こります。ウィジェットのプレビューは、全ページのプレビューで行われているように、レンダリングしたときに画面の配置を保存しようとはしません。
- 入力フィールドのカーソル位置オプションを使用可能にする Web のみ
- このボックスを選択して、ユーザーが入力フィールドでデータ入力モードからカーソル位置決めモードに切り替えができるようにします。データ入力モードのときは、ユーザーは入力フィールドにデータを入力できます。カーソル位置決めモードのときは、タブ移動または別の方法で、入力フィールドの任意の文字上にカーソルを配置できます。この設定は他のカーソル位置決め機能を持たないモバイル装置用に最適化されている Web プロジェクトでは便利です。HATS Toolkit
GUI に表示されないこのオプションの他の設定のついては、モバイル装置に関する考慮事項および制約事項を参照してください。
- 読み取り専用
- これを選択した場合、レンダリングされた入力フィールドは読み取り専用になります。読み取り専用の入力フィールドは通常の入力フィールドのように表示されますが、ユーザーはこのフィールドの内容を変更できません。これは、無保護フィールドの内容をユーザーに対して表示するが、ユーザーがフィールドの内容を変更できないようにする場合に便利です。ポップアップ・ウィジェットの場合、フィールドに入力される入力データを制御できます。このフィールドには、ポップアップで使用可能な値のみを指定できます。
- 前景色を使用可能にする
- これを選択した場合、ホスト画面の前景色がレンダリングされます。
Web アプリケーションの場合は、前景色はその色を表す CSS スタイルシート・クラスにマップされます。例えば、ホスト画面フィールドが RED とマークされている場合、フィールド・ウィジェットは、そのフィールド用に生成された HTML を、クラス名属性が HRED に設定されているタグで囲みます。この処理によって、ユーザーは、生成される Web ページ上にホスト画面の色を再マップすることができます。
注:
blacktheme.css は、ホスト画面フィールドの前景色を直接マップします (例えば、ホスト画面上の赤色のテキストは、生成された Web ページ上で赤色のテキストとして表示されます)。ただし、monochrome.css などの他のスタイルシート・ファイルは、フィールドの色を別の方法でマップし、一貫性のある、最新のスタイルを作成しようとします。
リッチ・クライアント・アプリケーションの場合、色はリッチ・クライアント・テンプレートによってマップされます。
注:
この設定は、「色のオーバーライド」>「前景色」の設定によってオーバーライドされます。
- 拡張属性を使用可能にする
- これを選択した場合、拡張フィールド属性 (明滅、反転表示、下線、および列分離子) が表示されます。また、3270 Web アプリケーションの場合、拡張フィールドの色もマップされます (詳細については、前の設定を参照してください)。詳細については、スタイル・シートの使用を参照してください。
リッチ・クライアント・アプリケーションの場合、拡張フィールド属性はリッチ・クライアント・テンプレートによってマップされます。
- 明滅スタイル Web のみ
- ホスト画面における明滅テキストのレンダリングに使用する CSS スタイル設定。
- 反転表示スタイル (Reverse video style) Web のみ
- ホスト画面における反転表示テキストのレンダリングに使用する CSS スタイル設定。
- 下線スタイル (Underline style) Web のみ
- ホスト画面における下線付きテキストのレンダリングに使用する CSS スタイル設定。
- 列分離子スタイル (Column separator style) Web のみ
- ホスト画面における列分離子のレンダリングに使用する CSS スタイル設定。
- ランチャー・タイプ
- ランチャーのスタイルを指定します。このランチャーは、ポップアップをオープンするために使用します。オプション: 「ボタン」、「リンク」、または「イメージ」。
- イメージ・ファイル名 (Image filename)
- イメージ・ファイルの名前。これは、ランチャー・タイプが「イメージ」である場合にのみ使用可能です。イメージをプロジェクトにインポートするには、 「インポート」をクリックします。プレビュー・ウィンドウに、現在選択しているイメージが表示されます。
- 表題
- ランチャー・ボタンまたはリンクの表題。これは、ランチャー・タイプが「リンク」または「ボタン」である場合にのみ使用可能です。
- リンクのスタイル・クラス Web のみ
- オプションです。生成されるランチャー・リンクに関連する CSS スタイル・クラスです。HTML リンク・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSLINK です。詳細については、スタイル・シートの使用を参照してください。
- ボタンのスタイル・クラス Web のみ
- オプションです。生成されるランチャー・ボタンに関連する CSS スタイル・クラスです。HTML ボタン・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSBUTTON です。詳細については、スタイル・シートの使用を参照してください。
- リンクの表題を閉じる Web のみ
- 「クローズ」アクションで表示される表題。
- 入力フィールドのスタイル・クラス Web のみ
- オプションです。生成される入力フィールドに関連する CSS スタイル・クラスです。HTML 入力タグの class 属性の値には、この値がセットされます。デフォルト値は HATSINPUT です。詳細については、スタイル・シートの使用を参照してください。
- 表題のスタイル・クラス Web のみ
- オプションです。生成される入力フィールドの表題に関連する CSS スタイル・クラスです。デフォルト値は HATSCAPTION です。詳細については、スタイル・シートの使用を参照してください。
- テーブルのスタイル・クラス Web のみ
- オプションです。生成されるテーブルに関連する CSS スタイル・クラスです。入力フィールドの複数の集合がレンダリングされる場合、1 つの HTML テーブルが生成され、それらの入力フィールドを囲みます。HTML テーブル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLE です。詳細については、スタイル・シートの使用を参照してください。
- ウィンドウのスタイル・クラス Web のみ
- オプションです。生成されるポップアップ・ウィンドウに関連する CSS スタイル・クラスです。デフォルト値は、HATSPOPUP です。詳細については、スタイル・シートの使用を参照してください。
- クローズ・リンクのスタイル・クラス Web のみ
- オプションです。ポップアップ・ウィンドウのクローズに使用されるリンクに関連する CSS スタイル・クラスです。デフォルト値は HATSLINK です。詳細については、スタイル・シートの使用を参照してください。
- 項目リンクのスタイル・クラス Web のみ
- オプションです。ポップアップから項目を選択するために使用されるリンクに関連する CSS スタイル・クラスです。デフォルト値は HATSPOPUPITEMLINK です。詳細については、スタイル・シートの使用を参照してください。
- スタイル Web のみ
- オプションです。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
注:
表示されるポップアップ・ウィジェットの透過性が高くなりすぎることがあります。ウィジェットの透過性を低くする場合は、以下の手順で、テンプレートが使用している CSS (カスケーディング・スタイル・シート) を変更する必要があります。
- テンプレートが使用している CSS をオープンします。
- DIV.HATSPOPUP クラスの下で、「filter: alpha (opacity=40,
style=0)」を検索します。
- opacity 値を変更してポップアップ・ウィジェットの透過性を調整します。0 は透明、100 は完全に不透明です。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
- 色のオーバーライド RCP のみ
- 前景色と背景色を指定変更する場合は、このオプションを選択して、提供されている「前景色」と「背景色」の設定コントロールを使用します。
__________________________________________________________________________
ラジオ・ボタン (データ入力)
ラジオ・ボタン (データ入力) ウィジェットは、ラジオ・ボタン・セットをレンダリングします。
このウィジェットは、以下のコンポーネントが提供するデータをレンダリングします。
次の図に、変換においてヒント付き入力フィールド・コンポーネントの例のデータを入力として使用するラジオ・ボタン (データ入力) ウィジェットの表示例を示します。
図 50. ラジオ・ボタン (データ入力) ウィジェットの例
- 表題 (コンポーネントから)
- 1 行あたりの列数 (1)
- 設定 (ヒントから)
以下の設定が、このウィジェットに対して構成できます。
- グローバル変数から設定
- これを選択した場合、指定したグローバル変数がラジオ・ボタン・セットにロードされます。
- リストの値を含むグローバル変数
- 値の集合を含む索引付きグローバル変数の名前を指定します。グローバル変数内の各索引に対するラジオ・ボタンが作成されます。
- 共用
- HATS のローカル・グローバル変数と共用グローバル変数は同じ名前を持つことができます。共用グローバル変数を使用してリスト項目にデータを取り込む場合は、このボックスを選択します。このボックスをクリアした場合は、ローカル・グローバル変数が使用されます。
- リストの表題を含むグローバル変数
- オプションです。表題の集合を含む索引付きグローバル変数の名前を指定します。この値によって指定されるグローバル変数のサイズは、前の設定で指定されたサイズ以上である必要があります。この索引付きグローバル変数の索引は、グローバル変数の値の索引と一致する必要もあります (その結果、ユーザーに表示される実際の値と表題が同期します)。この値が指定されない場合は、各ラジオ・ボタンの表題が、その値になります。
- ストリングから設定
- これを選択した場合、指定したストリングがラジオ・ボタン・セットにロードされます。
- リスト項目
- オプションです。ラジオ・ボタン・セットに含む項目のストリングを指定します。項目はセミコロン (;) で分離する必要があります。リスト項目の表題とリスト項目の値が異なるようにするには、等号 (=) を入力してから表題を指定します。例えば、値 Apple=A;Grape=G により、2 つの項目「Apple」と「Grape」のラジオ・ボタンがレンダリングされます。最初の項目を選択すると、関連するホスト画面の入力フィールドに「A」が挿入されます。
ラジオ・ボタンの集合の項目とホスト画面に挿入される値を同一にするには、項目のみを入力します。例えば、Apple=A;G です。この例では、ラジオ・ボタンの横、およびホスト画面の入力フィールドに、Gが表示されます。
- ヒントから設定
- これを選択した場合、コンポーネントによって認識されたヒントがラジオ・ボタン・セットにロードされます (「ヒント付き入力フィールド」コンポーネントの使用時に限り適用可能)。
- 表題ソース (Caption source)
- 生成されるラジオ・ボタンの集合の表題を決定する方法を指定します。オプション: 「コンポーネントから」 (コンポーネントから取り出した表題を使用) または「カスタム」(指定された表題を使用)。
- カスタム表題
- オプションです。集合の表題を指定します。
注:
この集合の表題を生成しない場合、この設定はブランクのままにしてください。
- 表題のスペースをトリム (Trim spaces on caption)
- これを選択した場合、表題の両端から空白 (余分なスペース) が除去されます。
- 1 行あたりの列数
- 次の行に折り返されるまでに、水平方向に表示されるラジオ・ボタンの数です。
- ラベルのスタイル・クラス Web のみ
- オプションです。ラジオ・ボタンの集合に対して生成される表題に関連する CSS スタイル・クラスです。デフォルト値は HATSCAPTION です。詳細については、スタイル・シートの使用を参照してください。
- ラジオ・ボタンのスタイル・クラス Web のみ
- オプションです。各ラジオ・ボタンに関連する CSS スタイル・クラスです。デフォルト値は HATSRADIOBUTTON です。詳細については、スタイル・シートの使用を参照してください。
- ラジオ・ボタンの説明のスタイル・クラス Web のみ
- オプションです。各ラジオ・ボタンの説明に関連する CSS スタイル・クラスです。デフォルト値は HATSTEXT です。詳細については、スタイル・シートの使用を参照してください。
- テーブルのスタイル・クラス Web のみ
- オプションです。生成されるテーブルに関連する CSS スタイル・クラスです。複数のラジオ・ボタンがレンダリングされる場合は、1 つの HTML テーブルが生成され、それらのラジオ・ボタンを囲みます。HTML テーブル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLE です。詳細については、スタイル・シートの使用を参照してください。
- スタイル Web のみ
- オプションです。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
__________________________________________________________________________
ラジオ・ボタン (項目選択)
ラジオ・ボタン (項目選択) ウィジェットは、ラジオ・ボタン・セットをレンダリングします。
このウィジェットは、以下のコンポーネントの提供するデータをレンダリングします。
次の図に、変換において項目の選択コンポーネントの例のデータを入力として使用するラジオ・ボタン (項目選択) ウィジェットの表示例を示します。
図 51. ラジオ・ボタン (項目選択) ウィジェットの例
- 表題 (コンポーネントから)
- 1 行あたりの列数 (デフォルトは 1)
以下の設定が、このウィジェットに対して構成できます。
- 表題
- 生成される入力フィールドの表題を決定する方法を指定します。オプション: 「コンポーネントから」 (コンポーネントから取り出した表題を使用) または「カスタム」(指定された表題を使用)。
- カスタム表題
- オプションです。入力フィールドの表題を指定します。
注:
チェック・ボックスの表題を生成しない場合は、この設定をブランクのままにしてください。
- 表題のスペースをトリム (Trim spaces on caption)
- これを選択した場合、表題の両端から空白 (余分なスペース) が除去されます。
- 1 行あたりの列数
- 次の行に折り返されるまでに、水平方向に表示される入力フィールドの数です。
- 選択値 (Selection value)
- 値を選択したときにホスト画面の入力フィールドに入力される値。オプション: /、S、または 1。
- 選択時に自動的に実行依頼
- これを選択した場合、ラジオ・ボタンが選択されると、その項目選択が実行依頼されます。ラジオ・ボタンがファンクション・キーから生成された場合、選択された項目のキーがホストに送信されます。
- 送信ボタンを表示
- これを選択した場合、ラジオ・ボタン・セットの下に送信ボタンがレンダリングされます。ファンクション・キー・コンポーネントとこのウィジェットを併用しているときには、適用しないでください。
- 送信ボタンの表題
- オプションです。送信ボタンの表題を指定します。
- ボタンのスタイル・クラス Web のみ
- オプションです。生成される送信ボタンに関連する CSS スタイル・クラスです。HTML ボタン・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSBUTTON です。詳細については、スタイル・シートの使用を参照してください。
- ラジオ・ボタンのスタイル・クラス Web のみ
- オプションです。各ラジオ・ボタンに関連する CSS スタイル・クラスです。デフォルト値は HATSRADIOBUTTON です。詳細については、スタイル・シートの使用を参照してください。
- ラジオ・ボタンの説明のスタイル・クラス Web のみ
- オプションです。各ラジオ・ボタンの説明に関連する CSS スタイル・クラスです。デフォルト値は HATSTEXT です。詳細については、スタイル・シートの使用を参照してください。
- ラベルのスタイル・クラス Web のみ
- オプションです。ラジオ・ボタンの集合に対して生成される表題に関連する CSS スタイル・クラスです。デフォルト値は HATSCAPTION です。詳細については、スタイル・シートの使用を参照してください。
- テーブルのスタイル・クラス Web のみ
- オプションです。生成されるテーブルに関連する CSS スタイル・クラスです。複数のラジオ・ボタンがレンダリングされる場合は、1 つの HTML テーブルが生成され、それらのラジオ・ボタンを囲みます。HTML テーブル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLE です。詳細については、スタイル・シートの使用を参照してください。
- スタイル Web のみ
- オプションです。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
__________________________________________________________________________
ラジオ・ボタン (選択)
ラジオ・ボタン (選択) ウィジェットは、ラジオ・ボタン・セットをレンダリングします。
このウィジェットは、以下のコンポーネントが提供するデータをレンダリングします。
次の図に、変換において選択リスト・コンポーネントの例のデータを入力として使用する選択リスト・ラジオ・ボタン・ウィジェットの表示例を示します。
図 52. 選択リスト・ラジオ・ボタン・ウィジェットの例
- 表題のタイプ (両方を表示)
- 1 行あたりの列数 (1)
- 先行トークン (両方を表示)
- 説明 (両方を表示)
- 送信ボタン (送信ボタンを表示)
- 送信ボタンの表題 (送信)
以下の設定が、このウィジェットに対して構成できます。
- 表題のタイプ
- 各ボタンの表題を決定する方法を指定します。コンポーネントから先行トークンの値および説明が取り込まれます。つまり、ボタンの表題上に表示される項目を選択できます。例えば、ホスト画面に「4. メール」というメニュー項目が存在する場合、表題表示として「4」、「メール」、または「4. メール」を選択できます。
- 表題のスペースをトリム (Trim spaces on caption)
- これを選択した場合、表題の両端から空白 (余分なスペース) が除去されます。
- 1 行あたりの列数
- 次の行に折り返されるまでに、水平方向に表示されるラジオ・ボタンの数です。
- 選択時に自動的に実行依頼
- これを選択した場合、ラジオ・ボタンが選択されると、選択が実行依頼されます。ラジオ・ボタンがファンクション・キーから生成された場合、選択された項目のキーがホストに送信されます。ラジオ・ボタンが選択リストから生成された場合、選択された項目の値が、ターゲット・フィールドに挿入され、指定されたアクション・キーがホストに送信されます。
- 送信ボタンを表示
- これを選択した場合、ラジオ・ボタン・セットの下に送信ボタンがレンダリングされます。ファンクション・キー・コンポーネントとこのウィジェットを併用しているときには、適用しないでください。
- 送信ボタンの表題
- オプションです。送信ボタンの表題を指定します。
- ボタンのスタイル・クラス Web のみ
- オプションです。生成される送信ボタンに関連する CSS スタイル・クラスです。HTML ボタン・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSBUTTON です。詳細については、スタイル・シートの使用を参照してください。
- ラジオ・ボタンのスタイル・クラス Web のみ
- オプションです。各ラジオ・ボタンに関連する CSS スタイル・クラスです。デフォルト値は HATSRADIOBUTTON です。詳細については、スタイル・シートの使用を参照してください。
- ラジオ・ボタンの説明のスタイル・クラス Web のみ
- オプションです。各ラジオ・ボタンの説明に関連する CSS スタイル・クラスです。デフォルト値は HATSTEXT です。詳細については、スタイル・シートの使用を参照してください。
- ラベルのスタイル・クラス Web のみ
- オプションです。ラジオ・ボタンの集合に対して生成される表題に関連する CSS スタイル・クラスです。デフォルト値は HATSCAPTION です。詳細については、スタイル・シートの使用を参照してください。
- テーブルのスタイル・クラス Web のみ
- オプションです。生成されるテーブルに関連する CSS スタイル・クラスです。複数のラジオ・ボタンがレンダリングされる場合は、1 つの HTML テーブルが生成され、それらのラジオ・ボタンを囲みます。HTML テーブル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLE です。詳細については、スタイル・シートの使用を参照してください。
- スタイル Web のみ
- オプションです。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
__________________________________________________________________________
スクロール・バー (ENPTUI) ウィジェットは、スクロール・バー・フィールド (ENPTUI) コンポーネントから提供されたデータをレンダリングします。
次の図に、変換においてスクロール・バー・フィールド (ENPTUI) コンポーネントの例のデータを入力として使用するスクロール・バー (ENPTUI) ウィジェットの表示例を示します。
図 53. スクロール・バー (ENPTUI) ウィジェットの例
- スクロール・バー
以下の設定が、このウィジェットに対して構成できます。
- スクロール・バーのスタイル・クラス Web のみ
- オプションです。スクロール・バーの外観に関連する CSS スタイル・クラスです。デフォルト値は HATSESCROLL です。詳細については、スタイル・シートの使用を参照してください。
- スクロール・バー・ボタンのスタイル・クラス Web のみ
- オプションです。スクロール・バー・ボタンに関連する CSS スタイル・クラスです。デフォルト値は HATSESCROLLBUTTON です。詳細については、スタイル・シートの使用を参照してください。
- ボタン矢印の色 Web のみ
- ボタン矢印の色です。デフォルト値は 「黒」 です。
- スタイル Web のみ
- オプションです。オーバーライドする任意の CSS プロパティー。例えば、このフィールドに「font-color: red; font-size:
18pt;」と指定して、このウィジェットのフォントの色およびサイズを変更できます。入力したプロパティーは、このウィジェットの各エレメントに適用されます。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
- 色のオーバーライド RCP のみ
- 背景色をオーバーライドするには、このオプションを選択し、提供される「背景色」設定コントロールを使用します。
__________________________________________________________________________
サブファイル (チェック・ボックス)
サブファイル (チェック・ボックス) ウィジェットは、5250 サブファイルをレンダリングします。
このウィジェットは、サブファイル・コンポーネントが提供するデータをレンダリングします。
注:
このウィジェットを使用する際の DBCS に関する考慮事項については、
SBCS での最大長の除去を参照してください。
次の図に、変換においてサブファイル・コンポーネントの例のデータを入力として使用するサブファイル (チェック・ボックス) ウィジェットの表示例を示します。
図 54. サブファイル (チェック・ボックス) ウィジェットの例
- 表題のタイプ (両方を表示)
- アクション・タイプ (リンク)
- アクションの場所 (サブファイルの上)
- チェック・ボックス
以下の設定が、このウィジェットに対して構成できます。
- 表題のタイプ:
- 各チェック・ボックスの表題を決定する方法を指定します。コンポーネントから先行トークンの値および説明が取り込まれます。つまり、表題として表示する項目を選択できます。例えば、ホスト画面に「5. 表示」というアクションが存在する場合、表題表示として「5」、「表示」、または「5. 表示」を選択できます。
- アクション・タイプ
- アクションをトリガーするために「ボタン」または「リンク」のいずれを使用するかを指定します。
- アクションの場所
- アクションをトリガーするボタンまたはリンクの位置を指定します。オプションは「サブファイルの上と下」、「サブファイルの上」、および「サブファイルの下」です。
- 1 レコードあたりの行数 (Rows per record)
-
- 行の代替色の表示 RCP のみ
- 行を代替色でレンダリングするには、このボックスを選択します。RGB カラー値は、テンプレートによって戻される ITableColorProvider オブジェクトによって決まります。RcpTemplate クラスおよび ITableColorProvider クラスについて詳しくは、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html) の『HATS RCP API 参照 (HATS RCP API Reference)』のセクションを参照してください。
- 行数 (Number of rows)
- サブファイル内の 1 レコードあたりの固定行数を指定します。
- 列の配置 Web のみ
-
このウィジェットは、データの基本列を表示し、必要に応じて追加詳細列を表示する詳細セクションを持つように構成できます。この設定は、モバイル装置にテーブル・データを表示するときに便利です。これらの設定および HATS Toolkit GUI に表示されないこのオプションの他の設定について詳しくは、モバイル装置に関する考慮事項および制約事項を参照してください。
- 基本列
- このフィールドを使用して、表示する列およびその順序を指定します。フィールドでは、拡張簡略記述を使用して、列番号の数値での任意の順序でリスト表示をすることができ、列を複数回表示したり、またはまったく表示させないこともできます (例: 「1,3,2,5-7,2-3,9」)。
2 つの数字の間のハイフン (-) は列の範囲を示します。アスタリスク文字 (*) を使用して、使用可能な最後の列を示すことができます。アスタリスクのみは、列 1 から n (n は使用可能な最後の列) を意味します。また、5-* の省略形として 5* を使用することもできます。1-* と * は同じ意味です。
Web プロジェクトでは、この設定のデフォルトは *、つまりすべての列になります。モバイル装置に最適化された Web プロジェクトでは、この設定のデフォルトは 1-2、つまり列 1 と列 2 になっています。
注:
数値はコンポーネントによってウィジェットに提供された列を表します。ウィジェットに提供される前に、除外されるかどうかわからないコンポーネントによって最初に認識された列を表すものではありません。
- 詳細列
- このオプションのフィールドを使用して、要求されたときに表示する詳細列およびその順序を指定します。フィールドでは、拡張簡略記述を使用して、数値での任意の順序でリスト表示することができます。
Web プロジェクトでは、この設定のデフォルトは空、つまり詳細列セクションはありません。モバイル装置に最適化された Web プロジェクトでは、この設定のデフォルトは 3*、つまり列 3 から最後の列になっています。
- 詳細列をサーバーに保持
- このオプションを選択して、ユーザーによって要求されるまで詳細列セクションをサーバーに保持します。これによって、初期レンダリングでの HTML 出力の量を削減できます。デフォルトはクリアされます。
- 強調表示された行 RCP のみ
- レンダリング時に、強調表示する行の集合を、コンマで区切って指定するか、または範囲指定します。この設定は、生成されたテーブル内の重要な行を強調表示する場合に便利です。この値で表される行は、実際のホスト画面ではなく、認識されるテーブルに基づきます。値の例: 1,2,3....、1、2 から 4、3 から 5。RGB カラー値は、テンプレートによって戻される ITableColorProvider オブジェクトによって決まります。RcpTemplate クラスおよび ITableColorProvider クラスについて詳しくは、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html) の『HATS RCP API 参照 (HATS RCP API Reference)』のセクションを参照してください。
- 強調表示された列 RCP のみ
- レンダリング時に強調表示する列の集合を、コンマで区切って指定するか、または範囲指定します。この設定は、生成されたテーブル内の重要な列を強調表示する場合に便利です。この値で表される列は、実際のホスト画面ではなく、認識されるテーブルに基づきます。値の例: 1,2,3....、1、2 から 4、3 から 5。RGB カラー値は、テンプレートによって戻される ITableColorProvider オブジェクトによって決まります。RcpTemplate クラスおよび ITableColorProvider クラスについて詳しくは、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html) の『HATS RCP API 参照 (HATS RCP API Reference)』のセクションを参照してください。
- 格子線の表示 RCP のみ
- レンダリングされるサブファイルで格子線を表示するには、このボックスを選択します。
- 列見出しのソース RCP のみ
- 列ヘッダーのテキストを、サブファイル・ヘッダー・コンポーネントから取り込むか (「コンポーネントから」)、またはユーザーが指定するか (「カスタム」) を、ドロップダウンから選択します。サブファイル・ヘッダー・コンポーネントから取り込む場合は、詳細についてヘッダーのコンポーネントの説明を参照してください。
- 列見出し (コンマ区切り) RCP のみ
- 「列見出しのソース」を「カスタム」に設定した場合に、複数の列ヘッダーをコンマで区切ってここに入力します。
- クラシック見出しスタイルを使用 RCP のみ
-
クラシック見出しスタイルを表示させるには、このボックスを選択します。また、「列見出しのソース」が「コンポーネントから」に設定されており、サブファイル・ヘッダー・コンポーネントにより複数行ヘッダーが検出されると、複数行ヘッダーが表示されます。デフォルトの SWT テーブル制御ヘッダーを単一行でのみ表示するには、このボックスをクリアします。
- ヘッダーのスペースをトリム (Trim spaces on headers) RCP のみ
- これを選択した場合、ヘッダー行のセルの内部にあるテキストの両端から空白 (余分なスペース) が除去されます。
- 前景色を使用可能にする
- これを選択した場合、ホスト画面の前景色がレンダリングされます。
Web アプリケーションの場合は、前景色はその色を表す CSS スタイルシート・クラスにマップされます。例えば、ホスト画面フィールドが RED とマークされている場合、フィールド・ウィジェットは、そのフィールド用に生成された HTML を、クラス名属性が HRED に設定されているタグで囲みます。この処理によって、ユーザーは、生成される Web ページ上にホスト画面の色を再マップすることができます。
注:
blacktheme.css は、ホスト画面フィールドの前景色を直接マップします (例えば、ホスト画面上の赤色のテキストは、生成された Web ページ上で赤色のテキストとして表示されます)。ただし、monochrome.css などの他のスタイルシート・ファイルは、フィールドの色を別の方法でマップし、一貫性のある、最新のスタイルを作成しようとします。
リッチ・クライアント・アプリケーションの場合、色はリッチ・クライアント・テンプレートによってマップされます。
注:
この設定は、「色のオーバーライド」>「前景色」の設定によってオーバーライドされます。
- フィールドのスタイル・クラス Web のみ
- オプションです。生成されたフィールドに関連する CSS スタイル・クラスです。HTML タグの class 属性の値には、この値がセットされます。デフォルト値は HATSFIELD です。詳細については、スタイル・シートの使用を参照してください。
- 拡張属性を使用可能にする
- これを選択した場合、拡張フィールド属性 (明滅、反転表示、下線、および列分離子) が指定されたスタイルで表示されます。詳細については、スタイル・シートの使用を参照してください。
- 明滅スタイル Web のみ
- ホスト画面における明滅テキストのレンダリングに使用する CSS スタイル設定。
- 反転表示スタイル (Reverse video style) Web のみ
- ホスト画面における反転表示テキストのレンダリングに使用する CSS スタイル設定。
- 下線スタイル (Underline style) Web のみ
- ホスト画面における下線付きテキストのレンダリングに使用する CSS スタイル設定。
- 列分離子スタイル (Column separator style) Web のみ
- ホスト画面における列分離子のレンダリングに使用する CSS スタイル設定。
- 入力フィールドの下線文字を除去 (Strip underscores on input field)
- テキストをレンダリングするときにテキストから下線文字を除去する場合は、このボックスを選択します。
- 入力フィールドのスペースをトリム
- 入力フィールドから先行および後続のスペースをトリムするには、このボックスを選択します。
- 入力フィールドのカーソル位置オプションを使用可能にする Web のみ
- このボックスを選択して、ユーザーが入力フィールドでデータ入力モードからカーソル位置決めモードに切り替えができるようにします。データ入力モードのときは、ユーザーは入力フィールドにデータを入力できます。カーソル位置決めモードのときは、タブ移動または別の方法で、入力フィールドの任意の文字上にカーソルを配置できます。この設定は他のカーソル位置決め機能を持たないモバイル装置用に最適化されている Web プロジェクトでは便利です。HATS Toolkit
GUI に表示されないこのオプションの他の設定のついては、モバイル装置に関する考慮事項および制約事項を参照してください。
- リンクのスタイル・クラス Web のみ
- オプションです。生成されたアクション・リンクに関連する CSS スタイル・クラスです。HTML リンク・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSLINK です。詳細については、スタイル・シートの使用を参照してください。
- ボタンのスタイル・クラス Web のみ
- オプションです。生成されたアクション・ボタンに関連する CSS スタイル・クラスです。HTML ボタン・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSBUTTON です。詳細については、スタイル・シートの使用を参照してください。
- チェック・ボックスのスタイル・クラス Web のみ
- オプションです。生成されるチェック・ボックスに関連する CSS スタイル・クラスです。HTML チェック・ボックス・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSCHECKBOX です。詳細については、スタイル・シートの使用を参照してください。
- テーブルのスタイル・クラス Web のみ
- オプションです。生成されるテーブルに関連する CSS スタイル・クラスです。HTML テーブル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLE です。詳細については、スタイル・シートの使用を参照してください。
- テーブル・セルのスタイル・クラス Web のみ
- オプションです。生成されるテーブル内の各セルに関連する CSS スタイル・クラスです。HTML テーブル・セル (td) タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLECELL です。詳細については、スタイル・シートの使用を参照してください。
- 見出し行のスタイル・クラス Web のみ
- オプションです。生成されるテーブル内の各ヘッダー行または列に関連する CSS スタイル・クラスです。HTML テーブルの行またはセル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLEHEADER です。詳細については、スタイル・シートの使用を参照してください。
- 奇数行のスタイル・クラス Web のみ
- オプションです。テーブル内の奇数番の各行に関連する CSS スタイル・クラスです。奇数行番号の各 HTML テーブル行タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLEODDROW です。詳細については、スタイル・シートの使用を参照してください。
- 偶数行のスタイル・クラス Web のみ
- オプションです。テーブル内の偶数番の各行に関連する CSS スタイル・クラスです。偶数行番号の各 HTML テーブル行タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLEEVENROW です。詳細については、スタイル・シートの使用を参照してください。
- スタイル Web のみ
- オプションです。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
- 色のオーバーライド RCP のみ
- 前景色と背景色を指定変更する場合は、このオプションを選択して、提供されている「前景色」と「背景色」の設定コントロールを使用します。
注:
リッチ・クライアント・プロジェクトでは、このウィジェットの各種色設定が次の順序 (最も高い優先度から低い優先度への順序) で適用されます。
- 強調表示された行/列
- 色のオーバーライド
- 拡張属性を使用可能にする/前景色を使用可能にする
- 行の代替色の表示
- fieldTextAlignment Web のみ
- Web プロジェクトで Sans Serif などの非モノスペース・フォントを使用すると、レンダリングされたデータはワード間のスペーシングの問題で適切には位置合わせされません。ソース設定 fieldTextAlignment を使用して、データの位置合わせを修正できます。この設定をプロジェクト全体で有効にするには、application.hap ファイルのソース・ビューを開き、SubfileCheckboxWidget ウィジェットのクラスを見つけ、次の例に示すように、設定値を NO_SEGMENTING に変更します。
<class name="com.ibm.hats.transform.widgets.SubfileCheckboxWidget">
.
<setting name="fieldTextAlignment" value="NO_SEGMENTING"/>
.
</class>
この設定を変換内のコンポーネント・レベルで有効にするには、変換のソース・ビューを開き、SubfileCheckboxWidget ウィジェットの HATS:Component タグを見つけ、次の例に示すように、設定値を NO_SEGMENTING に変更します。
...
widget="com.ibm.hats.transform.widgets.SubfileCheckboxWidget"
...
widgetSettings="...|fieldTextAlignment:NO_SEGMENTING|..."
...
この設定の値は、WORD_BY_WORD および NO_SEGMENTING です。デフォルト値は WORD_BY_WORD です。
注:
サブファイル・コンポーネントでデータ認識に「テーブル (可視)」認識オプションを使用している場合、この設定は効果がありません。
__________________________________________________________________________
サブファイル (ドロップダウン)
サブファイル (ドロップダウン) ウィジェットは、5250 サブファイルをレンダリングします。
このウィジェットは、サブファイル・コンポーネントが提供するデータをレンダリングします。
注:
このウィジェットを使用する際の DBCS に関する考慮事項については、
SBCS での最大長の除去を参照してください。
次の図に、変換においてサブファイル・コンポーネントの例のデータを入力として使用するサブファイル (ドロップダウン) ウィジェットの表示例を示します。
図 55. サブファイル (ドロップダウン) ウィジェットの例
- 表題のタイプ (両方を表示)
- 先行トークン
- 説明
- 送信ボタン (送信ボタンを表示)
- 送信ボタンの表題 (送信)
以下の設定が、このウィジェットに対して構成できます。
- 表題のタイプ:
- ドロップダウン内の各項目の表題を決定する方法を指定します。コンポーネントから先行トークンの値および説明が取り込まれます。つまり、表題として表示する項目を選択できます。例えば、ホスト画面に「5. 表示」というアクションが存在する場合、表題表示として「5」、「表示」、または「5. 表示」を選択できます。
- サブファイル・アクションを表示 (Show subfile actions)
- ドロップダウン・リストに加え、レンダリングされたサブファイルとサブファイル・アクションの説明文 (例: 2=Add) を表示する場合は、このボックスを選択します。このチェック・ボックスは、「説明を表示」を選択した場合には使用できません。
- 選択時に自動的に実行依頼
- これを選択した場合、ドロップダウンで選択操作が行われると、その選択内容が実行依頼されます。
- 送信ボタンを表示
- これを選択した場合、サブファイルの下に送信ボタンが表示されます。
- 送信ボタンの表題
- オプションです。送信ボタンの表題を指定します。
- ボタンのスタイル・クラス Web のみ
- オプションです。生成される送信ボタンに関連する CSS スタイル・クラスです。HTML ボタン・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSBUTTON です。詳細については、スタイル・シートの使用を参照してください。
- ボタン行のスタイル・クラス Web のみ
- オプションです。送信ボタンを含む生成されるテーブル行に関連する CSS スタイル・クラスです。デフォルト値は HATSTABLEHEADER です。詳細については、スタイル・シートの使用を参照してください。
- 1 レコードあたりの行数 (Rows per record)
-
- 行の代替色の表示 RCP のみ
- 行を代替色でレンダリングするには、このボックスを選択します。RGB カラー値は、テンプレートによって戻される ITableColorProvider オブジェクトによって決まります。RcpTemplate クラスおよび ITableColorProvider クラスについて詳しくは、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html) の『HATS RCP API 参照 (HATS RCP API Reference)』のセクションを参照してください。
- 行数 (Number of rows)
- サブファイル内の 1 レコードあたりの固定行数を指定します。
- 列の配置 Web のみ
-
このウィジェットは、データの基本列を表示し、必要に応じて追加詳細列を表示する詳細セクションを持つように構成できます。この設定は、モバイル装置にテーブル・データを表示するときに便利です。これらの設定および HATS Toolkit GUI に表示されないこのオプションの他の設定について詳しくは、モバイル装置に関する考慮事項および制約事項を参照してください。
- 基本列
- このフィールドを使用して、表示する列およびその順序を指定します。フィールドでは、拡張簡略記述を使用して、列番号の数値での任意の順序でリスト表示をすることができ、列を複数回表示したり、またはまったく表示させないこともできます (例: 「1,3,2,5-7,2-3,9」)。
2 つの数字の間のハイフン (-) は列の範囲を示します。アスタリスク文字 (*) を使用して、使用可能な最後の列を示すことができます。アスタリスクのみは、列 1 から n (n は使用可能な最後の列) を意味します。また、5-* の省略形として 5* を使用することもできます。1-* と * は同じ意味です。
Web プロジェクトでは、この設定のデフォルトは *、つまりすべての列になります。モバイル装置に最適化された Web プロジェクトでは、この設定のデフォルトは 1-2、つまり列 1 と列 2 になっています。
注:
数値はコンポーネントによってウィジェットに提供された列を表します。ウィジェットに提供される前に、除外されるかどうかわからないコンポーネントによって最初に認識された列を表すものではありません。
- 詳細列
- このオプションのフィールドを使用して、要求されたときに表示する詳細列およびその順序を指定します。フィールドでは、拡張簡略記述を使用して、数値での任意の順序でリスト表示することができます。
Web プロジェクトでは、この設定のデフォルトは空、つまり詳細列セクションはありません。モバイル装置に最適化された Web プロジェクトでは、この設定のデフォルトは 3*、つまり列 3 から最後の列になっています。
- 詳細列をサーバーに保持
- このオプションを選択して、ユーザーによって要求されるまで詳細列セクションをサーバーに保持します。これによって、初期レンダリングでの HTML 出力の量を削減できます。デフォルトはクリアされます。
- 強調表示された行 RCP のみ
- レンダリング時に、強調表示する行の集合を、コンマで区切って指定するか、または範囲指定します。この設定は、生成されたテーブル内の重要な行を強調表示する場合に便利です。この値で表される行は、実際のホスト画面ではなく、認識されるテーブルに基づきます。値の例: 1,2,3....、1、2 から 4、3 から 5。RGB カラー値は、テンプレートによって戻される ITableColorProvider オブジェクトによって決まります。RcpTemplate クラスおよび ITableColorProvider クラスについて詳しくは、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html) の『HATS RCP API 参照 (HATS RCP API Reference)』のセクションを参照してください。
- 強調表示された列 RCP のみ
- レンダリング時に強調表示する列の集合を、コンマで区切って指定するか、または範囲指定します。この設定は、生成されたテーブル内の重要な列を強調表示する場合に便利です。この値で表される列は、実際のホスト画面ではなく、認識されるテーブルに基づきます。値の例: 1,2,3....、1、2 から 4、3 から 5。RGB カラー値は、テンプレートによって戻される ITableColorProvider オブジェクトによって決まります。RcpTemplate クラスおよび ITableColorProvider クラスについて詳しくは、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html) の『HATS RCP API 参照 (HATS RCP API Reference)』のセクションを参照してください。
- 格子線の表示 RCP のみ
- レンダリングされるサブファイルで格子線を表示するには、このボックスを選択します。
- 列見出しのソース RCP のみ
- 列ヘッダーのテキストを、サブファイル・ヘッダー・コンポーネントから取り込むか (「コンポーネントから」)、またはユーザーが指定するか (「カスタム」) を、ドロップダウンから選択します。サブファイル・ヘッダー・コンポーネントから取り込む場合は、詳細についてヘッダーのコンポーネントの説明を参照してください。
- 列見出し (コンマ区切り) RCP のみ
- 「列見出しのソース」を「カスタム」に設定した場合に、複数の列ヘッダーをコンマで区切ってここに入力します。
- クラシック見出しスタイルを使用 RCP のみ
-
クラシック見出しスタイルを表示させるには、このボックスを選択します。また、「列見出しのソース」が「コンポーネントから」に設定されており、サブファイル・ヘッダー・コンポーネントにより複数行ヘッダーが検出されると、複数行ヘッダーが表示されます。デフォルトの SWT テーブル制御ヘッダーを単一行でのみ表示するには、このボックスをクリアします。
- ヘッダーのスペースをトリム (Trim spaces on headers) RCP のみ
- これを選択した場合、ヘッダー行のセルの内部にあるテキストの両端から空白 (余分なスペース) が除去されます。
- 前景色を使用可能にする
- これを選択した場合、ホスト画面の前景色がレンダリングされます。
Web アプリケーションの場合は、前景色はその色を表す CSS スタイルシート・クラスにマップされます。例えば、ホスト画面フィールドが RED とマークされている場合、フィールド・ウィジェットは、そのフィールド用に生成された HTML を、クラス名属性が HRED に設定されているタグで囲みます。この処理によって、ユーザーは、生成される Web ページ上にホスト画面の色を再マップすることができます。
注:
blacktheme.css は、ホスト画面フィールドの前景色を直接マップします (例えば、ホスト画面上の赤色のテキストは、生成された Web ページ上で赤色のテキストとして表示されます)。ただし、monochrome.css などの他のスタイルシート・ファイルは、フィールドの色を別の方法でマップし、一貫性のある、最新のスタイルを作成しようとします。
リッチ・クライアント・アプリケーションの場合、色はリッチ・クライアント・テンプレートによってマップされます。
注:
この設定は、「色のオーバーライド」>「前景色」の設定によってオーバーライドされます。
- フィールドのスタイル・クラス Web のみ
- オプションです。生成されたフィールドに関連する CSS スタイル・クラスです。HTML タグの class 属性の値には、この値がセットされます。デフォルト値は HATSFIELD です。詳細については、スタイル・シートの使用を参照してください。
- 拡張属性を使用可能にする
- これを選択した場合、拡張フィールド属性 (明滅、反転表示、下線、および列分離子) が指定されたスタイルで表示されます。詳細については、スタイル・シートの使用を参照してください。
- 明滅スタイル Web のみ
- ホスト画面における明滅テキストのレンダリングに使用する CSS スタイル設定。
- 反転表示スタイル (Reverse video style) Web のみ
- ホスト画面における反転表示テキストのレンダリングに使用する CSS スタイル設定。
- 下線スタイル (Underline style) Web のみ
- ホスト画面における下線付きテキストのレンダリングに使用する CSS スタイル設定。
- 列分離子スタイル (Column separator style) Web のみ
- ホスト画面における列分離子のレンダリングに使用する CSS スタイル設定。
- 入力フィールドの下線文字を除去 (Strip underscores on input field)
- テキストをレンダリングするときにテキストから下線文字を除去する場合は、このボックスを選択します。
- 入力フィールドのスペースをトリム
- 入力フィールドから先行および後続のスペースをトリムするには、このボックスを選択します。
- 入力フィールドのカーソル位置オプションを使用可能にする Web のみ
- このボックスを選択して、ユーザーが入力フィールドでデータ入力モードからカーソル位置決めモードに切り替えができるようにします。データ入力モードのときは、ユーザーは入力フィールドにデータを入力できます。カーソル位置決めモードのときは、タブ移動または別の方法で、入力フィールドの任意の文字上にカーソルを配置できます。この設定は他のカーソル位置決め機能を持たないモバイル装置用に最適化されている Web プロジェクトでは便利です。HATS Toolkit
GUI に表示されないこのオプションの他の設定のついては、モバイル装置に関する考慮事項および制約事項を参照してください。
- ドロップダウンのスタイル・クラス Web のみ
- オプションです。生成されるドロップダウンに関連する CSS スタイル・クラスです。HTML ドロップダウン・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSDROPDOWN です。詳細については、スタイル・シートの使用を参照してください。
- リスト・オプションのスタイル・クラス Web のみ
- オプションです。ドロップダウンの各オプションに関連する CSS スタイル・クラスです。デフォルト値は HATSOPTION です。詳細については、スタイル・シートの使用を参照してください。
- テーブルのスタイル・クラス Web のみ
- オプションです。生成されるテーブルに関連する CSS スタイル・クラスです。HTML テーブル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLE です。詳細については、スタイル・シートの使用を参照してください。
- テーブル・セルのスタイル・クラス Web のみ
- オプションです。生成されるテーブル内の各セルに関連する CSS スタイル・クラスです。HTML テーブル・セル (td) タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLECELL です。詳細については、スタイル・シートの使用を参照してください。
- 見出し行のスタイル・クラス Web のみ
- オプションです。生成されるテーブル内の各ヘッダー行または列に関連する CSS スタイル・クラスです。HTML テーブルの行またはセル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLEHEADER です。詳細については、スタイル・シートの使用を参照してください。
- 奇数行のスタイル・クラス Web のみ
- オプションです。テーブル内の奇数番の各行に関連する CSS スタイル・クラスです。奇数行番号の各 HTML テーブル行タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLEODDROW です。詳細については、スタイル・シートの使用を参照してください。
- 偶数行のスタイル・クラス Web のみ
- オプションです。テーブル内の偶数番の各行に関連する CSS スタイル・クラスです。偶数行番号の各 HTML テーブル行タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLEEVENROW です。詳細については、スタイル・シートの使用を参照してください。
- スタイル Web のみ
- オプションです。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
- 色のオーバーライド RCP のみ
- 前景色と背景色を指定変更する場合は、このオプションを選択して、提供されている「前景色」と「背景色」の設定コントロールを使用します。
注:
リッチ・クライアント・プロジェクトでは、このウィジェットの各種色設定が次の順序 (最も高い優先度から低い優先度への順序) で適用されます。
- 強調表示された行/列
- 色のオーバーライド
- 拡張属性を使用可能にする/前景色を使用可能にする
- 行の代替色の表示
- fieldTextAlignment Web のみ
- Web プロジェクトで Sans Serif などの非モノスペース・フォントを使用すると、レンダリングされたデータはワード間のスペーシングの問題で適切には位置合わせされません。ソース設定 fieldTextAlignment を使用して、データの位置合わせを修正できます。この設定をプロジェクト全体で有効にするには、application.hap ファイルのソース・ビューを開き、SubfileWidgetV6 ウィジェットのクラスを見つけ、次の例に示すように、設定値を NO_SEGMENTING に変更します。
<class name="com.ibm.hats.transform.widgets.SubfileWidgetV6">
.
<setting name="fieldTextAlignment" value="NO_SEGMENTING"/>
.
</class>
この設定を変換内のコンポーネント・レベルで有効にするには、変換のソース・ビューを開き、SubfileWidgetV6 ウィジェットの HATS:Component タグを見つけ、次の例に示すように、設定値を NO_SEGMENTING に変更します。
...
widget="com.ibm.hats.transform.widgets.SubfileWidgetV6"
...
widgetSettings="...|fieldTextAlignment:NO_SEGMENTING|..."
...
この設定の値は、WORD_BY_WORD および NO_SEGMENTING です。デフォルト値は WORD_BY_WORD です。
注:
サブファイル・コンポーネントでデータ認識に「テーブル (可視)」認識オプションを使用している場合、この設定は効果がありません。
__________________________________________________________________________
サブファイル (ポップアップ) ウィジェットは、5250 サブファイルをレンダリングします。
このウィジェットは、サブファイル・コンポーネントが提供するデータをレンダリングします。
注:
このウィジェットを使用する際の DBCS に関する考慮事項については、
SBCS での最大長の除去を参照してください。
次の図に、変換においてサブファイル・コンポーネントの例のデータを入力として使用するサブファイル・ウィジェットの表示例を示します。
図 56. サブファイル (ポップアップ) ウィジェットの例
- 表題のタイプ (両方を表示)
- ランチャー・タイプ (イメージ)
以下の設定が、このウィジェットに対して構成できます。
- 表題のタイプ:
- ポップアップ・ダイアログの各項目の表題を決定する方法を指定します。コンポーネントから先行トークンの値および説明が取り込まれます。つまり、表題として表示する項目を選択できます。例えば、ホスト画面に「5. 表示」というアクションが存在する場合、表題表示として「5」、「表示」、または「5. 表示」を選択できます。
- サブファイル・アクションを表示 (Show subfile actions)
- ポップアップ・ダイアログに加え、レンダリングされたサブファイルとサブファイル・アクションの説明文 (例: 2=Add) を表示する場合は、このボックスを選択します。このチェック・ボックスは、「説明を表示」を選択した場合には使用できません。
- 選択時に自動的に実行依頼
- これを選択した場合、ポップアップ・ダイアログで選択操作が行われると、その選択内容が実行依頼されます。
- 送信ボタンを表示
- これを選択した場合、サブファイルの下に送信ボタンが表示されます。
- 送信ボタンの表題
- オプションです。送信ボタンの表題を指定します。
- ボタンのスタイル・クラス Web のみ
- オプションです。生成される送信ボタンに関連する CSS スタイル・クラスです。HTML ボタン・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSBUTTON です。詳細については、スタイル・シートの使用を参照してください。
- ボタン行のスタイル・クラス Web のみ
- オプションです。送信ボタンを含む生成されるテーブル行に関連する CSS スタイル・クラスです。デフォルト値は HATSTABLEHEADER です。詳細については、スタイル・シートの使用を参照してください。
- ランチャー・タイプ
- ポップアップ・ダイアログを開くときに「イメージ」、「ボタン」、または「リンク」のいずれを使用するかを指定します。
- イメージ・ファイル名 (Image filename)
- オプションです。ランチャーで使用するイメージのファイル名。
- 表題
- オプションです。ランチャー・ボタンまたはリンクで使用する表題。
- リンクのスタイル・クラス Web のみ
- オプションです。生成されたアクション・リンクに関連する CSS スタイル・クラスです。HTML リンク・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSLINK です。詳細については、スタイル・シートの使用を参照してください。
- ボタンのスタイル・クラス Web のみ
- オプションです。生成されたアクション・ボタンに関連する CSS スタイル・クラスです。HTML ボタン・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSBUTTON です。詳細については、スタイル・シートの使用を参照してください。
- リンクの表題を閉じる Web のみ
- 「クローズ・リンク」アクションで表示される表題。
- 1 レコードあたりの行数 (Rows per record)
-
- 行の代替色の表示 RCP のみ
- 行を代替色でレンダリングするには、このボックスを選択します。RGB カラー値は、テンプレートによって戻される ITableColorProvider オブジェクトによって決まります。RcpTemplate クラスおよび ITableColorProvider クラスについて詳しくは、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html) の『HATS RCP API 参照 (HATS RCP API Reference)』のセクションを参照してください。
- 行数 (Number of rows)
- サブファイル内の 1 レコードあたりの固定行数を指定します。
- 列の配置 Web のみ
-
このウィジェットは、データの基本列を表示し、必要に応じて追加詳細列を表示する詳細セクションを持つように構成できます。この設定は、モバイル装置にテーブル・データを表示するときに便利です。これらの設定および HATS Toolkit GUI に表示されないこのオプションの他の設定について詳しくは、モバイル装置に関する考慮事項および制約事項を参照してください。
- 基本列
- このフィールドを使用して、表示する列およびその順序を指定します。フィールドでは、拡張簡略記述を使用して、列番号の数値での任意の順序でリスト表示をすることができ、列を複数回表示したり、またはまったく表示させないこともできます (例: 「1,3,2,5-7,2-3,9」)。
2 つの数字の間のハイフン (-) は列の範囲を示します。アスタリスク文字 (*) を使用して、使用可能な最後の列を示すことができます。アスタリスクのみは、列 1 から n (n は使用可能な最後の列) を意味します。また、5-* の省略形として 5* を使用することもできます。1-* と * は同じ意味です。
Web プロジェクトでは、この設定のデフォルトは *、つまりすべての列になります。モバイル装置に最適化された Web プロジェクトでは、この設定のデフォルトは 1-2、つまり列 1 と列 2 になっています。
注:
数値はコンポーネントによってウィジェットに提供された列を表します。ウィジェットに提供される前に、除外されるかどうかわからないコンポーネントによって最初に認識された列を表すものではありません。
- 詳細列
- このオプションのフィールドを使用して、要求されたときに表示する詳細列およびその順序を指定します。フィールドでは、拡張簡略記述を使用して、数値での任意の順序でリスト表示することができます。
Web プロジェクトでは、この設定のデフォルトは空、つまり詳細列セクションはありません。モバイル装置に最適化された Web プロジェクトでは、この設定のデフォルトは 3*、つまり列 3 から最後の列になっています。
- 詳細列をサーバーに保持
- このオプションを選択して、ユーザーによって要求されるまで詳細列セクションをサーバーに保持します。これによって、初期レンダリングでの HTML 出力の量を削減できます。デフォルトはクリアされます。
- 強調表示された行 RCP のみ
- レンダリング時に、強調表示する行の集合を、コンマで区切って指定するか、または範囲指定します。この設定は、生成されたテーブル内の重要な行を強調表示する場合に便利です。この値で表される行は、実際のホスト画面ではなく、認識されるテーブルに基づきます。値の例: 1,2,3....、1、2 から 4、3 から 5。RGB カラー値は、テンプレートによって戻される ITableColorProvider オブジェクトによって決まります。RcpTemplate クラスおよび ITableColorProvider クラスについて詳しくは、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html) の『HATS RCP API 参照 (HATS RCP API Reference)』のセクションを参照してください。
- 強調表示された列 RCP のみ
- レンダリング時に強調表示する列の集合を、コンマで区切って指定するか、または範囲指定します。この設定は、生成されたテーブル内の重要な列を強調表示する場合に便利です。この値で表される列は、実際のホスト画面ではなく、認識されるテーブルに基づきます。値の例: 1,2,3....、1、2 から 4、3 から 5。RGB カラー値は、テンプレートによって戻される ITableColorProvider オブジェクトによって決まります。RcpTemplate クラスおよび ITableColorProvider クラスについて詳しくは、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html) の『HATS RCP API 参照 (HATS RCP API Reference)』のセクションを参照してください。
- 格子線の表示 RCP のみ
- レンダリングされるサブファイルで格子線を表示するには、このボックスを選択します。
- 列見出しのソース RCP のみ
- 列ヘッダーのテキストを、サブファイル・ヘッダー・コンポーネントから取り込むか (「コンポーネントから」)、またはユーザーが指定するか (「カスタム」) を、ドロップダウンから選択します。サブファイル・ヘッダー・コンポーネントから取り込む場合は、詳細についてヘッダーのコンポーネントの説明を参照してください。
- 列見出し (コンマ区切り) RCP のみ
- 「列見出しのソース」を「カスタム」に設定した場合に、複数の列ヘッダーをコンマで区切ってここに入力します。
- クラシック見出しスタイルを使用 RCP のみ
-
クラシック見出しスタイルを表示させるには、このボックスを選択します。また、「列見出しのソース」が「コンポーネントから」に設定されており、サブファイル・ヘッダー・コンポーネントにより複数行ヘッダーが検出されると、複数行ヘッダーが表示されます。デフォルトの SWT テーブル制御ヘッダーを単一行でのみ表示するには、このボックスをクリアします。
- ヘッダーのスペースをトリム (Trim spaces on headers) RCP のみ
- これを選択した場合、ヘッダー行のセルの内部にあるテキストの両端から空白 (余分なスペース) が除去されます。
- 前景色を使用可能にする
- これを選択した場合、ホスト画面の前景色がレンダリングされます。
Web アプリケーションの場合は、前景色はその色を表す CSS スタイルシート・クラスにマップされます。例えば、ホスト画面フィールドが RED とマークされている場合、フィールド・ウィジェットは、そのフィールド用に生成された HTML を、クラス名属性が HRED に設定されているタグで囲みます。この処理によって、ユーザーは、生成される Web ページ上にホスト画面の色を再マップすることができます。
注:
blacktheme.css は、ホスト画面フィールドの前景色を直接マップします (例えば、ホスト画面上の赤色のテキストは、生成された Web ページ上で赤色のテキストとして表示されます)。ただし、monochrome.css などの他のスタイルシート・ファイルは、フィールドの色を別の方法でマップし、一貫性のある、最新のスタイルを作成しようとします。
リッチ・クライアント・アプリケーションの場合、色はリッチ・クライアント・テンプレートによってマップされます。
注:
この設定は、「色のオーバーライド」>「前景色」の設定によってオーバーライドされます。
- フィールドのスタイル・クラス Web のみ
- オプションです。生成されたフィールドに関連する CSS スタイル・クラスです。HTML タグの class 属性の値には、この値がセットされます。デフォルト値は HATSFIELD です。詳細については、スタイル・シートの使用を参照してください。
- 拡張属性を使用可能にする
- これを選択した場合、拡張フィールド属性 (明滅、反転表示、下線、および列分離子) が指定されたスタイルで表示されます。詳細については、スタイル・シートの使用を参照してください。
- 明滅スタイル Web のみ
- ホスト画面における明滅テキストのレンダリングに使用する CSS スタイル設定。
- 反転表示スタイル (Reverse video style) Web のみ
- ホスト画面における反転表示テキストのレンダリングに使用する CSS スタイル設定。
- 下線スタイル (Underline style) Web のみ
- ホスト画面における下線付きテキストのレンダリングに使用する CSS スタイル設定。
- 列分離子スタイル (Column separator style) Web のみ
- ホスト画面における列分離子のレンダリングに使用する CSS スタイル設定。
- 入力フィールドの下線文字を除去 (Strip underscores on input field)
- テキストをレンダリングするときにテキストから下線文字を除去する場合は、このボックスを選択します。
- 入力フィールドのスペースをトリム
- 入力フィールドから先行および後続のスペースをトリムするには、このボックスを選択します。
- 入力フィールドのカーソル位置オプションを使用可能にする Web のみ
- このボックスを選択して、ユーザーが入力フィールドでデータ入力モードからカーソル位置決めモードに切り替えができるようにします。データ入力モードのときは、ユーザーは入力フィールドにデータを入力できます。カーソル位置決めモードのときは、タブ移動または別の方法で、入力フィールドの任意の文字上にカーソルを配置できます。この設定は他のカーソル位置決め機能を持たないモバイル装置用に最適化されている Web プロジェクトでは便利です。HATS Toolkit
GUI に表示されないこのオプションの他の設定のついては、モバイル装置に関する考慮事項および制約事項を参照してください。
- 入力フィールドのスタイル・クラス Web のみ
- オプションです。生成される入力フィールドに関連する CSS スタイル・クラスです。HTML 入力タグの class 属性の値には、この値がセットされます。デフォルト値は HATSINPUT です。詳細については、スタイル・シートの使用を参照してください。
- ウィンドウのスタイル・クラス Web のみ
- オプションです。生成されるウィンドウに関連する CSS スタイル・クラスです。デフォルト値は、HATSPOPUP です。詳細については、スタイル・シートの使用を参照してください。
- クローズ・リンクのスタイル・クラス Web のみ
- オプションです。ウィンドウのクローズに使用するリンクに関連する CSS スタイル・クラスです。デフォルト値は HATSLINK です。詳細については、スタイル・シートの使用を参照してください。
- 項目リンクのスタイル・クラス Web のみ
- オプションです。ウィジェットからの項目の選択で使用するリンクに関連する CSS スタイル・クラスです。デフォルト値は HATSPOPUPITEMLINK です。詳細については、スタイル・シートの使用を参照してください。
- テーブルのスタイル・クラス Web のみ
- オプションです。生成されるテーブルに関連する CSS スタイル・クラスです。HTML テーブル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLE です。詳細については、スタイル・シートの使用を参照してください。
- テーブル・セルのスタイル・クラス Web のみ
- オプションです。生成されるテーブル内の各セルに関連する CSS スタイル・クラスです。HTML テーブル・セル (td) タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLECELL です。詳細については、スタイル・シートの使用を参照してください。
- 見出し行のスタイル・クラス Web のみ
- オプションです。生成されるテーブル内の各ヘッダー行または列に関連する CSS スタイル・クラスです。HTML テーブルの行またはセル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLEHEADER です。詳細については、スタイル・シートの使用を参照してください。
- 奇数行のスタイル・クラス Web のみ
- オプションです。テーブル内の奇数番の各行に関連する CSS スタイル・クラスです。奇数行番号の各 HTML テーブル行タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLEODDROW です。詳細については、スタイル・シートの使用を参照してください。
- 偶数行のスタイル・クラス Web のみ
- オプションです。テーブル内の偶数番の各行に関連する CSS スタイル・クラスです。偶数行番号の各 HTML テーブル行タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLEEVENROW です。詳細については、スタイル・シートの使用を参照してください。
- スタイル Web のみ
- オプションです。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
- 色のオーバーライド RCP のみ
- 前景色と背景色を指定変更する場合は、このオプションを選択して、提供されている「前景色」と「背景色」の設定コントロールを使用します。
注:
リッチ・クライアント・プロジェクトでは、このウィジェットの各種色設定が次の順序 (最も高い優先度から低い優先度への順序) で適用されます。
- 強調表示された行/列
- 色のオーバーライド
- 拡張属性を使用可能にする/前景色を使用可能にする
- 行の代替色の表示
- fieldTextAlignment Web のみ
- Web プロジェクトで Sans Serif などの非モノスペース・フォントを使用すると、レンダリングされたデータはワード間のスペーシングの問題で適切には位置合わせされません。ソース設定 fieldTextAlignment を使用して、データの位置合わせを修正できます。この設定をプロジェクト全体で有効にするには、application.hap ファイルのソース・ビューを開き、SubfilePopupWidget ウィジェットのクラスを見つけ、次の例に示すように、設定値を NO_SEGMENTING に変更します。
<class name="com.ibm.hats.transform.widgets.SubfilePopupWidget">
.
<setting name="fieldTextAlignment" value="NO_SEGMENTING"/>
.
</class>
この設定を変換内のコンポーネント・レベルで有効にするには、変換のソース・ビューを開き、SubfilePopupWidget ウィジェットの HATS:Component タグを見つけ、次の例に示すように、設定値を NO_SEGMENTING に変更します。
...
widget="com.ibm.hats.transform.widgets.SubfilePopupWidget"
...
widgetSettings="...|fieldTextAlignment:NO_SEGMENTING|..."
...
この設定の値は、WORD_BY_WORD および NO_SEGMENTING です。デフォルト値は WORD_BY_WORD です。
注:
サブファイル・コンポーネントでデータ認識に「テーブル (可視)」認識オプションを使用している場合、この設定は効果がありません。
__________________________________________________________________________
テーブル
テーブル・ウィジェットは、GUI テーブルをレンダリングします。
このウィジェットは、以下のコンポーネントが提供するデータをレンダリングします。
注:
このウィジェットを使用する際の DBCS に関する考慮事項については、
SBCS での最大長の除去を参照してください。
次の図に、変換においてテーブル (フィールド)・コンポーネントの例のデータを入力として使用するテーブル・ウィジェットの表示例を示します。
- ヘッダー行 (1)
- ヘッダー列 (指定しない)
以下の設定が、このウィジェットに対して構成できます。
- ヘッダー行 (Header row) Web のみ
- テーブル・ヘッダーとしてレンダリングされるコンマで区切られた、または範囲指定による行の集合です。この設定は、生成されたテーブル内の重要な行を強調表示する場合に便利です。この値で表される行は、実際のホスト画面ではなく、認識されるテーブルに基づきます。値の例: 1,2,3....、1、2 から 4、3 から 5。「見出し行のスタイル・クラス」設定の説明を参照してください。
- 強調表示された行 RCP のみ
- レンダリング時に、強調表示する行の集合を、コンマで区切って指定するか、または範囲指定します。この設定は、生成されたテーブル内の重要な行を強調表示する場合に便利です。この値で表される行は、実際のホスト画面ではなく、認識されるテーブルに基づきます。値の例: 1,2,3....、1、2 から 4、3 から 5。RGB カラー値は、テンプレートによって戻される ITableColorProvider オブジェクトによって決まります。RcpTemplate クラスおよび ITableColorProvider クラスについて詳しくは、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html) の『HATS RCP API 参照 (HATS RCP API Reference)』のセクションを参照してください。
- 強調表示された列 RCP のみ
- レンダリング時に強調表示する列の集合を、コンマで区切って指定するか、または範囲指定します。この設定は、生成されたテーブル内の重要な列を強調表示する場合に便利です。この値で表される列は、実際のホスト画面ではなく、認識されるテーブルに基づきます。値の例: 1,2,3....、1、2 から 4、3 から 5。RGB カラー値は、テンプレートによって戻される ITableColorProvider オブジェクトによって決まります。RcpTemplate クラスおよび ITableColorProvider クラスについて詳しくは、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html) の『HATS RCP API 参照 (HATS RCP API Reference)』のセクションを参照してください。
- 行の代替色の表示 RCP のみ
- 行を代替色でレンダリングするには、このボックスを選択します。RGB カラー値は、テンプレートによって戻される ITableColorProvider オブジェクトによって決まります。RcpTemplate クラスおよび ITableColorProvider クラスについて詳しくは、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html) の『HATS RCP API 参照 (HATS RCP API Reference)』のセクションを参照してください。
- 格子線の表示 RCP のみ
- レンダリングされるテーブルで格子線を表示するには、このボックスを選択します。
- 列見出しのソース RCP のみ
- 列ヘッダーのテキストを、テーブル・コンポーネントから取り込むか (「コンポーネントから」)、またはユーザーが指定するか (「カスタム」) を、ドロップダウンから選択します。テーブル・コンポーネントから取り込む場合は、詳細についてテーブルの「タイトル行の数」設定のコンポーネント説明を参照してください。
- 列見出し (コンマ区切り) RCP のみ
- 「列見出しのソース」を「カスタム」に設定した場合に、複数の列ヘッダーをコンマで区切ってここに入力します。
- ヘッダーのスペースをトリム (Trim spaces on headers)
- これを選択した場合、ヘッダー行のセルの内部にあるテキストの両端から空白 (余分なスペース) が除去されます。
- ヘッダー列 Web のみ
- ヘッダーとしてレンダリングされるコンマで区切られた、または範囲指定によるテーブル列の集合です。この設定は、生成されたテーブル内の重要な列 (通常は最初の列) を強調表示する場合に便利です。この値で表される列は、実際のホスト画面ではなく、認識されるテーブルに基づきます。値の例: 1,2,3....、1、2 から 4、3 から 5。「見出し行のスタイル・クラス」設定の説明を参照してください。
- 入力を使用不可にする
- これを選択した場合、レンダリングされた入力フィールドは読み取り専用になります。読み取り専用の入力フィールドは通常の入力フィールドのように表示されますが、ユーザーはこのフィールドの内容を変更できません。これは、無保護フィールドの内容をユーザーに対して表示するが、ユーザーがフィールドの内容を変更できないようにする場合に便利です。
- 列の配置 Web のみ
-
このウィジェットは、データの基本列を表示し、必要に応じて追加詳細列を表示する詳細セクションを持つように構成できます。この設定は、モバイル装置にテーブル・データを表示するときに便利です。これらの設定および HATS Toolkit GUI に表示されないこのオプションの他の設定について詳しくは、モバイル装置に関する考慮事項および制約事項を参照してください。
- 基本列
- このフィールドを使用して、表示する列およびその順序を指定します。フィールドでは、拡張簡略記述を使用して、列番号の数値での任意の順序でリスト表示をすることができ、列を複数回表示したり、またはまったく表示させないこともできます (例: 「1,3,2,5-7,2-3,9」)。
2 つの数字の間のハイフン (-) は列の範囲を示します。アスタリスク文字 (*) を使用して、使用可能な最後の列を示すことができます。アスタリスクのみは、列 1 から n (n は使用可能な最後の列) を意味します。また、5-* の省略形として 5* を使用することもできます。1-* と * は同じ意味です。
Web プロジェクトでは、この設定のデフォルトは *、つまりすべての列になります。モバイル装置に最適化された Web プロジェクトでは、この設定のデフォルトは 1-2、つまり列 1 と列 2 になっています。
注:
数値はコンポーネントによってウィジェットに提供された列を表します。ウィジェットに提供される前に、除外されるかどうかわからないコンポーネントによって最初に認識された列を表すものではありません。
- 詳細列
- このオプションのフィールドを使用して、要求されたときに表示する詳細列およびその順序を指定します。フィールドでは、拡張簡略記述を使用して、数値での任意の順序でリスト表示することができます。
Web プロジェクトでは、この設定のデフォルトは空、つまり詳細列セクションはありません。モバイル装置に最適化された Web プロジェクトでは、この設定のデフォルトは 3*、つまり列 3 から最後の列になっています。
- 詳細列をサーバーに保持
- このオプションを選択して、ユーザーによって要求されるまで詳細列セクションをサーバーに保持します。これによって、初期レンダリングでの HTML 出力の量を削減できます。デフォルトはクリアされます。
- 入力フィールドの下線文字を除去 (Strip underscores on input field)
- テキストをレンダリングするときにテキストから下線文字を除去する場合は、このボックスを選択します。
- 入力フィールドのスペースをトリム
- 入力フィールドから先行および後続のスペースをトリムするには、このボックスを選択します。
- 入力フィールドのカーソル位置オプションを使用可能にする Web のみ
- このボックスを選択して、ユーザーが入力フィールドでデータ入力モードからカーソル位置決めモードに切り替えができるようにします。データ入力モードのときは、ユーザーは入力フィールドにデータを入力できます。カーソル位置決めモードのときは、タブ移動または別の方法で、入力フィールドの任意の文字上にカーソルを配置できます。この設定は他のカーソル位置決め機能を持たないモバイル装置用に最適化されている Web プロジェクトでは便利です。HATS Toolkit
GUI に表示されないこのオプションの他の設定のついては、モバイル装置に関する考慮事項および制約事項を参照してください。
- 前景色を使用可能にする
- これを選択した場合、ホスト画面の前景色がレンダリングされます。
Web アプリケーションの場合は、前景色はその色を表す CSS スタイルシート・クラスにマップされます。例えば、ホスト画面フィールドが RED とマークされている場合、フィールド・ウィジェットは、そのフィールド用に生成された HTML を、クラス名属性が HRED に設定されているタグで囲みます。この処理によって、ユーザーは、生成される Web ページ上にホスト画面の色を再マップすることができます。
注:
blacktheme.css は、ホスト画面フィールドの前景色を直接マップします (例えば、ホスト画面上の赤色のテキストは、生成された Web ページ上で赤色のテキストとして表示されます)。ただし、monochrome.css などの他のスタイルシート・ファイルは、フィールドの色を別の方法でマップし、一貫性のある、最新のスタイルを作成しようとします。
リッチ・クライアント・アプリケーションの場合、色はリッチ・クライアント・テンプレートによってマップされます。
注:
この設定は、「色のオーバーライド」>「前景色」の設定によってオーバーライドされます。
- 拡張属性を使用可能にする
- これを選択した場合、拡張フィールド属性 (明滅、反転表示、下線、および列分離子) が表示されます。また、3270 Web アプリケーションの場合、拡張フィールドの色もマップされます (詳細については、前の設定を参照してください)。詳細については、スタイル・シートの使用を参照してください。
リッチ・クライアント・アプリケーションの場合、拡張フィールド属性はリッチ・クライアント・テンプレートによってマップされます。
- 明滅スタイル Web のみ
- ホスト画面における明滅テキストのレンダリングに使用する CSS スタイル設定。
- 反転表示スタイル (Reverse video style) Web のみ
- ホスト画面における反転表示テキストのレンダリングに使用する CSS スタイル設定。
- 下線スタイル (Underline style) Web のみ
- ホスト画面における下線付きテキストのレンダリングに使用する CSS スタイル設定。
- 列分離子スタイル (Column separator style) Web のみ
- ホスト画面における列分離子のレンダリングに使用する CSS スタイル設定。
- スプレッドシート・ファイルの提供
- これを選択した場合、テーブル・データをスプレッドシート・ファイル・フォーマットで取得するためのランチャーが表示されます。
注:
画面組み合わせのレンダリングではこの機能はサポートされていません。
- ファイル名の接頭部
- スプレッドシート・ファイル名の接頭部を指定します。デフォルトは spreadsheet です。完全なファイル名の形式は FileNamePrefix_TimeStamp です。タイム・スタンプの形式は MMDDYY_HHMMSS (例: spreadsheet_041506_113020) です。
- 拡張子名
- スプレッドシート・フォーマット・タイプの拡張子名。オプションは .csv および .xls です。.csv ファイルは、データ列がコンマによって区切られている完全なテキスト・ファイルです。.xls ファイルは、Microsoft® Excel Biff3 ファイルです。デフォルトは .csv です。
- ランチャー・タイプ
- ユーザーに対して表示されるランチャーのタイプ。オプションは、「リンク」、「イメージ」、および「ボタン」です。デフォルトは、「リンク」(Web プロジェクト) または「ボタン」(リッチ・クライアント プロジェクト) です。
- ランチャーの表題
- ユーザーに対して表示されるランチャーの表題。デフォルトは、「スプレッドシート・ファイルのダウンロード (download spreadsheet file)」(Web プロジェクト) または「エクスポート」(リッチ・クライアント・プロジェクト) です。
- ボタンのスタイル・クラス Web のみ
- 生成されるランチャー・ボタンに関連する CSS スタイル・クラスです。HTML ボタン・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSBUTTON です。詳細については、スタイル・シートの使用を参照してください。
- リンクのスタイル・クラス Web のみ
- オプションです。生成されるランチャー・リンクに関連する CSS スタイル・クラスです。HTML リンク・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSLINK です。詳細については、スタイル・シートの使用を参照してください。
- テーブルのスタイル・クラス Web のみ
- オプションです。生成されるテーブルに関連する CSS スタイル・クラスです。HTML テーブル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLE です。詳細については、スタイル・シートの使用を参照してください。
- テーブル・セルのスタイル・クラス Web のみ
- オプションです。生成されるテーブル内の各セルに関連する CSS スタイル・クラスです。HTML テーブル・セル (td) タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLECELL です。詳細については、スタイル・シートの使用を参照してください。
- 見出し行のスタイル・クラス Web のみ
- オプションです。生成されるテーブル内の各ヘッダー行または列に関連する CSS スタイル・クラスです。HTML テーブルの行またはセル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLEHEADER です。詳細については、スタイル・シートの使用を参照してください。
- 奇数行のスタイル・クラス Web のみ
- オプションです。テーブル内の奇数番の各行に関連する CSS スタイル・クラスです。奇数番号行の各 HTML テーブル行タグのクラス属性値には、この値がセットされます。デフォルト値は HATSTABLEODDROW です。詳細については、スタイル・シートの使用を参照してください。
- 偶数行のスタイル・クラス Web のみ
- オプションです。テーブル内の偶数番の各行に関連する CSS スタイル・クラスです。偶数番号行の各 HTML テーブル行タグのクラス属性値には、この値がセットされます。デフォルト値は HATSTABLEEVENROW です。詳細については、スタイル・シートの使用を参照してください。
- スタイル Web のみ
- オプションです。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
- 色のオーバーライド RCP のみ
- 前景色と背景色を指定変更する場合は、このオプションを選択して、提供されている「前景色」と「背景色」の設定コントロールを使用します。
注:
リッチ・クライアント・プロジェクトでは、このウィジェットの各種色設定が次の順序 (最も高い優先度から低い優先度への順序) で適用されます。
- 強調表示された行/列
- 色のオーバーライド
- 拡張属性を使用可能にする/前景色を使用可能にする
- 行の代替色の表示
__________________________________________________________________________
テキスト入力
テキスト入力・ウィジェットは、HTML 入力フィールドのレンダリングを担当します。
このウィジェットは、以下のコンポーネントが提供するデータをレンダリングします。
注:
このウィジェットを使用する際の DBCS に関する考慮事項については、
SBCS での最大長の除去を参照してください。
次の図に、変換においてヒント付き入力フィールドコンポーネントの例のデータを入力として使用するテキスト入力・ウィジェットの表示例を示します。
- 表題 (コンポーネントから)
以下の設定が、このウィジェットに対して構成できます。
- サイズをオーバーライド
- これを選択した場合、指定したサイズ値が生成された各入力フィールドに設定されます。この設定は、大きなホスト入力フィールドのサイズを視覚的に変更する場合に便利です。クリアした場合、入力フィールドのサイズは認識する側のコンポーネントによって決定されます。
- サイズ
- 各入力フィールドのサイズ。
注:
この値はブラウザーによって解釈されます (入力フィールドが、別のブラウザー上でどのようにレンダリングされるかは、保証されません)。
- 最大長をオーバーライド
- これを選択した場合、各生成入力フィールドに指定された最大長の値が設定されます。この設定は、入力フィールドに入力可能な文字数を手動で制限する場合に便利です。クリアした場合は、入力文字の最大許容数は、認識する側のコンポーネントによって決定されます。
- 最大長
- 各入力フィールドに入力可能な最大文字数です。
- 表題ソース (Caption source)
- 生成される入力フィールドの表題を決定する方法を指定します。オプション: 「コンポーネントから」 (コンポーネントから取り出した表題を使用) または「カスタム」(指定された表題を使用)。
- カスタム表題
- オプションです。入力フィールドの表題を指定します。
注:
チェック・ボックスの表題を生成しない場合は、この設定をブランクのままにしてください。
- 1 行あたりの列数
- 次の行に折り返されるまでに、水平方向に表示される入力フィールドの数です。
注:
- この設定はデフォルト・レンダリングでは適用されません。
- ウィジェットのプレビューは必ずしも全ページのプレビューと一致するとは限りません。これはウィジェットのプレビューが単にコンポーネントの出力をレンダリングしているだけであるために起こります。ウィジェットのプレビューは、全ページのプレビューで行われているように、レンダリングしたときに画面の配置を保存しようとはしません。
- 読み取り専用
- これを選択した場合、レンダリングされた入力フィールドは読み取り専用になります。読み取り専用の入力フィールドは通常の入力フィールドのように表示されますが、ユーザーはこのフィールドの内容を変更できません。これは、無保護フィールドの内容をユーザーに対して表示するが、ユーザーがフィールドの内容を変更できないようにする場合に便利です。
- 入力フィールドの下線文字を除去 (Strip underscores on input field)
- テキストをレンダリングするときにテキストから下線文字を除去する場合は、このボックスを選択します。
- 入力フィールドのスペースをトリム
- 入力フィールドから先行および後続のスペースをトリムする場合は、このボックスを選択します。
- 入力フィールドのカーソル位置オプションを使用可能にする Web のみ
- このボックスを選択して、ユーザーが入力フィールドでデータ入力モードからカーソル位置決めモードに切り替えができるようにします。データ入力モードのときは、ユーザーは入力フィールドにデータを入力できます。カーソル位置決めモードのときは、タブ移動または別の方法で、入力フィールドの任意の文字上にカーソルを配置できます。この設定は他のカーソル位置決め機能を持たないモバイル装置用に最適化されている Web プロジェクトでは便利です。HATS Toolkit
GUI に表示されないこのオプションの他の設定のついては、モバイル装置に関する考慮事項および制約事項を参照してください。
- 前景色を使用可能にする
- これを選択した場合、ホスト画面の前景色がレンダリングされます。
Web アプリケーションの場合は、前景色はその色を表す CSS スタイルシート・クラスにマップされます。例えば、ホスト画面フィールドが RED とマークされている場合、フィールド・ウィジェットは、そのフィールド用に生成された HTML を、クラス名属性が HRED に設定されているタグで囲みます。この処理によって、ユーザーは、生成される Web ページ上にホスト画面の色を再マップすることができます。
注:
blacktheme.css は、ホスト画面フィールドの前景色を直接マップします (例えば、ホスト画面上の赤色のテキストは、生成された Web ページ上で赤色のテキストとして表示されます)。ただし、monochrome.css などの他のスタイルシート・ファイルは、フィールドの色を別の方法でマップし、一貫性のある、最新のスタイルを作成しようとします。
リッチ・クライアント・アプリケーションの場合、色はリッチ・クライアント・テンプレートによってマップされます。
注:
この設定は、「色のオーバーライド」>「前景色」の設定によってオーバーライドされます。
- 3270 数値ロックを有効にする
- 選択されている場合、ユーザーは、0 から 9 までの数字、正符号、負符号、ピリオド、コンマ、およびヒンディ数字のみを、3270 数値フィールドに入力できます。クリアされている場合、任意の文字を入力できます。デフォルトではクリアされています。
注:
Web アプリケーションの場合、必要に応じて lxgwfunctions.js ファイル の allowNumLockOnly() 関数および allowNumLockOnlyForIEMobile() 関数で文字コード値を使用して、受け入れられるキーのリストをカスタマイズできます。
- 拡張属性を使用可能にする
- これを選択した場合、拡張フィールド属性 (明滅、反転表示、下線、および列分離子) が表示されます。また、3270 Web アプリケーションの場合、拡張フィールドの色もマップされます (詳細については、前の設定を参照してください)。詳細については、スタイル・シートの使用を参照してください。
リッチ・クライアント・アプリケーションの場合、拡張フィールド属性はリッチ・クライアント・テンプレートによってマップされます。
- 明滅スタイル Web のみ
- ホスト画面における明滅テキストのレンダリングに使用する CSS スタイル設定。
- 反転表示スタイル (Reverse video style) Web のみ
- ホスト画面における反転表示テキストのレンダリングに使用する CSS スタイル設定。
- 下線スタイル (Underline style) Web のみ
- ホスト画面における下線付きテキストのレンダリングに使用する CSS スタイル設定。
- 列分離子スタイル (Column separator style) Web のみ
- ホスト画面における列分離子のレンダリングに使用する CSS スタイル設定。
- 入力フィールドのスタイル・クラス Web のみ
- オプションです。生成される入力フィールドに関連する CSS スタイル・クラスです。HTML 入力タグの class 属性の値には、この値がセットされます。デフォルト値は HATSINPUT です。詳細については、スタイル・シートの使用を参照してください。
- 表題のスタイル・クラス Web のみ
- オプションです。生成される入力フィールドの表題に関連する CSS スタイル・クラスです。デフォルト値は HATSCAPTION です。詳細については、スタイル・シートの使用を参照してください。
- テーブルのスタイル・クラス Web のみ
- オプションです。生成されるテーブルに関連する CSS スタイル・クラスです。入力フィールドが複数レンダリングされる場合、1 つの HTML テーブルが生成され、それらのフィールドを囲みます。HTML テーブル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLE です。詳細については、スタイル・シートの使用を参照してください。
- スタイル Web のみ
- オプションです。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳細については、スタイル・シートの使用を参照してください。
- フォントのオーバーライド RCP のみ
- デフォルトのフォント名、フォント・スタイル、フォント・サイズを指定変更する場合は、このオプションを選択して、提供されている「フォント」設定コントロールを使用します。
- 色のオーバーライド RCP のみ
- 前景色と背景色を指定変更する場合は、このオプションを選択して、提供されている「前景色」と「背景色」の設定コントロールを使用します。
__________________________________________________________________________
ツールバー・ウィジェットにより、ファンクション・キーと選択リスト項目をツールバー上のボタンとしてレンダリングできます。これらの項目は、「変換」ビューのメイン・ツールバーまたはスタンドアロン・ツールバーのいずれかにレンダリングできます。これは、パネル上にセクションを作成する場合、および特定のセクションにツールバーを提供する場合に便利です。「変換」ビューのツールバーに項目をレンダリングする場合は、ボタンのスタイル (テキスト、イメージ、またはテキストとイメージの両方) はプロジェクト・レベルのツールバー設定によって決まります。プロジェクト・レベルのツールバー設定の詳細については、ツールバー RCP のみ を参照してください。スタンドアロン・ツールバーに項目をレンダリングする場合は、このウィジェットの設定を使用してツールバーのスタイルを制御します。
このウィジェットは、以下のコンポーネントが提供するデータをレンダリングします。
次の図に、ファンクション・キー・コンポーネントのデータを入力として使用してツールバー・ウィジェットが「変換」ビュー・ツールバーで表示される例を示します。
- メイン・ツールバーへの項目の提供
- ツールバー項目の表示形式 (テキストおよびイメージ)
注:
この設定 (ツールバー項目の表示形式) は、プロジェクト設定エディターの「レンダリング」タブの「ツールバー」メイン設定で構成されます。この値は、ツールバー・ウィジェットに対して「メイン・ツールバーへの項目の提供」が選択されている場合に適用されます。
- 表題のタイプ (説明を表示)
以下の設定が、このウィジェットに対して構成できます。
- メイン・ツールバーへの項目の提供
- 「変換」ビューのメイン・ツールバーに項目をレンダリングするには、このボックスを選択します。これを選択した場合、プロジェクト設定エディターの「レンダリング」タブのプロジェクト・レベルの「ツールバー」設定に基づいてツールバー項目がレンダリングされます。例えば、このウィジェットに対して「単一のツールバー項目の下に項目をレンダリング」設定が選択されている場合は、プロジェクト・レベルの「ツールバー項目の表示形式」設定により許可されている場合にのみ、その「表題」および「イメージ」設定が適用されます。詳しくは、ツールバー RCP のみ を参照してください。
スタンドアロン・ツールバーの項目をレンダリングするには、このボックスをクリアします。このオプションを使用する場合は、次に説明する「項目の表示方法」設定を使用して項目のレンダリング方法を制御します。
- 項目の表示方法
- スタンドアロン・ツールバーの項目をレンダリングする場合は、この設定を使用して各項目の表示方法を制御します。各項目の表示オプションは、「テキスト」、「イメージ」、または「テキストとイメージの両方」です。
- 単一のツールバー項目の下に項目をレンダリング
- このウィジェットによりレンダリングされるすべての項目を、ツールバー上の 1 つの項目の下のメニュー項目として表示することを指定するには、このボックスを選択します。
- 表題
- 単一ツールバー項目に使用するテキスト表題を指定します。「メイン・ツールバーへの項目の提供」設定によっては、プロジェクト・レベルの「ツールバー項目の表示形式」設定またはウィジェット・レベルの「項目の表示形式」設定が「イメージ」に設定されている場合に、この設定が無効になることがあります。詳しくは、上記の「メイン・ツールバーへの項目の提供」設定の説明を参照してください。デフォルトは 「アクション」です。
- イメージ
- 単一ツールバー項目に使用するイメージを指定します。ドロップダウンからイメージを選択するか、または「インポート」ボタンを使用してイメージをインポートします。「メイン・ツールバーへの項目の提供」設定によっては、プロジェクト・レベルの「ツールバー項目の表示方法」設定またはウィジェット・レベルの「項目の表示形式」設定が「テキスト」に設定されている場合に、この設定が無効になることがあります。詳しくは、上記の「メイン・ツールバーへの項目の提供」設定の説明を参照してください。
- 表題のタイプ
- この設定を使用して、各項目に表示されるテキスト表題を制御します。「項目の表示方法」が「イメージ」に設定されている場合は、この設定は無効です。オプションは「先行トークンを表示」、「説明を表示」、または「両方を表示」です。例えば、ホスト・テキストが F3=Exit の場合、「先行トークンを表示」を指定すると F3 が表示され、「説明を表示」を指定すると Exit が表示され、「両方を表示」を指定すると F3=Exit が表示されます。
- 吹き出しヘルプのソース
- ツールバーの項目の上に移動するとツールチップとして表示されるテキストの内容を制御します。オプションは「先行トークンを表示」、「説明を表示」、または「両方を表示」です。例えば、ホスト・テキストが F3=Exit の場合、「先行トークンを表示」を指定すると F3 が表示され、「説明を表示」を指定すると Exit が表示され、「両方を表示」を指定すると F3=Exit が表示されます。
- プロジェクト・レベル・イメージ・マッピングの使用
- ツールバーの項目に表示するイメージを、プロジェクト・レベルのイメージ・マッピングで検索することを指定するには、このボックスを選択します。最初にコンポーネント・レベルまたはデフォルト・レンダリング・レベルのマッピングが検索された後で、プロジェクト・レベル・マッピングが検索されます。
- プロジェクト・レベルのイメージ・マッピング
- ツールバーの項目でイメージをレンダリングする場合は、ファンクション・キーまたは選択リストのソース・テキストを特定のイメージにマップできます。例えば、ファンクション・キーのソース・テキスト F3=Exit を、先行トークン (F3)、説明 (Exit)、または完全な表題 (F3=Exit) のいずれかに基づくイメージにマップできます。他のウィジェット設定とは異なり、この設定ではプロジェクト設定エディターでプロジェクト・レベルのイメージ・マップを構成し、これらのマッピングをコンポーネント・レベルまたはデフォルト・レンダリング・レベルで (単なる上書きではなく) 拡張できます。これにより、汎用のプロジェクト・レベルのマッピングを構成し、コンポーネント・レベルまたはデフォルトのレンダリング・レベルで小規模な変更を行うことができます。
「追加」ボタンを使用して、新規マッピングを追加します。次のように設定されている「条件を追加」ダイアログが表示されます。
- テキスト
- ファンクション・キーまたは選択リストのソース・テキストのどの部分で、「値」フィールドに指定された値を検索するかを定義します。オプションは「先行トークン」、「説明」、または「両方」です。例えば、ソース・テキストが F3=Exit である場合は、「値」フィールドに指定された値と一致するものを検索するときに、「先行トークン」 を指定すると F3 が検索され、「説明」を指定すると Exit が検索され、「両方」を指定すると F3=Exit が検索されます。
- 演算子
- 「値」フィールドに指定された値を「テキスト」フィールドで定義されているテキストで検索するときに、一致として見なされる条件を定義します。オプションは、「含む」または「等しい」です。「含む」では、テキスト内の任意の位置で値が検出された場合に一致とみなされます。この場合、検索では大文字と小文字は区別されません。「等しい」では、テキストが値と同等である場合にのみ一致とみなされます。この場合、検索では大文字と小文字が区別されます。
- 値
- 「テキスト」フィールドで定義されるテキスト内で検索する値を定義します。複数の値を指定するには、縦線 (|) 記号で区切ります (例: Exit|Quit|Leave)。
- イメージ
- 一致が検出された場合に使用するイメージを定義します。ドロップダウン・リストからイメージを選択するか、または「インポート」ボタンをクリックしてイメージをインポートします。
- プレビュー
- 選択したイメージのビューを表示します。
イメージ・マッピングをさらに定義する場合は、「編集」、「除去」、「上へ」、および「下へ」ボタンを使用します。
注:
ツールバー・ウィジェットが使用するイメージを判別する前に、テキスト置換が実行されます。定義するマッピングでは、テキスト置換により項目の先行トークン、説明、またはこの両方が変更されている可能性があることを前提とする必要があります。
- defaultImage
- イメージが特定のファンクション・キーまたは選択リスト項目にマップされない場合に、この設定を使用して、使用するデフォルト・イメージを指定します。
注:
GUI では、この設定は構成可能な設定として示されません。ツールバー・ウィジェット設定のソースで設定する必要があります。例えば、デフォルトとして、details.gif イメージをプロジェクトの「リッチ・クライアント・コンテンツ/イメージ」フォルダーで使用する場合、以下のいずれかを行います。
プロジェクト・レベルでデフォルトを指定するには、「HATS プロジェクト」ビューのプロジェクト・フォルダーの「プロジェクト設定」ファイルをダブルクリックし、application.hap ファイルのエディターを起動します。「ソース」タブで、<classSettings> タグの中のクラス name="com.ibm.hats.rcp.transform.widgets.SwtToolbarWidget" を見つけ、defaultImage の設定を<setting name="defaultImage" value="images/details.gif"/> に変更します。
変換の ComponentRendering コントロールのデフォルト・イメージを設定するには、ComponentRendering オブジェクトの setWidgetSettings メソッドに渡された defaultImage ストリングを更新します。 例えば、defaultImage: を defaultImage:images/details.gif に変更します。
別のプラグインに含まれているイメージを使用するには、そのプラグイン内のイメージへの絶対パスを指定します。例えば、defaultImage: を defaultImage:org.eclipse.ui/icons/full/obj16/delete_obj.gif に変更します。
コンポーネントおよびウィジェットのマッピング
GUI でホスト・コンポーネントを表示するときに使用される HATS Toolkit のウィジェットは、それぞれのコンポーネントにマップされています。次の表は、既存の HATS ホスト・コンポーネントおよび対応ウィジェットのリストです。
表 2. HATS ホスト・コンポーネントおよび対応するウィジェット
| ホスト・コンポーネント |
ウィジェット |
|
コマンド行
|
コンボ RCP のみ
ドロップダウン (データ入力)
リスト
ポップアップ
ラジオ・ボタン (データ入力)
テキスト入力
|
|
フィールド
|
フィールド
|
|
ファンクション・キー
|
ボタン
ボタン・テーブル
ドロップダウン (選択)
リンク
ラジオ・ボタン (選択)
ツールバー RCP のみ
|
|
HTML DDS キーワード
|
ラベル
|
|
入力フィールド
|
カレンダー Web のみ
チェック・ボックス
コンボ RCP のみ
ドロップダウン (データ入力)
リスト
ポップアップ
ラジオ・ボタン (データ入力)
テキスト入力
|
|
ヒント付き入力フィールド
|
コンボ RCP のみ
ドロップダウン (データ入力)
リスト
ポップアップ
ラジオ・ボタン (データ入力)
|
|
項目の選択
|
チェック・ボックス
コンボ RCP のみ
ドロップダウン (データ入力)
リンク (項目選択)
リスト
ポップアップ
ラジオ・ボタン (項目選択)
テキスト入力
|
|
ライト・ペン (アテンション)
|
ボタン
リンク
ラジオ・ボタン (選択)
|
|
ライト・ペン (選択)
|
チェック・ボックス
|
|
スクロール・バー・フィールド (ENPTUI)
|
スクロール・バー (ENPTUI)
|
|
選択フィールド (ENPTUI)
|
ボタン
チェック・ボックス
リンク
ラジオ・ボタン (選択)
|
|
選択リスト
|
ボタン
ボタン・テーブル
ドロップダウン (選択)
リンク
ラジオ・ボタン (選択)
ツールバー RCP のみ
|
|
サブファイル
|
サブファイル (チェック・ボックス)
サブファイル (ドロップダウン)
サブファイル (ポップアップ)
|
|
テーブル
|
グラフ (水平棒)
グラフ (線)
グラフ (垂直棒)
テーブル
|
|
テーブル (フィールド)
|
グラフ (水平棒)
グラフ (線)
グラフ (垂直棒)
テーブル
|
|
テーブル (可視)
|
グラフ (水平棒)
グラフ (線)
グラフ (垂直棒)
テーブル
|
|
テキスト
|
ラベル
|
|
URL
|
リンク
|