JavaTM Platform
Standard Ed. 6

パッケージ java.awt.im.spi

あらゆる Java 実行時環境で使用できるインプットメソッドの開発を可能にするインタフェースを提供します。

参照先:
          説明

インタフェースの概要
InputMethod 複合テキスト入力をサポートするインプットメソッドのためのインタフェースを定義します。
InputMethodContext インプットメソッドが、そのクライアントコンポーネントとの通信またはほかのサービスの要求のために使用できるメソッドを提供します。
InputMethodDescriptor インプットメソッドの選択およびロードを可能にするために、そのインプットメソッドに関する十分な情報を提供するメソッドを定義します。
 

パッケージ java.awt.im.spi の説明

あらゆる Java 実行時環境で使用できるインプットメソッドの開発を可能にするインタフェースを提供します。インプットメソッドは、ユーザーがテキストを単にキーボード上でタイプする以外の方法でテキストを入力できるソフトウェアコンポーネントです。数千種類もの文字を使う日本語、中国語、韓国語を、キーボードのそれよりはるかに少ないキーで入力する場合に、共通してこのインプットメソッドを使用します。このパッケージを使用すると、ほかの言語用のインプットメソッドや、手書き認識などのまったく異なる入力機構の使用も可能になります。

パッケージの仕様

インプットメソッドパッケージ

 

インプットメソッドは「拡張機構」の指定に従って、インストールされた拡張機能としてパッケージされます。インプットメソッドのメインの JAR ファイルには次のファイルが必要です。

    META-INF/services/java.awt.im.spi.InputMethodDescriptor
 

ファイルには、java.awt.im.spi.InputMethodDescriptor インタフェースを実装するクラスの完全指定クラス名が、1 行に 1 つ含まれている必要があります。それぞれの名前を囲む空白文字とタブ文字、および空白行は無視されます。コメント文字は「#」(\u0023) で、行の最初のコメント文字に続く文字はすべて無視されます。ファイルは UTF-8 で符号化されている必要があります。

 

たとえば、Foo インプットメソッドの java.awt.im.spi.InputMethodDesciptor を実装するクラスの完全修飾名が com.sun.ime.FooInputMethodDescriptor の場合、ファイル META-INF/services/java.awt.im.spi.InputMethodDescriptor には次の行が含まれます。

    com.sun.ime.FooInputMethodDescriptor
 

インプットメソッドは少なくとも次の 2 つのクラスを提供する必要があります。java.awt.im.spi.InputMethodDescriptor インタフェースを実装するクラスと、java.awt.im.spi.InputMethod インタフェースを実装するクラスです。インプットメソッドは、InputMethod を実装するクラスのロードを実際に必要になるまで延期できるように、これらの 2 つの実装を区別する必要があります。

インプットメソッドのロード

 

インプットメソッドのフレームワークは、通常、インプットメソッドクラスのロードが絶対的に必要になるまで保留します。AWT の初期化中には InputMethodDescriptor 実装のみをロードします。InputMethod 実装はインプットメソッドが選択されたときにロードします。

Java インプットメソッドおよびピアテキストコンポーネント

 

Java インプットメソッドフレームワークは、インプットメソッド (ホストインプットメソッドおよび Java インプットメソッド) とコンポーネント (ピアと軽量) のすべての組み合わせをサポートすることを意図しています。しかし、基礎になるプラットフォームに制限があるため、Java インプットメソッドとピア AWT コンポーネントの間の交信が必ずできるわけではありません。したがって、この特定の組み合わせのサポートはプラットフォームに依存します。Sun の Java SE 実行時環境では、この組み合わせは Windows ではサポートされていますが、Solaris ではサポートされていません。

関連ドキュメント

 

概要、チュートリアル、例、ガイド、およびツールのマニュアルについては、以下を参照してください。

導入されたバージョン:
JDK1.3

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。