サブファイル (チェック・ボックス)

サブファイル (チェック・ボックス) ウィジェットは、5250 サブファイルをレンダリングします。

このウィジェットは、サブファイル・コンポーネントが提供するデータをレンダリングします。

注: このウィジェットを使用する際の DBCS に関する考慮事項については、SBCS での最大長の除去を参照してください。
次の図に、変換においてサブファイル・コンポーネントの例データを入力として使用するサブファイル (チェック・ボックス) ウィジェットの表示例を示します。
図 1. サブファイル (チェック・ボックス) ウィジェットの例
サブファイル (チェック・ボックス) ウィジェットの例
  1. 表題のタイプ (両方を表示)
  2. アクション・タイプ (リンク)
  3. アクションの場所 (サブファイルの上)
  4. チェック・ボックス
以下の設定が、このウィジェットに対して構成できます。
表題のタイプ:
各チェック・ボックスの表題を決定する方法を指定します。コンポーネントから先行トークンの値および説明が取り込まれます。つまり、表題として表示する項目を選択できます。例えば、ホスト画面に「5. 表示」というアクションが存在する場合、表題表示として「5」「表示」、または「5. 表示」を選択できます。
アクション・タイプ
アクションをトリガーするために「ボタン」または「リンク」のいずれを使用するかを指定します。
アクションの場所
アクションをトリガーするボタンまたはリンクの位置を指定します。オプションは「サブファイルの上と下」「サブファイルの上」、および「サブファイルの下」です。
1 レコードあたりの行数 (Rows per record)
行数
サブファイル内の 1 レコードあたりの固定行数を指定します。
Columns placement (Web のみ)

This widget can be configured to display primary columns of data, and optionally to have a details section to view additional detail columns. This setting is useful when displaying table data on a mobile device. For more information about these settings and about other settings for this option that do not appear in the ZIETrans Toolkit GUI, see モバイル装置に関する考慮事項および制限.

Primary columns
Use this field to specify which columns to display, and in what order. The field allows for numeric any-order listing of column numbers with expansion shorthand, and columns are allowed to be displayed more than once or not at all, for example, 1,3,2,5-7,2-3,9.

A hyphen (-) between two numbers indicates a range of columns. You can use the asterisk character (*) to indicate the last available column. An asterisk alone means columns 1 through n where n is the last available column. You can also use 5* as a shorthand for 5-*. These mean the same thing: 1-*, *.

For Web projects, this setting defaults to *, or all columns. For Web projects optimized for mobile devices, this setting defaults to 1-2, or columns 1 and 2.

注: The numbers represent columns provided to the widget by the component. They do not represent the columns originally recognized by the component, which may or may not be excluded, before providing them to the widget.
Detail columns
Use this optional field to specify which detail columns to display when requested, and in what order. The field allows for numeric any-order listing with expansion shorthand.

For Web projects, this setting defaults to empty, or no detail columns section. For Web projects optimized for mobile devices, this setting defaults to 3*, or column 3 through the last column.

Keep detail columns on the server
Select this option to keep the detail columns section on the server until requested by the user. This reduces the amount of HTML output at initial rendering. The default is cleared.
前景色を有効にする
これを選択した場合、ホスト画面の前景色がレンダリングされます。
Web アプリケーションの場合は、前景色はその色を表す CSS スタイルシート・クラスにマップされます。例えば、ホスト画面フィールドが RED とマークされている場合、フィールド・ウィジェットは、そのフィールド用に生成された HTML を、クラス名属性が HRED に設定されているタグで囲みます。この処理によって、ユーザーは、生成される Web ページ上にホスト画面の色を再マップすることができます。
注: blacktheme.css は、ホスト画面フィールドの前景色を直接マップします (例えば、ホスト画面上の赤色のテキストは、生成された Web ページ上で赤色のテキストとして表示されます)。ただし、monochrome.css などの他のスタイルシート・ファイルは、フィールドの色を別の方法でマップし、一貫性のある、最新のスタイルを作成しようとします。
フィールドのスタイル・クラス (Web のみ)
オプション。生成されたフィールドに関連する CSS スタイル・クラスです。HTML タグの class 属性の値には、この値がセットされます。デフォルト値は HATSFIELD です。詳しくは、スタイル・シートの使用を参照してください。
拡張属性を使用可能にする
これを選択した場合、拡張フィールド属性 (明滅、反転表示、下線、および列分離子) が指定されたスタイルで表示されます。詳しくは、スタイル・シートの使用を参照してください。
明滅スタイル (Web のみ)
ホスト画面における明滅テキストのレンダリングに使用する CSS スタイル設定。
反転表示スタイル (Web のみ)
ホスト画面における反転表示テキストのレンダリングに使用する CSS スタイル設定。
[下線の種類] (Web のみ)
ホスト画面における下線付きテキストのレンダリングに使用する CSS スタイル設定。
列分離子スタイル (Web のみ)
ホスト画面における列分離子のレンダリングに使用する CSS スタイル設定。
入力フィールドの下線文字を除去
テキストをレンダリングするときにテキストから下線文字を除去する場合は、このボックスを選択します。
入力フィールドのスペースをトリム
入力フィールドから先行および後続のスペースをトリムするには、このボックスを選択します。
入力フィールドのカーソル位置オプションを使用可能にする (Web のみ)
ユーザーが入力フィールドについて、データ入力モードからカーソル位置決めモードへ切り替えることができるようにするには、このボックスを選択します。データ入力モードでは、ユーザーは入力フィールドにデータを入力できます。カーソル位置決めモードでは、ユーザーはタブまたはその他の方法により、入力フィールド内の任意の文字上にカーソルを置くことができます。この設定は、他のカーソル位置決め機能がないモバイル装置用に最適化された Web プロジェクトを使用する場合に役立ちます。ZIETrans Toolkit GUI に表示されないこのオプションの他の設定について詳しくは、モバイル装置に関する考慮事項および制限を参照してください。
Provide spreadsheet file
If selected, a launcher is provided that will retrieve the table data in spreadsheet file format.
File name prefix
Specifies a prefix for the spreadsheet file name. The default is spreadsheet. The complete file name will be in the form of FileNamePrefix_TimeStamp, where the timestamp format is MMDDYY_HHMMSS, for example, spreadsheet_041506_113020.
File name extension
The extension name for the type of spreadsheet format. Options are .csv and .xls. The .csv file are pure text files, with data columns separated by commas. The .xls files are Microsoft Excel Biff3 files. The default is .csv.
Launcher type
The type of launcher to display to the user. Options are Link, Image, and Button. The default is Link (Web projects).
Launcher caption
The caption for the launcher to display to the user. The default is Download (Web projects).
Button style class (Web のみ)
The CSS style class associated with the generated launcher button. The value of the class attribute of the HTML button tag will be set to this value. The default value is HATSBUTTON. See スタイル・シートの使用 for more information.
Link style class (Web のみ)
Optional. The CSS style class associated with the generated launcher link. The value of the class attribute of the HTML link tag will be set to this value. The default value is HATSLINK. See スタイル・シートの使用 for more information.
リンクのスタイル・クラス (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 です。詳しくは、スタイル・シートの使用を参照してください。
Style (Web のみ)
オプション。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳しくは、スタイル・シートの使用を参照してください。
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 ウィジェットの ZIETrans:Component タグを見つけ、次の例に示すように、設定値を NO_SEGMENTING に変更します。
...
widget="com.ibm.hats.transform.widgets.SubfileCheckboxWidget"
...
widgetSettings="...|fieldTextAlignment:NO_SEGMENTING|..."
...
この設定の値は、WORD_BY_WORD および NO_SEGMENTING です。デフォルト値は WORD_BY_WORD です。
注: サブファイル・コンポーネントでデータ認識に「テーブル (可視)」認識オプションを使用している場合、この設定は効果がありません。