継承図

協調図

解説

編集可能なテキスト入力ボックスを表すコントロールです。

内部で BREW 標準の ITextCtl クラスを使い、入力処理は BREW 側の実装に依存しています。

生成後に SetMaxSize 関数を呼び出して最大入力可能文字数を設定する必要があります。

最前面で入力処理を受け付ける必要があります。

テキスト入力ボックスを使うときのコードは以下のようになります。

SFMTYPEDEFCLASS(MyWindow)
class MyWindow : public SFRTitleWindow {
    SFMSEALCOPY(MyWindow)
public:
    MyWindow(Void) static_throws;
    virtual ~MyWindow(Void) { return; }
    
    // テキスト ボックスをポインター型のメンバ変数として定義する
    SFREditboxControlPtr     _editbox;      // テキスト ボックス
    
    HANDLER_DECLARE_VOIDCONTROL(OnEditboxControl)
};

// コンストラクタ (エラー処理は省略)
MyWindow::MyWindow(Void) : SFRTitleWindow(SFRApplication::GetInstance(),
    SFXRectangle(20, 20, 200, 250), "my window") static_throws
{

    // テキスト ボックスの作成
    // 第 1 引数 : 親レスポンダ
    // 第 2 引数 : テキスト ボックス の位置とサイズ
    // 第 3 引数 : テキスト ボックス の名前
     _editbox = new SFREditboxControl(this, 
                                     SFXRectangle(20, 50, 150, 25), 
                                     "Editbox");
                                     
    // 最大文字数を設定する
    _editbox->SetMaxSize(255);

    // テキストの入力後やフォーカスが外れたときの
    // イベントハンドラの設定
    editbox->RegisterHandler(SREVT_CONTROL, 
                             HANDLER_BEFORE,
                             HANDLER_FUNCTION(OnEditboxControl)));
    }

    // テキスト ボックス上でセレクトキーを押したときに
    // 入力モードに移るようにセットする
    // ( SelectHandler は SophiaFramework が用意しているセレクトキー用のハンドラ )
    RegisterHandler(SFEVT_KEY, 
                    AVK_SELECT, 
                    HANDLER_AFTER,
                    HANDLER_FUNCTION(SelectHandler)));
    }
    
    return;
}

テキスト入力後のイベント

テキストの入力後やフォーカスが外れた場合、 SFEVT_CONTROL がエディット コントロールに送信されます。

イベントの P16 値

// エディット コントロールで、テキストの入力後やフォーカスが外れたときの
// イベントハンドラ 
HANDLER_IMPLEMENT_VOIDCONTROL(MyWindow, OnEditboxControl, result, control)
{
    // ターゲットを外す
    control->SetStatusTarget(false);

    if (result) { // テキストの入力後なら
        
        // フォーカスを次へ移動
        FocusNext();

    } // フォーカスが外れたなら
    else {
        //...
    }
}

参照

SFRResponder | SFRApplication | SFRWindow | SFRDialog | SFRControl | エディット コントロール

メンバ

解説

SFREditboxControl クラスで利用される BREW テキストコントロールをクラス ID で指定できます。デフォルト値は AEECLSID_TEXTCTL です。

解説

テキスト コントロール モードを列挙するときは、EnumModeInit 関数を最初に呼び出す必要があります。

参照

SFREditboxControl::EnumNextMode

戻り値

列挙が完了すると、AEE_TM_NONE を返します。

参照

SFREditboxControl::EnumModeInit

引数

解説

無効なパレット インデックスを設定したときの動作は不定です。

使用例

ベース色を取得します。

SFREditboxControlPtr  textcontrol;
SFXRGBColor           color;

textcontrol = new SFREditboxControl(window, SFXRectangle(5, 5, 48, 16), "sample");
color = textcontrol->GetColor(SFREditboxControl::COLOR_BUTTON_BASE);

参照

SFREditboxControl::SetColor | SFREditboxControl::ColorEnum

参照

SFREditboxControl::SetCursorPos

戻り値

現在のテキスト入力モードを返します。

参照

SFREditboxControl::SetInputMode

参照

SFREditboxControl::SetProperties

参照

SFREditboxControl::SetText

引数

解説

無効なパレット インデックスを設定したときの動作は不定です。

参照

SFREditboxControl::GetColor | SFREditboxControl::ColorEnum

参照

SFRResponder::GetContentBound

参照

SFREditboxControl::GetCursorPos

戻り値

設定されたテキスト入力モードを返します。

参照

SFREditboxControl::GetInputMode

参照

SFREditboxControl::GetProperties

戻り値

参照

SFREditboxControl::GetText

参照

SFRResponder::GetVirtualBound

解説

色を設定 / 取得するときに使います。

参照

SFREditboxControl::SetColor | SFREditboxControl::GetColor