クラスComponentOrientation

java.lang.Object
java.awt.ComponentOrientation
すべての実装されたインタフェース:
Serializable
public final class ComponentOrientation extends Object implements Serializable
ComponentOrientationクラスは、コンポーネントまたはテキストの各要素を言語に従って配置するための方向をカプセル化します。 西洋のアルファベット、ヘブライ語などの中東の言語、そして日本語などの極東の言語のそれぞれで異なる語順を反映するために使用します。

基本的に文字などのアイテムを一列に並べ、その列を並べてブロックを構成します。 これはたとえば、チェックボックス内にテキストとの相対位置を指定して配置されるボックスのような、ウィジェット内のアイテムにも適用されます。

現代の言葉で使用される配置は次に示すように4種類あります。
 

LT          RT          TL          TR
A B C       C B A       A D G       G D A
D E F       F E D       B E H       H E B
G H I       I H G       C F I       I F C

(ヘッダーの2文字の短縮形は最初の文字がアイテムの方向、次の文字が行の方向を表します。 たとえば、LTは「アイテムは左から右、行は上から下」を示し、TLは「アイテムは上から下、行は左から右」を表します。ほかも同様です。)

これらの記号は主に次の言語に使用されます。

  • LT - 西ヨーロッパ(日本語、中国語、韓国語でも使用)
  • RT - 中東(アラビア語、ヘブライ語)
  • TR - 日本語、中国語、韓国語
  • TL - モンゴル語
外見と制御コードが方向によって変わるコンポーネントではisLeftToRight()メソッドとisHorizontal()メソッドを使用して動作を決定します。 ただし次のように定数で動作を切り替えるコードは使用しないでください。 
if (orientation == LEFT_TO_RIGHT) {
  ...
} else if (orientation == RIGHT_TO_LEFT) {
  ...
} else {
  // Oops
}
定数は将来追加される可能性があり、方向オブジェクトも重複しない保証はないのでこれは安全な方法ではありません。

関連項目:

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    static final ComponentOrientation
    LEFT_TO_RIGHT
    アイテムは左から右に配置され、行は上から下に配置されます。英語、フランス語などがこれに該当します。
    static final ComponentOrientation
    RIGHT_TO_LEFT
    アイテムは右から左に配置され、行は上から下に配置されます。アラビア語、ヘブライ語などがこれに該当します。
    static final ComponentOrientation
    UNKNOWN
    コンポーネントの配置が設定されていないことを示します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    static ComponentOrientation
    getOrientation(Locale locale)
    措定されたロケールに対して適切な配置方向を返します。
    static ComponentOrientation
    getOrientation(ResourceBundle bdl)
    非推奨。
    J2SE 1.4から、getOrientation(java.util.Locale)を使用します。
    boolean
    isHorizontal()
    行が水平かどうかを返します。
    boolean
    isLeftToRight()
    水平行の場合、アイテムが左から右に配置されるかどうか

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

    • LEFT_TO_RIGHT

      public static final ComponentOrientation LEFT_TO_RIGHT
      アイテムは左から右に配置され、行は上から下に配置されます。英語、フランス語などがこれに該当します。

    • RIGHT_TO_LEFT

      public static final ComponentOrientation RIGHT_TO_LEFT
      アイテムは右から左に配置され、行は上から下に配置されます。アラビア語、ヘブライ語などがこれに該当します。

    • UNKNOWN

      public static final ComponentOrientation UNKNOWN
      コンポーネントの配置が設定されていないことを示します。 既存アプリケーションの動作を変えないようにするため、isLeftToRightがこの値に対してtrueを返します。

  • メソッドの詳細

    • isHorizontal

      public boolean isHorizontal()
      行が水平かどうかを返します。 ヨーロッパの言語のように、左から右に記述する言語の場合にはtrueを返します。
      戻り値:
      trueこの向きに水平線がある場合

    • isLeftToRight

      public boolean isLeftToRight()
      水平行の場合、アイテムが左から右に配置されるかどうか
      垂直行の場合、行が左から右に配置されるかどうか
      ヨーロッパの言語のように、左から右に記述する言語の場合にはtrueを返します。
      戻り値:
      この方向が左から右の場合はtrue

    • getOrientation

      public static ComponentOrientation getOrientation(Locale locale)
      措定されたロケールに対して適切な配置方向を返します。
      パラメータ:
      locale - 指定されたロケール
      戻り値:
      ロケールの方向

    • getOrientation

      @Deprecated public static ComponentOrientation getOrientation(ResourceBundle bdl)
      非推奨。
      J2SE 1.4から、getOrientation(java.util.Locale)を使用します。
      指定されたResourceBundleの地域に対して適切な配置方向を返します。 3つの方法が次の順番で試行されます。
      1. 文字列「Orientation」をキーとし、ResourceBundleからComponentOrientationオブジェクトを取得
      2. ResourceBundle.getLocaleを使用し、バンドルのロケールを決定し、そのロケールの配置方向を返す
      3. デフォルトのロケール配置方向を返す
      パラメータ:
      bdl - 使用するバンドル
      戻り値:
      オリエンテーション