QInputMethodEvent Class

詳細説明

入力メソッドイベントは、入力メソッドがウィジェットにテキストを入力するために使われたときに、ウィジェットに送られます。入力メソッドは、ラテン文字以外のアルファベットを持つ言語のテキスト入力に広く使用されています。

カスタム・テキスト編集ウィジェットを作成する場合、入力メソッド・イベントを受信するには、Qt::WA_InputMethodEnabled window 属性を明示的に設定する必要があることに注意してください（QWidget::setAttribute()関数を使用）。

このイベントは、複雑な文字入力を持つ言語を正しく扱えるようにしたいキーボード入力ウィジェットの作者にとって興味深いものです。このような言語のテキスト入力は、通常3つのステップで行われます：

1. 入力の開始

   ユーザーがキーボードの最初のキーを押すと、入力コンテキストが作成されます。この入力コンテキストには、入力された文字列が含まれます。

2. 作曲する

   新しいキーが押されるたびに、入力メソッドはこれまでに入力された文字列と一致する文字列を作成しようとします。入力コンテキストがアクティブになっている間、ユーザーはこの入力コンテキストに属する文字列の中でしかカーソルを動かすことができません。

3. 完了

   ある時点で、ユーザーは（おそらく特定のキーを使って）ユーザーインターフェイスコンポーネントをアクティブにし、そこで、これまでに入力したテキストに一致する文字列をいくつかの中から選ぶことができます。ユーザーは選択を確定するか、入力をキャンセルすることができます。どちらの場合でも、入力コンテキストは閉じられます。

QInputMethodEventはこれら3つの段階をモデル化し、中間結果を正しくレンダリングするために必要な情報を転送する。QInputMethodEventには、preeditString （）とcommitString （）の2つの主要なパラメータがある。preeditString() パラメータは、現在アクティブな編集前文字列を与えます。commitString() パラメータは、エディタ・ウィジェットのテキストに追加される（または、テキストの一部を置き換える）テキストを指定します。これは通常、入力操作の結果であり、編集前文字列の直前でウィジェットのテキストに挿入されなければなりません。

commitString()がエディタのテキストの一部を置き換える場合、replacementLength()には置き換えられる文字数が入ります。replacementStart() には、編集前文字列の先頭からの相対的な置換位置が入ります。

多くの属性は、編集前文字列の視覚的な外観を制御します（編集前文字列の外側のテキストの視覚的な外観は、ウィジェットによってのみ制御されます）。AttributeType enumは、設定可能なさまざまな属性を記述しています。

QWidget::inputMethodEvent() やQGraphicsItem::inputMethodEvent() を実装するクラスは、少なくともTextFormat とCursor 属性を理解し、尊重しなければなりません。

入力メソッドは、ウィジェットまたはグラフィック・アイテムから特定のプロパティを照会できる必要があるため、サブクラスは、それぞれQWidget::inputMethodQuery() とQGraphicsItem::inputMethodQuery() も実装する必要があります。

入力メソッド・イベントを受け取ると、テキスト・ウィジェットは以下のステップを実行しなければならない：

1. ウィジェットがテキストを選択している場合、選択されたテキストを削除する。
2. 長さreplacementLength()のreplacementStart()で始まるテキストを削除し、commitString()で置き換える。replacementLength() が 0 の場合、replacementStart() はcommitString() の挿入位置を示す。

   置換を行う際、編集前文字列の領域は無視されます。したがって、長さ 2 で -1 から始まる置換は、編集前文字列の前の最後の文字と後の最初の文字を削除し、コミット文字列を編集前文字列の直前に挿入します。

   ウィジェットがアンドゥ/リドゥを実装している場合、この操作はアンドゥスタックに追加されます。

3. 現在の編集前文字列がない場合は、現在のカーソル位置にpreeditString() を挿入します。そうでない場合は、前のpreeditString をこのイベントで受け取ったものに置き換えます。

   ウィジェットがアンドゥ/リドゥを実装している場合、preeditString （）は、アンドゥ/リドゥスタックにいかなる影響も及ぼすべきではない。

   ウィジェットは、編集前の文字列に適用する属性のリストを調べるべきである。少なくともTextFormat と Cursor 属性を理解し、指定された通りにレンダリングする必要があります。