SFBStatic

IStatic インターフェイスのラッパークラスです。

#include <SFBStatic.h.hpp>

class SFBStatic : public SFBControl;

SFMTYPEDEFWRAPPER(SFBStatic)

継承図

協調図

参照

BREW API IStatic

バグ情報

ISTATIC_SetActive
バグ	BREW 2.1 以前の全てのSDK 及び実機

現在、ISTATIC_SetActive()によってコントロールをインアクティブにしても、自動スクロールが止まらないという不具合があります。

ISTATIC_SetFont
バグ	BREW 2.1 以前の全てのSDK 及び実機

現在、ISTATIC_SetFont()によりタイトル部のフォントを変更しても、タイトル部の描画領域の大きさが再計算されず、見た目が崩れる不具合があります。 ISTATIC_SetText()、ISTATIC_SetTitle() の中でフォントを指定した場合にはこの問題は起こりません。

ISTATIC_SetProperties
ドキュメントエラー	BREW API リファレンス 2.0.1.5

ST_NOSCROLL をセットした場合、「現行バージョンでは自動スクロールを OFF にするだけ」と記述がありますが、これは誤りです。 BREW 1.1 以上のバージョンでは、 ST_NOSCROLL を設定した場合、自動スクロールは無効化されますが、 AVK_UP 及び AVK_DOWN のキーイベントを渡すことで上下へスクロールします。

メンバ

パブリック関数
`SInt32`	GoToLine( `SInt32` index ) コール側は、指定の行までスクロールできます。 index パラメータは 0 基準のインデックス値です。
`Bool`	IsScrollable( `Void` ) 静的コントロールのテキストが、コントロールに割り当てられた領域に収まるかどうかをコール側で判断できます。
static `SFBStaticSmp`	NewInstance( `Void` ) SFBStatic インターフェイスのインスタンスを取得します。
`Void`	SetFont( `AEEFont` textFont , `AEEFont` titleFont ) この関数を使用すると、タイトルとテキストをコール側で設定できます。
`Bool`	SetText( `WCharPtr` title , `WCharPtr` text , `AEEFont` titleFont , `AEEFont` textFont ) SFBStatic インタフェースオブジェクトのテキストとタイトルを設定します。
`Bool`	SetTextEx( `BytePtr` text , `SFBAStreamSmpConstRef` stream , `Bool` append ) SetTextEx( `SFBAStreamSmpConstRef` stream , `Bool` append = false ) SetTextEx( `SFXWideStringConstRef` text , `Bool` append = false ) SetTextEx( `SFXAnsiStringConstRef` text , `Bool` append = false ) SFBStatic インタフェースオブジェクトの既存のテキストに、文字列の追加、置換をします。
`Void`	SizeToFit( `SFXRectanglePtr` rect ) コール側は、SFBStatic 内のすべてのテキストに合うように、境界長方形を調節できます。
`UInt32`	GetProperties( `Void` ) (SFBControl から継承) コントロール固有のプロパティまたはフラグを返します。
`Void`	GetRect( `SFXRectanglePtr` rect ) (SFBControl から継承) コントロールの矩形を取得します。
`SFXRectangle`	GetRect( `Void` ) (SFBControl から継承) コントロールの矩形を取得します。
`Bool`	HandleEvent( `AEEEvent` event , `UInt16` wParam , `UInt32` dwParam ) (SFBControl から継承) HandleEvent( `SFXEventConstRef` event ) (SFBControl から継承) コントロールのイベント処理機能を提供します。この関数はすべてのコントロールで実装する必要があります。
`Bool`	IsActive( `Void` ) (SFBControl から継承) コントロールのアクティブ状態を返します。
`Bool`	Redraw( `Void` ) (SFBControl から継承) コントロールの内容を再描画します。
`Void`	Reset( `Void` ) (SFBControl から継承) コントロールの内容をリセットし、アクティブ状態をすぐに解除します。
`Void`	SetActive( `Bool` active = true ) (SFBControl から継承) コントロールのアクティブ状態を設定/解除します。
`Void`	SetProperties( `UInt32` properties ) (SFBControl から継承) コントロール固有のプロパティまたはフラグを設定します。
`Void`	SetRect( `SFXRectangleConstRef` rect ) (SFBControl から継承) コントロールの矩形を設定します。

SFBStatic::GoToLine

コール側は、指定の行までスクロールできます。 index パラメータは 0 基準のインデックス値です。

[ public ]
SInt32 GoToLine(
    SInt32 index   // スクロール表示へのインデックス。
);

参照

BREW API ISTATIC_GoToLine

SFBStatic::IsScrollable

静的コントロールのテキストが、コントロールに割り当てられた領域に収まるかどうかをコール側で判断できます。

[ public ]
Bool IsScrollable(Void);

参照

BREW API ISTATIC_IsScrollable

SFBStatic::NewInstance

SFBStatic インターフェイスのインスタンスを取得します。

[ public, static ]
SFBStaticSmp NewInstance(Void);

SFBStatic::SetFont

この関数を使用すると、タイトルとテキストをコール側で設定できます。

[ public ]
Void SetFont(
    AEEFont textFont    // テキストに使用するフォント。
    AEEFont titleFont   // タイトルに使用するフォント。
);

参照

BREW API ISTATIC_SetFont

SFBStatic::SetText

SFBStatic インタフェースオブジェクトのテキストとタイトルを設定します。

[ public ]
Bool SetText(
    WCharPtr title      // タイトル文字列を指すポインタを設定します。
    WCharPtr text       // テキスト文字列を指すポインタを設定します。
    AEEFont titleFont   // タイトルのフォントを設定します。
    AEEFont textFont    // テキストのフォントを設定します。
);

[ public ]
Bool SetText(
    SFXWideStringConstRef title   // タイトル文字列を指すポインタを設定します。
    SFXWideStringConstRef text    // テキスト文字列を指すポインタを設定します。
    AEEFont titleFont             // タイトルのフォントを設定します。
    AEEFont textFont              // テキストのフォントを設定します。
);

参照

BREW API ISTATIC_SetText | AEEFont

SFBStatic::SetTextEx

SFBStatic インタフェースオブジェクトの既存のテキストに、文字列の追加、置換をします。

[ public ]
Bool SetTextEx(
    BytePtr text                   // テキスト文字列を指すバイト型のポインタを設定します。
    SFBAStreamSmpConstRef stream   // テキスト文字列を含む SFBAStream オブジェクトを設定します。
    Bool append                    
// true の場合は、テキストに文字列を追加します。
// false の場合は、テキストを置換します。
	
);

[ public ]
Bool SetTextEx(
    SFXAnsiStringConstRef text   // テキストに設定する文字列を含む SFXAnsiString オブジェクトを設定します。
    Bool append = false          
// true の場合は、テキストに文字列を追加します。
// false の場合は、テキストを置換します。
	
);

[ public ]
Bool SetTextEx(
    SFXWideStringConstRef text   // テキストに設定する文字列を含む SFXWideString オブジェクトを設定します。
    Bool append = false          
// true の場合は、テキストに文字列を追加します。
// false の場合は、テキストを置換します。
	
);

[ public ]
Bool SetTextEx(
    SFBAStreamSmpConstRef stream   // テキスト文字列を含む SFBAStream オブジェクトを設定します。
    Bool append = false            
// true の場合は、テキストに文字列を追加します。
// false の場合は、テキストを置換します。
	
);

戻り値

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

解説

静的コントロールのテキストをシングルバイト (char 型) 文字列、または、ダブルバイト (AECHAR 型) 文字列で設定します。この関数を使用して静的コントロールのテキストにシングルバイト文字列を設定する場合は、関数を呼び出す前に、プロパティに ST_ASCII を設定してください。 ST_ASCII をプロパティに設定することで、シングルバイト文字列を設定できます。また、ダブルバイト文字列を設定する場合は、プロパティに ST_ASCII を設定しないで下さい。 (デフォルトでは、静的コントロールのプロパティに ST_ASCII は設定されていません。)

注意

SetTextEx(SFXAnsiStringConstRef text, Bool append) または、 SetTextEx(SFXWideStringConstRef text, Bool append) を呼び出す場合は、文字列リテラル ("literal" など "" (ダブルクォート) で囲まれた文字列) を使用しないでください。引数で文字列を設定する場合は、明示的に SFXAnsiString 型もしくは、SFXWideString 型で設定してください。

使用例

    SFBStaticSmp staticCtl = SFBStatic::NewInstance();

    // タイトルと置換前の文字列を設定します。
    staticCtl->SetText("StaticTest", "Static Static", AEE_FONT_LARGE, AEE_FONT_LARGE);

    // シングルバイト文字列を SetTextEx() に設定するのでプロパティに、
    // ST_ASCII を設定します。
    staticCtl->SetProperties(ST_ASCII);

    // シングルバイト文字列を設定します。
    staticCtl->SetTextEx(SFXAnsiString("Stream Test"));

    staticCtl->SetRect(SFXRectangle(0, 0, 100, 100));
    staticCtl->SetActive(true);
    staticCtl->Redraw();

参照

BREW API ISTATIC_SetTextEx

SFBStatic::SizeToFit

コール側は、SFBStatic 内のすべてのテキストに合うように、境界長方形を調節できます。

[ public ]
Void SizeToFit(
    SFXRectanglePtr rect   // 境界長方形を設定する場所へのポインタ。
);

参照

BREW API ISTATIC_SizeToFit