協調図

解説

読み取り専用のテキストや画像を表示するレスポンダです。 テキスト コントロールと異なり静的コントロール (SFRBrewStaticControl) は、 ユーザーによる文字の入力を受け付けません。テキストが静的コントロールの 長方形領域内に収まりきらない場合、静的コントロールは自動的にスクロールします。 静的コントロールは、テキストの代わりにイメージ画像を表示することも可能です。 読み取り専用のテキストやイメージ画像の表示には、BREW 標準のコントロールである IStatic インターフェイスを使用しています。

注意

SFRBrewStaticControl を使用する場合は、以下の点に注意してください。

参照

BREW API IStatic

メンバ

解説

静的コントロール (SFRBrewStaticControl) オブジェクトを生成します。

戻り値

スクロールをする前のインデックス値を返します。

戻り値

テキストが静的コントロール内に収まらず、静的コントロールがスクロールする場合は TRUE を返します。 テキストが静的コントロール内に収まる場合は、FALSE を返します。

バグ

BREW 2.1 以前の全ての SDK と実機で、タイトル部のフォントを変更しても、 タイトル部の描画領域の大きさが再計算されず、 見た目が崩れる不具合があります。

戻り値

イメージ画像が正しく設定された場合は、TRUE を返します。 それ以外の場合は、FALSE を返します。

注意

静的コントロール オブジェクトに画像を設定する場合は、 以下の点に注意してください。

使用例

SFRBrewStaticControlPtr staticCtl;
SFUBrewPtr<SFBShell>    shell = SFBShell::Instance();
SFUBrewPtr<SFBImage>    image;

// 静的コントロール オブジェクトを生成します。
// プロパティに ST_ICONTEXT を設定することで、テキストにイメージ画像を設定できます。
staticCtl = new SFRBrewStaticControl(this, SFURect(0, 0, 100, 100), ST_ICONTEXT);

// イメージ画像を読み込みます。
image = shell->LoadResImage(SAMPLE_RES_FILE, IDR_ICON_BMP);

// 静的コントロール オブジェクトにイメージ画像を設定します。
staticCtl->SetImage(image);

参照

SFRBrewStaticControl::SetText

戻り値

テキストが正しく設定された場合は、TRUE を返します。 それ以外の場合は、FALSE を返します。

注意

静的コントロール オブジェクトが移動中の場合は、テキストの自動スクロールが停止します。

使用例

SFRBrewStaticControlPtr staticCtl;

// 静的コントロール オブジェクトを生成します。
// プロパティに ST_NOSCROLL を設定することで、自動スクロールを停止します。
staticCtl = new SFRBrewStaticControl(this, GetContentWorld().Inset(30, 30), ST_NOSCROLL);

// 静的コントロール オブジェクトにテキストを設定します。
staticCtl->SetText("StaticCtl Title", "StaticCtl Text", AEE_FONT_LARGE, AEE_FONT_LARGE);

参照

SFRBrewStaticControl::SetTextEx | SFRBrewStaticControl::SetImage

戻り値

テキストが設定、または追加された場合は、TRUE を返します。 テキストが設定、または追加されなかった場合は、FALSE を返します。

解説

SFRBrewStaticControl::SetProperties で設定したフラグ (ST_ASCII) に従い 静的コントロール オブジェクトにテキストを追加、または置換します。 append が TRUE の場合はテキストに文字列を追加し、append が FALSE の場合はテキストを置換します。

注意

SFRBrewStaticControl::SetTextEx の使用時には、以下の点に注意してください。

使用例

SFRBrewStaticControlPtr staticCtl;

// 静的コントロール オブジェクトを生成します。
// プロパティに ST_ASCII を設定することで、シングルバイト文字列を扱います。
staticCtl = new SFRBrewStaticControl(this, GetContentWorld().Inset(30, 30), ST_ASCII);

// シングルバイト文字列で置換します。
staticCtl->SetTextEx(SFUAnsiString("Stream Test"));

参照

SFRBrewStaticControl::SetText | SFRBrewStaticControl::SetImage

引数