名称

XSupportsLocale, XSetLocaleModifiers − ロケールサポートを決定、ロケールモディファイアを構成する

形式

Bool XSupportsLocale() char ∗XSetLocaleModifiers(modifier_list)
      char ∗modifier_list;

引数

modifier_listモディファイアを指定します。

解説

Xlib 関数がカレントロケールにおいて動作可の場合、 XSupportsLocale 関数は True を返します。 False を返す場合、 ステータスを返す XLocaleNotSupported が定義されている Xlib ロケール依存関数は XLocaleNotSupported を返します。 その他の Xlib ロケール依存ルーチンは “C” ロケールにて動作します。 XSetLocaleModifiers はカレントロケールセッティングに対して モディファイアを設定します。 modifier_list 引数は “{@category=value}” の形式のナル終了の文字列で、ゼロ、 または category が カテゴリ名で value がそのカテゴリに対する (空データ可) 設定である 連結された “@category=value” です。 その値はカレントロケールにおいてコード化されます。 カテゴリ名は POSIX ポータブルファイル名キャラクタセット に限定されます。 ローカルホストの X ローカルモディファイアアナウンサ (POSIX 依存システム上での、XMODIFIERS 環境変数) は、ローカスホスト上でデフォルト値を提供する modifier_list に加えられます。 指定カテゴリがリスト上に一回以上現われる場合、 リスト内の最初の設定が使用されます。 指定カテゴリが完全がモディファイリストに含まれない 場合、カテゴリはカレントロケールに対してインプリメンテーション 依存のデフォルトに設定されます。 カテゴリに対する空データはいインプリメンテーション 依存のデフォルトを明白に指定します。 関数が無事実行された場合、 文字列へのポインタを返します。 文字列の内容は同じ設定にモディファイアをリストアする 文字列（同じロケール）の次のコールとなります。 modifier_list がナルポインタの場合、 XSetLocaleModifiers は文字列に対するポインタを返し、 カレントロケールモディファイアは変更されません。 ロケールがサポートする一つ以上のモディファイアカテゴリ に対して無効な値が指定された場合、 ナルポインタが返され、どのカレントモディファイアも 変更されません。 プログラムスタート時、影響されるモディファイアは 最初のコールがあるまで指定されません。 ロケールがいつ変更されても、 影響されるモディファイアは次のコールが 成功するまで指定されません。 いずれかのロケール依存の Xlib ルーチンをコールする前に、 またロケールを設定した後に、 クライアントはナル以外の modifier_list で XSetLocaleModifiers をコールしなければなりません。 現在定義されている標準モディファイカテゴリは “im”であり、それは希望の入力方法を指定します。 入力方法に対する値は標準化されていません。 一つのロケールで複数の入力方法を使用でき、 ユーザ制御の入力方法を切り換えます。 モディファイアは有効な最初の入力方法 または入力方法のリストを指定します。 複数の入力方法はインプリメンテーション依存の方法によって、 一つの im 値文字列にて指定されます。 返されたモディファイア文字列は Xlib によって 所有され、クライアントによって変更、または開放されません。 カレントロケールまたはモディファイアが変更された後、 Xlib によって開放されます。 開放されるまで、Xlib によって変更されません。

関連事項

Xlib − C Language X Interface

NEWS-OSRelease 4.2.1R