SFBStatic

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

#include <SFBStatic.hpp>

class SFBStatic : public SFBControl;

typedef SFBStatic&          SFBStaticRef;
typedef SFBStatic*          SFBStaticPtr;
typedef SFBStatic**         SFBStaticHandle;
typedef const SFBStatic     ConstSFBStatic;
typedef const SFBStatic&    ConstSFBStaticRef;
typedef const SFBStatic*    ConstSFBStaticPtr;
typedef const SFBStatic**   ConstSFBStaticHandle;

継承図

参照

BREW API IStatic

バグ情報

DIB のサポート
ドキュメントエラー	BREW API リファレンス 2.0.1.5

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

メンバ

パブリック関数
public	AddRef (SFBBase から継承)	インターフェイスの参照カウントをインクリメントします。
public	GetProperties (SFBControl から継承)	コントロール固有のプロパティまたはフラグを返します。
public	GetRect (SFBControl から継承)	コントロールの矩形を取得します。
public	GoToLine	コール側は、指定の行までスクロールできます。nLine パラメータは 0 基準のインデックス値です。
public	HandleEvent (SFBControl から継承)	コントロールのイベント処理機能を提供します。この関数はすべてのコントロールで実装する必要があります。
public static	Instance	IStatic インターフェイスのインスタンスを取得します。
public	IsActive (SFBControl から継承)	コントロールのアクティブ状態を返します。
public	IsScrollable	静的コントロールのテキストが、コントロールに割り当てられた領域に収まるかどうかをコール側で判断できます。
public	Redraw (SFBControl から継承)	コントロールの内容を再描画します。
public	Release (SFBBase から継承)	インターフェイスの参照カウントをデクリメントします。
public	Reset (SFBControl から継承)	コントロールの内容をリセットし、アクティブ状態をすぐに解除します。
public	SetActive (SFBControl から継承)	コントロールのアクティブ状態を設定/解除します。
public	SetFont	この関数を使用すると、タイトルとテキストをコール側で設定できます。
public	SetProperties (SFBControl から継承)	コントロール固有のプロパティまたはフラグを設定します。
public	SetRect (SFBControl から継承)	コントロールの矩形を設定します。
public	SetText	IStatic インタフェースオブジェクトのテキストとタイトルを設定します。
public	SetTextEx	IStatic インタフェースオブジェクトの既存のテキストに、文字列の追加、置換をします。
public	SizeToFit	コール側は、IStatic 内のすべてのテキストに合うように、境界長方形を調節できます。

SFBStatic::GoToLine

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

[ public ]
SIntN GoToLine(
    SIntN nLineIdx   
);

参照

BREW API ISTATIC_GoToLine

SFBStatic::Instance

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

[ public, static ]
SFUBrewPtr<SFBStatic> Instance(Void);

SFBStatic::IsScrollable

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

[ public ]
Bool IsScrollable(Void);

参照

BREW API ISTATIC_IsScrollable

SFBStatic::SetFont

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

[ public ]
Void SetFont(
    AEEFont fntText    
    AEEFont fntTitle   
);

参照

BREW API ISTATIC_SetFont

SFBStatic::SetText

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

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

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

参照

BREW API ISTATIC_SetText | AEEFont

SFBStatic::SetTextEx

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

[ public ]
Bool SetTextEx(
    BytePtr text                            テキスト文字列を指すバイト型のポインタを設定します。
    const SFUBrewPtr<SFBAStream>& pStream   テキスト文字列を含む SFBAStream オブジェクトを設定します。
    Bool bAppend                            
	  TRUE の場合は、テキストに文字列を追加します。
	  FALSE の場合は、テキストを置換します。
	
);

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

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

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

戻り値

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

解説

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

注意

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

使用例

    SFUBrewPtr<SFBStatic> staticCtl = SFBStatic::Instance();

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

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

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

    staticCtl->SetRect(SFURect(0, 0, 100, 100));
    staticCtl->SetActive(TRUE);
    staticCtl->Redraw();

参照

BREW API ISTATIC_SetTextEx

SFBStatic::SizeToFit

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

[ public ]
Void SizeToFit(
    SFURectPtr prc   
);

参照

BREW API ISTATIC_SizeToFit