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 文字に置換されたストリングを戻します。パラメーターには以下のものがあります。

ExpandLamAlef
public String ExpandLamAlef(String input,boolean direction)

Lam Alef 文字が Lam とその後に続く 1 つの Alef 文字に置換されたストリングを戻します。パラメーターには以下のものがあります。

setNumerals
public void setNumerals(String NumShape)

出力バッファーの数表示形状を設定します。必要なパラメーターは以下のとおりです。

setSymSwap
public void setSymSwap (boolean on)

ビジュアル RTL の方向で対称スワッピング・オプションを設定します。必要なパラメーターは on のみです。true の場合は、対称スワッピングを使用した RTL 画面での文字のスワッピングが可能になります。false の場合は (デフォルト)、RTL 画面での文字のスワッピングに対称スワッピングは使用できません。

ShapeArabicData
public String ShapeArabicData(String strInBuffer,boolean isLTRVisual, boolean EnableNumSwap)

アラビア語データが形状決定されたストリングを戻します。パラメーターには以下のものがあります。

DeshapeArabicData
public String DeshapeArabicData (String strInBuffer,boolean isLTRVisual,boolean EnableNumSwap)

アラビア語データが形状決定解除されたストリングを戻します。パラメーターには以下のものがあります。

ConvertLogicalToVisual
public java.lang.String ConvertLogicalToVisual(java.lang.String inputBuffer, boolean isLTRimplicit,
boolean isLTRVisual)

規定のストリングを暗黙的なフォーマットからビジュアルに変換し、ストリングのビジュアル・フォーマットを戻します。パラメーターには以下のものがあります。

ConvertVisualToLogical
public java.lang.String ConvertVisualToLogical(java.lang.String inputBuffer, boolean isLTRVisual,
boolean isLTRimplicit)

規定のストリングをビジュアルから暗黙的なフォーマットに変換し、ストリングの暗黙的なフォーマットを戻します。パラメーターには以下のものがあります。