継承図

協調図

解説

コンボボックスコントロールを表現するレスポンダです。コンボボックスコントロールは、メニューを表示して ユーザに任意の項目を選択させることができます。また、選択されているアイテムの文字列を ボタンのタイトルとして表示でき、各場所の色を設定することもできます。メニュー表示時用に アクセスキーを設定することもできます。

コンボボックスコントロールの一般的な使用方法は以下のようになります。

SFMTYPEDEFCLASS(UserClass)
class UserClass : public SFRPlainWindow {
  // コンストラクタなどは省略
  private:
    Void  Main  (Void);
    HANDLER_DECLARE_VOIDVOID(UserClass, ComboboxHandler)
};

Void UserClass::Main(Void)
{
  SFRComboboxControlPtr  combobox;
  SFUWideString          item[]  = {"item1", "item2", "item3"};

  combobox = new SFRComboboxControl(window, SFURect(5, 5, 48, 16), item, sizearray(item));
  combobox->RegisterHandler(SREVT_CONTROL, HANDLER_BEFORE, HANDLER_FUNCTION(ComboboxHandler));
  combobox->SetAccessKey(0, AVK_1, 0x69F7);
  // コンボボックスの色を設定します。特に設定しない場合はデフォルトの色が使用されます。
  combobox->SetColor(SFRComboboxControl::COLOR_BUTTON_LIGHT, SFUColor(0x99, 0x99, 0x99));
  combobox->SetColor(SFRComboboxControl::COLOR_BUTTON_BASE, SFUColor(0x66, 0x66, 0x66));
  combobox->SetColor(SFRComboboxControl::COLOR_BUTTON_SHADOW, SFUColor(0x33, 0x33, 0x33));
  combobox->SetColor(SFRComboboxControl::COLOR_BUTTON_TITLE, SFUColor(0xBB, 0xBB, 0xBB));
  combobox->SetColor(SFRComboboxControl::COLOR_MENU_LIGHT, SFUColor(0x99, 0x99, 0x99));
  combobox->SetColor(SFRComboboxControl::COLOR_MENU_BASE, SFUColor(0x66, 0x66, 0x66));
  combobox->SetColor(SFRComboboxControl::COLOR_MENU_SHADOW, SFUColor(0x33, 0x33, 0x33));
  combobox->SetColor(SFRComboboxControl::COLOR_MENU_TITLE, SFUColor(0xBB, 0xBB, 0xBB));
  return;
}

HANDLER_IMPLEMENT_VOIDVOID(UserClass, ComboboxHandler)
{
  // メニューが選択されたときにこのハンドラが起動されます。
  return;
}

メンバ

解説

コンボボックスコントロールのコンストラクタです。

使用例

コンボボックスコントロールを作成して、メニューが 選択されたときのハンドラを登録します。

SFRComboboxControlPtr  combobox;
SFUWideString          item[]  = {"item1", "item2", "item3"};

combobox = new SFRComboboxControl(window, SFURect(5, 5, 48, 16), item, sizearray(item));
combobox->RegisterHandler(SREVT_CONTROL, HANDLER_BEFORE, HANDLER_FUNCTION(ComboboxHandler));

参照

SFRComboboxControl::~SFRComboboxControl

参照

SFRComboboxControl::SFRComboboxControl

解説

アイテム項目をアイテム文字列の配列を元に追加します。または、 アイテム項目を一つ追加し、タイトル文字列とアクセスキーと絵文字を設定します。

使用例

アイテム項目の文字列の配列を元にアイテム項目を追加した後、 アイテム項目を一つ追加します。

SFRComboboxControlPtr  combobox;
SFUWideString          item[]  = {"item1", "item2", "item3"};

combobox = new SFRComboboxControl(window, SFURect(5, 5, 48, 16), NULL, 0);
combobox->AppendItem(item, sizearray(item));
combobox->AppendItem("appended", AVK_9, 0x69F7);

参照

SFRComboboxControl::SetItem

解説

コンボボックスに登録されているアイテム項目をすべて削除します。 コンボボックスの値は０に設定されます。

使用例

登録されているアイテム項目をすべて削除します。

SFRComboboxControlPtr  combobox;
SFUWideString          item[]  = {"item1", "item2", "item3"};

combobox = new SFRComboboxControl(window, SFURect(5, 5, 48, 16), item, sizearray(item));
combobox->ClearItem();

参照

SFRComboboxControl::RemoveItem

解説

アイテム項目に登録されているアクセスキーを取得します。 アクセスキーは、BREW のキーコードと同一です。特にアクセスキーが 設定されていないときは、AVK_UNDEFINED が取得されます。

参照

SFRComboboxControl::SetAccessKey

解説

コンボボックスに設定されている色を取得します。 引数は、SFRComboboxControl::ColorEnum 型で表現される パレットインデックスです。無効なインデックスを設定したときの 動作は不定です。

使用例

ボタン部分のベース色を取得します。

SFRComboboxControlPtr  combobox;
SFUColor               color;

combobox = new SFRComboboxControl(window, SFURect(5, 5, 48, 16), NULL, 0);
color = combobox->GetColor(SFRComboboxControl::COLOR_BUTTON_BASE);

参照

SFRComboboxControl::SetColor | SFRComboboxControl::ColorEnum

解説

コンボボックスのボタン部分に設定されているフォントを取得します。

参照

SFRComboboxControl::SetFont

解説

アイテム項目に設定されているタイトル文字列を取得します。

参照

SFRComboboxControl::SetTitle

解説

コンボボックスの現在の値を取得します。コンボボックスの値は、選択されている メニュー項目のインデックスと同一で 0-based で表現される値です。

参照

SFRComboboxControl::SetValue

解説

コンボボックスに登録されているアイテム項目を削除します。

使用例

登録されているアイテム項目を一つ削除します。

SFRComboboxControlPtr  combobox;
SFUWideString          item[]  = {"item1", "item2", "item3"};

combobox = new SFRComboboxControl(window, SFURect(5, 5, 48, 16), item, sizearray(item));
combobox->RemoveItem(0);

参照

SFRComboboxControl::ClearItem

解説

アイテム項目にアクセスキーを設定します。アクセスキーは、BREW のキーコードと同一です。 特にアクセスキーを設定しないときは、AVK_UNDEFINED を設定できます。また、 メニュー表示時に、アイテム文字列の左側に絵文字を表示することができます。

使用例

アイテムにアクセスキーと絵文字を設定します。

SFRComboboxControlPtr  combobox;
SFUWideString          item[]  = {"item1", "item2", "item3"};

combobox = new SFRComboboxControl(window, SFURect(5, 5, 48, 16), item, sizearray(item));
combobox->SetAccessKey(0, AVK_1, 0x69F7);

参照

SFRComboboxControl::GetAccessKey

解説

ベース領域を親の仮想領域の座標で設定します。

使用例

ベース領域の座標を (5, 5, 48, 16) でコンボボックスを生成し、その後、 座標を (10, 10, 96, 16) に変更します。

SFRComboboxControlPtr  combobox;

combobox = new SFRComboboxControl(window, SFURect(5, 5, 48, 16), NULL, 0);
combobox->SetBaseBound(SFURect(10, 10, 96, 16));

参照

SFRResponder::GetBaseBound | SFRResponder::SetBaseBound

解説

コンボボックスの特定の場所の色を設定します。 インデックスは、SFRComboboxControl::ColorEnum 型で 表現されるパレットインデックスです。無効なインデックスを 設定したときの動作は不定です。

使用例

コンボボックスの色を黒っぽく設定します。

SFRComboboxControlPtr  combobox;

combobox = new SFRComboboxControl(window, SFURect(5, 5, 48, 16), NULL, 0);
combobox->SetColor(SFRComboboxControl::COLOR_BUTTON_LIGHT, SFUColor(0x99, 0x99, 0x99));
combobox->SetColor(SFRComboboxControl::COLOR_BUTTON_BASE, SFUColor(0x66, 0x66, 0x66));
combobox->SetColor(SFRComboboxControl::COLOR_BUTTON_SHADOW, SFUColor(0x33, 0x33, 0x33));
combobox->SetColor(SFRComboboxControl::COLOR_BUTTON_TITLE, SFUColor(0xBB, 0xBB, 0xBB));
combobox->SetColor(SFRComboboxControl::COLOR_MENU_LIGHT, SFUColor(0x99, 0x99, 0x99));
combobox->SetColor(SFRComboboxControl::COLOR_MENU_BASE, SFUColor(0x66, 0x66, 0x66));
combobox->SetColor(SFRComboboxControl::COLOR_MENU_SHADOW, SFUColor(0x33, 0x33, 0x33));
combobox->SetColor(SFRComboboxControl::COLOR_MENU_TITLE, SFUColor(0xBB, 0xBB, 0xBB));

参照

SFRComboboxControl::GetColor | SFRComboboxControl::ColorEnum

解説

コンボボックスのボタン部分のタイトルを描画するときのフォントを設定します。

使用例

ボタン部分のタイトルを太字に設定します。

SFRComboboxControlPtr  combobox;

combobox = new SFRComboboxControl(window, SFURect(5, 5, 48, 16), NULL, 0);
combobox->SetFont(AEE_FONT_BOLD);

参照

SFRComboboxControl::GetFont

解説

アイテム項目をアイテム文字列の配列を元に再構築します。または、 アイテム項目のタイトル文字列とアクセスキーと絵文字を設定します。

使用例

アイテム項目の文字列の配列を元にアイテム項目を再構築した後、アイテム項目の タイトル文字列とアクセスキーと絵文字を設定します。

SFRComboboxControlPtr  combobox;
SFUWideString          item[]  = {"item1", "item2", "item3"};

combobox = new SFRComboboxControl(window, SFURect(5, 5, 48, 16), NULL, 0);
combobox->SetItem(item, sizearray(item));
combobox->SetItem(0, "changed", AVK_1, 0x69F7);

参照

SFRComboboxControl::GetTitle | SFRComboboxControl::GetAccessKey | SFRComboboxControl::AppendItem

解説

アイテム項目のタイトル文字列を設定します。

使用例

タイトル文字列を変更します。

SFRComboboxControlPtr  combobox;
SFUWideString          item[]  = {"item1", "item2", "item3"};

combobox = new SFRComboboxControl(window, SFURect(5, 5, 48, 16), item, sizearray(item));
combobox->SetTitle(0, "changed");

参照

SFRComboboxControl::GetTitle

解説

コンボボックスの現在の値を設定します。コンボボックスの値は、選択されている メニュー項目のインデックスと同一で 0-based で表現される値です。

使用例

コンボボックスの値を１に設定します。

SFRComboboxControlPtr  combobox;
SFUWideString          item[]  = {"item1", "item2", "item3"};

combobox = new SFRComboboxControl(window, SFURect(5, 5, 48, 16), item, sizearray(item));
combobox->SetValue(1);

参照

SFRComboboxControl::GetValue

解説

コンボボックスの特定の個所の色を設定 / 取得するときに使用する パレットのインデックスです。

参照

SFRComboboxControl::SetColor | SFRComboboxControl::GetColor