HATS 双方向 API の使用
注:
グローバル変数のオーバーライド、ライト・ペン (アテンション) ホスト・コンポーネント、およびライト・ペン (選択) ホスト・コンポーネントでは、双方向言語はサポートされません。
双方向 (アラビア語またはヘブライ語) のコード・ページを使用する HATS アプリケーション
を作成し、ビジネス・ロジックの追加または独自のカスタム・コンポーネントやウィジェット
の作成を実行する場合は、双方向 API を使用して、リッチ・クライアント変換内のホスト・コンポーネントの認識とウィジェットの表示を処理することができます。この章では、この API について説明します。この章の資料を利用する前に、「HATS ユーザーと管理者のガイド」
で説明されている双方向の概念をよく理解しておく必要があります。
注:
VisualText コンポーネントについての資料が、トピック『SWT Bidi Extensions』の下の Rational® SDP ヘルプ内にあります。
データ変換 API
HostScreen クラスには、テキストをビジュアルから論理、もしくはその反対に変換するための API が 2 つ含まれています。データ抽出を処理するためにカスタム・ウィジェットおよびコンポーネントを作成する際に、これらの API を使用できます。
ConvertVisualToLogical
public java.lang.String ConvertVisualToLogical(java.lang.String inputBuffer,
boolean isleft-to-rightVisual,
boolean isleft-to-rightImplicit)
規定のストリングをビジュアルから暗黙的なフォーマットに変換し、ストリングの暗黙的なフォーマットを戻します。
- inputBuffer
- 入力ストリングは、ビジュアルのフォーマットです。
- isleft-to-rightVisual
- true の場合、inputBuffer はビジュアルの左から右の形式です。
- isleft-to-rightImplicit
- true の場合、出力バッファーは暗黙的な左から右の形式です。
ConvertLogicalToVisual
public java.lang.String ConvertLogicalToVisual(java.lang.String inputBuffer,
boolean isleft-to-rightImplicit,
boolean isleft-to-rightVisual)
規定のストリングを暗黙的なフォーマットからビジュアルに変換し、ストリングのビジュアル・フォーマットを戻します。
- inputBuffer
- 入力ストリングは、暗黙的なフォーマットです。
- isleft-to-rightImplicit
- true の場合、inputBuffer は暗黙的な左から右の形式です。
- isleft-to-rightVisual
- true の場合、出力バッファーはビジュアルの左から右の形式です。
グローバル変数 API
グローバル変数の値を取得するための getter メソッドが 2 つあります。これらのメソッドを使用して、暗黙的またはビジュア
ル・フォーマットでグローバル変数値を
取得できます。これらの 2 つのメソッドは、com.ibm.hats.common.BaseInfo クラスにあります。
getGlobalVariable
public IGlobalVariable getGlobalVariable(String name, boolean createIfNotExist,boolean
bidiImplicit)
名前付きのグローバル変数を取得します。まだ存在しない場合は、オプションで作成できます。
- createIfNotExist
- 存在しないグローバル変数を作成するかどうかを指定します。
- bidiImplicit
- true の場合は暗黙的なフォーマットで、false の場合はビジュアル・フォーマットでグローバル変数値を取得するかどうかを指定します。
getSharedGlobalVariable
public IGlobalVariable getSharedGlobalVariable(String name, boolean
createIfNotExist,boolean bidiImplicit)
名前付きの共用グローバル変数を取得します。まだ存在しない場合は、オプションで作成できます。
- createIfNotExist
- 存在しないグローバル変数を作成するかどうかを指定します。
- bidiImplicit
- true の場合は暗黙的なフォーマットで、false の場合はビジュアル・フォーマットでグローバル変数値を取得するかどうかを指定します。
BIDI OrderBean
双方向データを正しく表示するため、BIDI OrderBean のメソッドを使用できます。これには、次のパラメーターが含まれています。
- BidiString
- ストリング。双方向テキストが含まれています。
- FromTextVisual
- ブール値。ソース双方向テキストがビジュアルかどうかを示します。デフォルトは true です。
- FromOriLTR
- ブール値。ソース双方向テキストの方向が LTR かどうかを示します。デフォルトは true です。
- ToTextVisual
- ブール値。ターゲット双方向テキストがビジュアルかどうかを示します。デフォルトは true です。
- ToOriLTR
- ブール値。ターゲット双方向テキストの方向が LTR かどうかを示します。デフォルトは true です。
- NeedShape
- ブール値。双方向テキストがアラビア語テキストであるかどうかと、形状決定が必要かどうかを示します。デフォルトは false です。
- CharSet
- ストリング。JSP 用の文字のエンコードを定義します。
- NumShape
- ストリング。数表示形状メソッドを定義します。デフォルトは Nominal です。
- SymSwap
- ブール値。対称スワッピングがオンかどうかを示します。デフォルトは false です。
BIDI OrderBean メソッド
- setBidiString
- public void setBidiString (String BdString)
双方向テキストが所定のストリングに再配列されるように設定します。必要なパラメーターは BdString のみで、再配列が必要な双方向ストリングです。
- getBidiString
- public String getBidiString ()
双方向テキストを取得します。再配列する必要がある双方向ストリングを戻します。
- setFromTextVisual
- public void setFromTextVisual (boolean on)
ソース双方向テキスト・タイプをビジュアルとして設定します。必要なパラメーターは on のみです。true の場合は、ビジュアルとしてこのソース双方向テキストを定義します。false の場合は、暗黙としてこのソース双方向テキストを定義します。
- setFromOriLTR
- public void setfromOriLTR (boolean on)
ソース双方向テキストの方向を LTR として設定します。必要なパラメーターは on のみです。true の場合は、LTR としてこのソース双方向テキストを定義します。false の場合は、RTL としてこのソース双方向テキストを定義します。
- setToTextVisual
- public void setToTextVisual (boolean on)
ターゲット双方向テキスト・タイプをビジュアルとして設定します。必要なパラメーターは on のみです。true の場合は、ビジュアルとしてこのターゲット双方向テキストを定義します。false の場合は、暗黙としてこのターゲット双方向テキストを定義します。
- setToOriLTR
- public void setToOriLTR (boolean on)
ターゲット双方向テキストの方向を LTR として設定します。必要なパラメーターは on のみです。true の場合は、LTR としてこのターゲット双方向テキストを定義します。false の場合は、RTL としてこのターゲット双方向テキストを定義します。
- setEncoding
- public void setEncoding (String CharSet)
文字セットのエンコードを設定します。必要なパラメーターは CharSet のみで、文字エンコード名を示します。
- setNeedShape
- public void setNeedShape (boolean on)
形状決定を実行する必要があることを設定します。必要なパラメーターは on のみです。true の場合は、双方向テキストで形状決定を実行する必要があることを示します。
- Order
- public void Order ()
双方向テキストの配列を実行します。パラメーターはありません。
- CompressLamAlef
- public String CompressLamAlef(String input,boolean direction)
Lam 文字とその後に続く Alef 文字が LamAlef 1 文字に置換されたストリングを戻します。パラメーターには以下のものがあります。
- Direction: true の場合は、入力テキストがビジュアル・フォーマットであることを示します。false の場合は、入力テキストが暗黙のフォーマットであることを示します。
- Input: 圧縮される LamAlef 文字を含む入力ストリング。
- ExpandLamAlef
- public String ExpandLamAlef(String input,boolean direction)
Lam Alef 文字が Lam とその後に続く 1 つの Alef 文字に置換されたストリングを戻します。パラメーターには以下のものがあります。
- Direction: true の場合は、入力テキストがビジュアル・フォーマットであることを示します。false の場合は、入力テキストが暗黙のフォーマットであることを示します。
- Input: 展開される LamAlef 文字を含む入力ストリング。
- setNumerals
- public void setNumerals(String NumShape)
出力バッファーの数表示形状を設定します。必要なパラメーターは以下のとおりです。
- NumShape: 次の 3 つの値のいずれか 1 つを持つストリングです。
- NOMINAL: 数表示はラテン語の形式です。
- CONTEXTUAL: 数表示は数に従います。
- NATIONAL: 数表示は各国の形式です。
- Input: 展開される LamAlef 文字を含む入力ストリング。
- setSymSwap
- public void setSymSwap (boolean on)
ビジュアル RTL の方向で対称スワッピング・オプションを設定します。必要なパラメーターは on のみです。true の場合は、対称スワッピングを使用した RTL 画面での文字のスワッピングが可能になります。false の場合は (デフォルト)、RTL 画面での文字のスワッピングに対称スワッピングは使用できません。
- ShapeArabicData
- public String ShapeArabicData(String strInBuffer,boolean isLTRVisual,
boolean EnableNumSwap)
アラビア語データが形状決定されたストリングを戻します。パラメーターには以下のものがあります。
- strInBuffer: 形状決定が必要な双方向ストリング。
- isLTRVisual: 展開される LamAlef 文字を含む入力ストリング。true の場合は、双方向ストリングが左から右へビジュアルになります。false の場合は、双方向ストリングが右から左へビジュアルになります。
- EnableNumSwap: true の場合は、数値スワッピングが使用可能になります。false の場合は、数値スワッピングが使用不可になります。
- DeshapeArabicData
- public String DeshapeArabicData (String strInBuffer,boolean isLTRVisual,boolean
EnableNumSwap)
アラビア語データが形状決定解除されたストリングを戻します。パラメーターには以下のものがあります。
- strInBuffer: 形状決定解除が必要な双方向ストリング。
- isLTRVisual: true の場合は、双方向ストリングが左から右へビジュアルになります。false の場合は、双方向ストリングが右から左へビジュアルになります。
- EnableNumSwap: true の場合は、数値スワッピングが使用可能になります。false の場合は、数値スワッピングが使用不可になります。
- ConvertLogicalToVisual
- public java.lang.String ConvertLogicalToVisual(java.lang.String
inputBuffer, boolean isLTRimplicit,
boolean isLTRVisual)
規定のストリングを暗黙的なフォーマットからビジュアルに変換し、ストリングのビジュアル・フォーマットを戻します。パラメーターには以下のものがあります。
- InputBuffer: 入力ストリングは、暗黙的なフォーマットです。
- isLTRimplicit: true の場合、inputBuffer は暗黙的な左から右の形式です。
- isLTRVisual: true の場合、出力バッファーはビジュアルの左から右の形式です。
- ConvertVisualToLogical
- public java.lang.String ConvertVisualToLogical(java.lang.String
inputBuffer, boolean isLTRVisual,
boolean isLTRimplicit)
規定のストリングをビジュアルから暗黙的なフォーマットに変換し、ストリングの暗黙的なフォーマットを戻します。パラメーターには以下のものがあります。
- InputBuffer: 入力ストリングは、ビジュアルのフォーマットです。
- isLTRimplicit: true の場合、出力バッファーは暗黙的な左から右の形式です。
- isLTRVisual: true の場合、inputBuffer はビジュアルの左から右の形式です。