この手順では、新しいガジェットの作成方法、つまり IlvGadget クラスの直接サブクラスの作成方法を説明します。作成するガジェットは、3 つのガジェット、つまり、1 個のテキスト・フィールドおよび 2 つのボタンから構成される複合ガジェットです。UpDownField ガジェットは、次のように表示されます。

この手順では、次のタスクを実行する方法を紹介します。

複合ガジェットの作成とは、1 つ以上の既存のガジェットから構成される新しいガジェットを作成するということです。スクロール操作を可能にする内部 IlvScrollBar オブジェクトを有する IlvTreeGadget がこれに相当します。これはまた、この手順で作成される UpDownField クラスにもあてはまります。

UpDownField が構成されているオブジェクトへのポインターを維持するために、保護されたメンバー変数を使用します。

最初に、複合ガジェットを構成するオブジェクトを作成しなくてはなりません。UpDownField クラスは、クラスの各コンストラクターに呼び出される保護されたメンバー関数 init を持っています。

init メソッドはまず、全オブジェクトのバウンディング・ボックスを computeRects メンバー関数を呼び出して計算します。それから、オブジェクトを作成して初期化します。

以下に、UpDownField クラスのレイアウトを担当する computeRects メソッドの記述です。

このメソッドは、毎回複合ガジェットを移動、リサイズするたびに呼び出されます。すべてのグラフィック・オブジェクトと同様に、applyTransform メソッドはどちらのケースでも呼び出されます。

これはまた、コンポーネント・バウンディング・ボックスについて複合ガジェットに問い合わせを行うのにも使用されます。

以上で、複合ガジェットのコンポーネントが配置されました。複合ガジェットは、これらを各コンポーネントの draw メンバー関数を呼び出して描画します。

IlvGraphic クラスのいくつかのメンバー関数は、複合ガジェットのコンポーネントへの委譲を可能にするために再定義されています。setPalette メソッドを例として挙げます。

UpDownField のパレットが変更されると、UpDownField の各コンポーネントに同じパレットが設定されます。

最後に、setHolder メソッドを次のようにオーバーライドしなくてはなりません。

このメソッドは、UpDownField がホルダーに追加、あるいは削除されるたびに呼び出されます。これによって UpDownField のコンポーネントすべてが同じホルダーを持つようになります。ガジェットが適切に振る舞うためにはホルダーを必要とするため、これは必須です。

グラフィックおよびガジェット・クラスでのイベント処理の主な違いは、ガジェットはキーボード・フォーカスを持てるという点です。ガジェットがキーボード・フォーカスを持てば、キーボード・イベントはこのガジェットに送られるようになります。詳細は、ガジェットの理解にある「フォーカス管理」を参照してください。

キーボード・フォーカス処理には、次のような意味があります。

UpDownField の各コンポーネントにフォーカスを与えることができなくてはなりません。フォーカスが UpDownField に与えられると、それを送信するために選んだコンポーネントに転送されます。保護されたメンバー変数が、UpDownField の現在のフォーカス・コンポーネントにポインターを維持するために追加されます。

setFocus という名前のメソッドも、UpDownField 内の現在フォーカスされているオブジェクトを変更するために追加されます。

メソッドは最初に IlvKeyboardFocusOut イベントをキーボード・フォーカスを失うコンポーネントに送ります。それから、IlvKeyboardFocusIn イベントを新しくフォーカスされたコンポーネントに送ります。最後に、変更された領域が IlvGraphicHolder API を使用して再描画されます。

以下はフォーカスの描画方法を表しています。computeFocusRegion および drawFocusメソッドがこのプロセスに含まれています。

UpDownField は、現在フォーカスされているオブジェクトに委譲します。次のセクションでは、UpDownField のキーボード・フォーカスをどのように変更するかを説明します。

ガジェット・クラスのイベント用エントリー・ポイントは、IlvGadget::handleEvent メソッドです。このメソッドは、ガジェット・ホルダーがガジェットによって処理するイベントを受け取ったときにガジェット・ホルダーによって呼び出されます。フォーカスされたオブジェクトへイベントのほとんどを委譲するため、UpDownField::handleEvent は非常に単純です (_focusGadget メンバー変数によってポイントされています)。

handleEvent メソッドの主要部分は、キーボード・フォーカス管理を処理します。IlvButtonDown のケースは、複合ガジェットがボタン・ダウン・イベントを受け取ったときに、現在フォーカスされているオブジェクトの変更を行います。IlvKeyDown ケースは、複合ガジェットが TAB キーあるいは Shift-TAB キー・イベントを受け取ったときに、現在フォーカスされているオブジェクトの変更を行います。デフォルト・ケースは、単に現在フォーカスされているオブジェクトに委譲します。

この手順の最初に示したように、UpDownField の左および右ボタンには、押されたときに通知を可能にするコールバックが割り当てられています。2 つのコールバックが定義されています。左ボタンが押されたときに呼び出される Down コールバック、および右ボタンが押されたときに呼び出される Up コールバックです。

これらのコールバックは、getCallbackType メソッドで宣言されています。

次に、UpDownField::increment メソッドが Up コールバックを呼び出すために実装され、UpDownField::decrement メソッドが Down コールバックを呼び出すために実装されます。

ファイル main.cpp は、UpDownField クラスをテストするコードを含んでいます。テキスト・フィールドの値を変更するために UpDownField クラスの Up および Down コールバックを実装する方法を示します。Down コールバックは、テキスト・フィールドの値を減少させ、Up コールバックはこれを増加させます。

まず、コンテナーが作成され、UpDownField クラスのインスタンスがこれに追加されます。

次に、UpDownField のコールバックが設定されます。

以下にコールバックの実装を示します。

これらのコールバックは、UpDownField インスタンスのテキスト・フィールドの値を UpDownField::getLabel を呼び出して取得し、値 1 を追加/削除して変更し、UpDownField::setLabel を呼び出してテキスト・フィールドのラベルとしてこれを設定します。

これで、手順 3 が完了しました。