継承図

バージョン

参照

BREW API IShell

メンバ

戻り値

アクティブなアプリに関連付けられた ClassID。

アクティブなアプリが存在しない場合、0。

解説

この関数は、アクティブなアプリに関連付けられた ClassID を取得します。

	注意
	アクティブなアプリとは、 現在実行中のアプリの中で最前面に配置され可視状態にあるアプリのことです。

参照

BREW API ISHELL_ActiveApplet | AEECLSID | SFBShell::StartApplet | SFBShell::CloseApplet | SFBShell::CanStartApplet

戻り値

解説

この関数は、待機中のアラームがあるかどうかを取得します。

アナンシエータ（呼び出し表示装置）に ANNUN_ALARMCLOCK、ANNUN_COUNTDOWN、または ANNUN_STOPWATCH が設定されている場合は、true を返します。

参照

BREW API ISHELL_AlarmsActive | SFBDisplay::SetAnnunciators

戻り値

解説

この関数は、 指定されたアプリが指定された特権レベルをサポートしているかを判定します。

	注意
	idGroup 引数の上位ワードが 0 の場合、 idGroup 引数は以下の旧スタイルの特権ビットのビットマスクとして処理されます。 PL_FILE PL_NETWORK PL_TAPI PL_DOWNLOAD PL_SHARED_WRITE PL_POS_LOCATION PL_SYSTEM PL_WEB PL_RINGER_WRITE PL_SECTORINFO PL_ADDRBOOK

バージョン

	注意
	この関数は、BREW 3.1 から使用可能です。

参照

BREW API ISHELL_AppIsInGroup | BREW API AEE特権レベル | AEECLSID | SFBShell::CheckPrivLevel

戻り値

解説

この関数は、 システムビープ音を鳴らします（または、デバイスを振動させます）。

beep 引数には、 BeepType 列挙型の値を指定します。

	注意
	BREW シミュレータの場合、 開発者は独自のビープ音タイプ（BeepType）のトーンを WAV 形式で定義できます。 このトーンは、 <$BREWDIR\bin\DataFiles> ディレクトリに保存されます。 たとえば、独自の BEEP_ALERTトーンを作成するには、 BEEP_ALERT.wavという名前でWAV形式ファイルを保存します。

参照

BREW API ISHELL_Beep | BeepType

戻り値

解説

この関数は、 指定されたファイル拡張子に関連付けられているアプリを起動します。

起動されたアプリは、EVT_BROWSE_FILE イベントを受信します。

	注意
	起動動作は、SFBShell::StartApplet 関数とまったく同じです。

参照

BREW API ISHELL_BrowseFile | SFBShell::StartApplet | SFBShell::StartAppletEx | SFBShell::BrowseURL

戻り値

解説

この関数は、 指定された URL 文字列に関連付けられているアプリを起動します。

起動されたアプリは、EVT_BROWSE_URL イベントを受信します。

	注意
	起動動作は、SFBShell::StartApplet 関数とまったく同じです。

参照

BREW API ISHELL_BrowseURL | SFBShell::StartApplet | SFBShell::StartAppletEx | SFBShell::BrowseFile

戻り値

解説

この関数は、 アプリの終了が必要かどうかを判定します。

	注意
	この関数は、ブラウザなどイベントループ（SFBShell::HandleEvent 関数） から戻るまでにたくさんの処理を行う必要のあるアプリで使用します。 この関数は、内部で SFBShell::ForceExit 関数を使用しています。

参照

BREW API ISHELL_Busy | SFBShell::HandleEvent | SFBShell::ForceExit

戻り値

解説

この関数は、 指定されたアプリが起動できるかどうかを判定します。

	注意
	通常、この関数は true を返します。 ただし、重要なダイアログが表示されている場合や他のアプリが実行中の場合は、 新しいアプリの起動が制限されることもあります。

参照

BREW API ISHELL_CanStartApplet | AEECLSID | SFBShell::StartApplet | SFBShell::CloseApplet | SFBShell::ActiveApplet

戻り値

解説

この関数は、 指定されたアプリに設定されているアラームをキャンセルします。

	注意
	引数に適正な ClassID と 16 ビットのユーザーコードを指定しなかった場合は、 SFERR_FAILED が返ります。

参照

BREW API ISHELL_CancelAlarm | AEECLSID | SFBShell::SetAlarm | SFBShell::SuspendAlarms | SFBShell::ResumeAlarms

戻り値

常に SFERR_NO_ERROR。

解説

この関数は、 指定されたコールバック関数とユーザーデータに設定されているタイマーをキャンセルします。

	注意
	notify 引数が null である場合、 data 引数に関連付けられたすべてのタイマーがキャンセルされます。 設定されていないタイマーをキャンセルしても問題はありません。

使用例

設定中のタイマーをキャンセルします。

SFBShellSmp     shell = SFBShell::GetInstance();

// 設定中のタイマーをキャンセルする
shell->CancelTimer(OnTimerEntry, this);

参照

BREW API ISHELL_CancelTimer | PFNNOTIFY | SFBShell::SetTimer | SFBShell::SetTimerEx | SFBShell::GetTimerExpiration

戻り値

解説

この関数は、 現在実行しているアプリの特権レベルを指定された値と照合します。

特権レベルがサポートされる場合は true、されない場合は false を返します。 queryOnly 引数が false で特権レベルがサポートされていない場合は、 システムメッセージを出力してアプリを終了します。

privilege 引数の高位ワードが 0 の場合、privilege 引数は以下の特権ビットのビットマスクとして処理されます。

アプリは、以下の 3 つのいずれかの方法で「グループ」のメンバになります。

各アプリは、グループ 0 のメンバです。

	注意
	この関数の戻り値が true であっても、 SFBShell::CreateInstance 関数が成功するとは限りません。 指定した ClassID がデバイス上に存在しない、インスタンス化できない（例: PL_FILE）、 または制限されている（アプリの ClassID はシステムだけがインスタンス化できる）場合があるからです。

使用例

ファイルにアクセスできるか確認します。

Bool            ok    = false;
SFBShellSmp     shell = SFBShell::GetInstance();

// アプリの特権レベルを確認する
// ファイルにアクセスできるか確認する
ok = shell->CheckPrivLevel(PL_FILE, true);

参照

BREW API ISHELL_CheckPrivLevel | BREW API AEE特権レベル | SFBShell::AppIsInGroup | SFBShell::CreateInstance | AEECLSID

戻り値

解説

この関数は、 指定された Class ID に関連付けられている基本モジュールのプロパティをクリアします。

この関数の呼び出しは、 SFBShell::SetProperty(clsid, wId, null, 0); を呼び出すことと同じです。

バージョン

この関数は、BREW 3.1 から使用可能です。

参照

AEECLSID | SFBShell::SetProperty

戻り値

解説

この関数は、 すべてのアプリのエラー状態をクリアにします。

バージョン

この関数は、BREW 3.0 のみ使用可能です。

参照

SFBShell::StartApplet | SFBShell::StartAppletEx

戻り値

解説

この関数は、 アクティブなアプリを閉じます。

アクティブなアプリに対しEVT_APP_STOP イベントが送信されます。

使用例

アプリを閉じます。

SFBShellSmp     shell = SFBShell::GetInstance();

// アプリを閉じる
shell->CloseApplet(false);

参照

BREW API ISHELL_CloseApplet | SFBShell::StartApplet | SFBShell::CanStartApplet | SFBShell::ActiveApplet

戻り値

解説

この関数は、 指定された DialogInfo データ構造に関連するダイアログ、 または指定されたリソースファイルに関連するダイアログを起動します。

参照

BREW API ISHELL_CreateDialog | DialogInfo | SFBShell::GetActiveDialog | SFBShell::EndDialog | SFBDialog::SetFocus | SFBDialog::GetControl

戻り値

戻り値が SFCError 型の場合:

戻り値が SFBBaseSmp 型の場合:

解説

この関数は、 指定された ClassID（AEECLSID）のオブジェクトを作成します。

	注意
	正常終了の場合は、指定した ClassID のオブジェクトがこの関数の戻り値として、または、 handle 引数に返されます。

参照

BREW API ISHELL_CreateInstance | AEECLSID | SFBModule::CreateInstance

戻り値

解説

この関数は、 指定されたバッファデータまたはオブジェクトの MIME タイプを取得します。

	Tip
	この関数は、通常、データの MIME タイプに関連付けられているハンドラを取得するために使用します。 たとえば、データが標準の MIDI 形式である場合、この関数は MIME "audio/mid" を返します。 この MIME タイプをシェルレジストリを検索し、 ClassID が AEECLSID_MEDIA であるハンドラを取得します。

	注意
	data 引数は、name 引数よりも優先されます。 両方を指定した場合、型検出には最初に data 引数が使われ、次に name 引数が使用されます。 この関数が ENEEDMORE を返した場合は、 操作の続行に必要な追加のバイト数が size / additional 引数に格納されます。 前回指定したバイト数に追加のバイト数を加えて（バッファサイズを拡張して）この関数を再び呼び出します。

参照

BREW API ISHELL_DetectType | SFBShell::GetHandler | SFBShell::CreateInstance

戻り値

解説

この関数は、 現在アクティブなダイアログを閉じます。

参照

BREW API ISHELL_EndDialog | SFBShell::CreateDialog | SFBShell::GetActiveDialog | SFBDialog::SetFocus | SFBDialog::GetControl

解説

この関数は、 AEE シェルの内部アプリの列挙インデックスをリセットします。

	Tip
	この関数は、SFBShell::EnumNextApplet 関数と一緒に使用します。

使用例

アプリを列挙し、次のアプリの情報を取得します。

SFBShellSmp     shell   = SFBShell::GetInstance();
AEEAppInfo      appInfo = {0};

// アプリの列挙を初期化する
shell->EnumAppletInit();

// 次のアプリの情報を取得する
while(shell->EnumNextApplet(&appInfo)){

    // アプリに関する処理
    ....
}

参照

BREW API ISHELL_EnumAppletInit | SFBShell::EnumNextApplet

戻り値

解説

この関数は、 次のアプリに関する情報を取得します。

	Tip
	この関数は、SFBShell::EnumAppletInit 関数と一緒に使用します。

使用例

アプリを列挙し、次のアプリの情報を取得します。

SFBShellSmp     shell   = SFBShell::GetInstance();
AEEAppInfo      appInfo = {0};

// アプリの列挙を初期化する
shell->EnumAppletInit();

// 次のアプリの情報を取得する
while(shell->EnumNextApplet(&appInfo)){

    // アプリに関する処理
    ....
}

参照

BREW API ISHELL_EnumNextApplet | AEEAppInfo | SFBShell::EnumAppletInit

戻り値

解説

この関数は、 アプリの終了が必要かどうかを判定します。

	注意
	この関数は、ブラウザなどイベントループ（SFBShell::HandleEvent 関数） から戻るまでにたくさんの処理を行う必要のあるアプリで使用します。

参照

BREW API ISHELL_ForceExit | SFBShell::HandleEvent | SFBShell::Busy

解説

この関数は、 リソースファイルからロードしたデータブロックを解放します。

	注意
	data 引数には、SFBShell::LoadResData 関数により確保したデータブロックを指定します。

参照

BREW API ISHELL_FreeResData | SFBShell::LoadResData

戻り値

正常終了した場合は、現在アクティブなダイアログ。 アクティブなダイアログが存在しないか、失敗した場合は null。

解説

この関数は、 現在アクティブなダイアログを取得します。

参照

BREW API ISHELL_GetActiveDialog | SFBShell::CreateDialog | SFBShell::EndDialog | SFBDialog::SetFocus | SFBDialog::GetControl

戻り値

格納される作成者名の文字数。 作成者名が見つからなかった場合、または buf 引数が null の場合、0。

解説

この関数は、 アクティブなアプリの作成者の名前を取得します。

使用例

アプリの作成者名を取得します。

SFBShellSmp         shell = SFBShell::GetInstance();
SFXWideString       author;

//文字数を設定する
author.SetLength(20);

// アプリの作成者名を取得する
shell->GetAppAuthor(&author);
// or
shell->GetAppAuthor(author.GetBuffer(), sizeof(WChar) * author.GetLength());

参照

BREW API ISHELL_GetAppAuthor

戻り値

格納される著作権文字列の文字数。 著作権文字列が見つからなかった場合、または buf 引数が null の場合、0。

解説

この関数は、 アクティブなアプリの著作権文字列を取得します。

	注意
	この情報は MIF ファイルから取得します。

使用例

アプリの著作権文字列を取得します。

SFBShellSmp         shell = SFBShell::GetInstance();
SFXWideString       copyright;

//文字数を設定する
copyright.SetLength(30);

// アプリの著作権文字列を取得する
shell->GetAppCopyright(&copyright);
// or
shell->GetAppCopyright(copyright.GetBuffer(), sizeof(WChar) * copyright.GetLength());

参照

BREW API ISHELL_GetAppCopyright

戻り値

解説

この関数は、 アプリのプリファレンスが含まれる構造体を取得します。

アプリはこれを使って、アプリ固有の設定を保存したり取得できます。

	Tip
	プリファレンスを格納するには、SFBShell::SetAppPrefs 関数を使用します。

参照

BREW API ISHELL_GetAppPrefs | SFBShell::SetAppPrefs

戻り値

格納されるバージョン文字列の文字数。 バージョン文字列が見つからなかった場合、または buf 引数が null の場合、0。

解説

この関数は、 アクティブなアプリのバージョン文字列を取得します。

	注意
	この情報は MIF ファイルから取得します。

使用例

アプリのバージョン文字列を取得します。

SFBShellSmp         shell = SFBShell::GetInstance();
SFXWideString       version;

// 文字数を設定する
version.SetLength(20);

// アプリのバージョン文字列を取得する
shell->GetAppVersion(&version);
// or
shell->GetAppVersion(version..GetBuffer(), sizeof(WChar) * version.GetLength());

参照

BREW API ISHELL_GetAppVersion

戻り値

指定された ClassID を所有しているモジュールに割り当てられた 32 ビット値。 クラスが見つからないか、またはモジュールが静的である場合、0。

解説

この関数は、 指定された ClassID を所有しているモジュールに割り当てられた 32 ビット値を取得します。

バージョン

この関数は、BREW 2.1 から使用可能です。

参照

BREW API ISHELL_GetClassItemID

解説

この関数は、 デバイス情報（サポートしている RAM 容量、表示ディスプレイなど）を AEE シェルから取得します。

	Tip
	SophiaFramework UNIVERSE では、 SFXDevice を使用してデバイス情報を取得できます。

使用例

デバイスの情報を取得します。

SFBShellSmp         shell      = SFBShell::GetInstance();
AEEDeviceInfo       deviceInfo = {0};

// デバイスの情報を取得する
shell->GetDeviceInfo(&deviceInfo);

参照

BREW API ISHELL_GetDeviceInfo | BREW API AEEDeviceInfo | SFXDevice

戻り値

解説

この関数は、 指定されたデバイス項目 ID に関する情報を取得します。

使用例

チップ ID に関する情報を取得します。

SFBShellSmp     shell    = SFBShell::GetInstance();
WChar           data[32] = {0};
SInt32          size;

// デバイスの情報（チップ ID）を取得する
shell->GetDeviceInfoEx(AEE_DEVICEITEM_CHIP_ID, data, &size);

参照

BREW API ISHELL_GetDeviceInfoEx | AEEDeviceItem | SFXDevice

戻り値

関連付けられたハンドラクラスの AEECLSID。 それ以外の場合、0。

解説

この関数は、 コンテンツビューアおよびプロトコル方式のハンドラを AEE シェルから取得します。

参照

BREW API ISHELL_GetHandler | AEEHandlerType | SFBShell::RegisterHandler

戻り値

SFBShell インスタンス。

解説

この関数は、 SFBShell インスタンスを取得します。

使用例

SFBShell インスタンスを取得します。

SFBShellSmp     shell = SFBShell::GetInstance();

解説

この関数は、 メニュー、アイコン、またはリスト項目のデフォルトスタイルに関する情報を AEE シェルから取得します。

参照

BREW API ISHELL_GetItemStyle | AEEItemType | AEEItemStyle

解説

この関数は、 指定された秒数に基づいて JulianType データ構造体を取得します。

参照

BREW API ISHELL_GetJulianDate | JulianType | GET_JULIANDATE | SFBShell::GetTimeMS | SFBShell::GetUpTimeMS | GET_SECONDS | GET_TIMEMS | GETTIMESECONDS | GETTIMEMS

戻り値

解説

この関数は、 指定された ClassID のアプリまたはクラスのレベルプリファレンスが含まれる構造体を取得します。

参照

BREW API ISHELL_GetPrefs | SFBShell::SetPrefs

戻り値

解説

この関数は、 入力クラスに関連付けられている基本モジュールのプロパティデータを取得します。

バージョン

この関数は、BREW 3.1 から使用可能です。

参照

BREW API ISHELL_GetProperty | SFBShell::SetProperty

戻り値

見つかったリソースのサイズ。 失敗した場合、0。

解説

この関数は、 指定されたリソースファイルから指定されたタイプと ID のリソースをロードします。

SFBShell::LoadResDataEx 関数のラッパー関数です。

参照

BREW API ISHELL_GetResSize | SFBShell::LoadResDataEx

戻り値

午前零時からの経過時間。 [単位: ミリ秒]

解説

この関数は、 現在の時刻を取得します。[単位: ミリ秒]

参照

BREW API ISHELL_GetTimeMS | SFBShell::GetUpTimeMS | SFBShell::GetJulianDate

戻り値

デバイスのユーザーコールバックまたはユーザーデータに関連付けられたタイマーが満了するまでの残存時間。[単位: ミリ秒]

タイマーが満了している場合、0。

解説

この関数は、 指定されたデバイスのユーザーコールバックまたはユーザーデータに関連付けられたタイマーが満了するまでの残存時間をで取得します。[単位: ミリ秒]

使用例

タイマー満了までの残り時間を取得します。

// タイマー用コールバック関数
static Void OnTimerEntry(VoidPtr arg);

SFBShellSmp     shell    = SFBShell::GetInstance();
UInt32          duration = 0;

// タイマー満了までの残り時間を取得する
duration = shell->GetTimerExpiration(OnTimerEntry, this);

参照

BREW API ISHELL_GetTimerExpiration | PFNNOTIFY | SFBShell::SetTimer | SFBShell::CancelTimer

戻り値

デバイスに電源が投入されてからの経過時間。[単位: ミリ秒]

解説

この関数は、 デバイスに電源が投入されてからの経過時間を取得します。[単位: ミリ秒]

参照

BREW API ISHELL_GetUpTimeMS | SFBShell::GetTimeMS | SFBShell::GetJulianDate

戻り値

解説

この関数は、 指定された標準 AEE イベントを現在アクティブなアプリに送信します。

標準 AEE イベントとは、 EVT_COMMAND 以上 EVT_USER 未満の範囲にあるイベントです。

	注意
	この関数は、内部的に ClassID に 0 を指定して SFBShell::SendEvent 関数を呼び出します。 EVT_COMMAND 以上 EVT_USER 未満の範囲のイベントのみ送信可能です。 EVT_USER 以上のイベントは送信できません。 EVT_USER 以上のイベントを送信する場合は、 SFBShell::SendEvent / SFBShell::PostEvent 関数を使用します。 この関数は、ユーザーがコントロールを実装する場合に使用します。 たとえば、コントロールがイベント EVT_CTL_TAB イベントを現在アクティブなアプリに送信する場合に使用します。 一般に、アプリがイベントを自分自身、または他のアプリに送信するには、 SFBShell::SendEvent または SFBShell::PostEvent 関数を使用します。

	イベント固有の 16 / 32 ビット値の検査について
	AEE シェルは、イベント固有の 16 / 32 ビット値を検査しません。

参照

BREW API ISHELL_HandleEvent | AEEEvent | SFBShell::SendEvent | SFBShell::PostEvent

戻り値

解説

この関数は、 指定されたリソースファイルのエントリが、 指定されたタイプについて有効かどうかを判定します。

resType 引数に有効な値は以下のとおりです。

handlerType 引数に有効な値は以下のとおりです。

参照

BREW API ISHELL_IsValidResource | ResType | AEEHandlerType

戻り値

指定されたファイルから読み込んだビットマップ。

エラーの場合は null。

解説

この関数は、 指定されたファイルからビットマップを直接ロードします。

参照

BREW API ISHELL_LoadBitmap | SFBShell::LoadResBitmap SFBShell::LoadImage | SFBShell::LoadResData | SFBShell::LoadResDataEx | SFBShell::LoadResImage | SFBShell::LoadResObject | SFBShell::LoadResSound | SFBShell::LoadSound | SFBBitmap

戻り値

BREW がビジーであることを示すために使われる画像。

エラーの場合は null。

解説

この関数は、 BREW がビジーであることを示すために使われる画像をロードします。

参照

BREW API ISHELL_LoadBusyImage | SFBShell::LoadImage | SFBShell::LoadBitmap SFBShell::LoadResBitmap SFBShell::LoadResData | SFBShell::LoadResDataEx | SFBShell::LoadResImage | SFBShell::LoadResObject | SFBShell::LoadResSound | SFBShell::LoadResString | SFBShell::LoadSound | SFBShell::FreeResData | SFBImage

戻り値

指定されたファイルから読み込んだイメージデータ。

エラーの場合は null。

解説

この関数は、 指定されたファイルからイメージデータを直接ロードします。

参照

BREW API ISHELL_LoadImage | SFBShell::LoadBitmap SFBShell::LoadResBitmap SFBShell::LoadResData | SFBShell::LoadResDataEx | SFBShell::LoadResImage | SFBShell::LoadResObject | SFBShell::LoadResSound | SFBShell::LoadResString | SFBShell::LoadSound | SFBShell::FreeResData | SFBImage

戻り値

指定されたリソースファイル内の指定されたリソース ID のビットマップ。

エラーの場合は null。

解説

この関数は、 指定されたリソースファイル内の指定されたリソース ID のビットマップをロードします。

使用例

リソースファイルからビットマップを取得し、 端末画面に表示します。

// リソースファイルから読み込むビットマップのリソース ID
#define IDB_MY_PICTURE  0x0001

SFBShellSmp         shell   = SFBShell::GetInstance();
SFBDisplaySmp       display = SFBDisplay::NewInstance();
SFBBitmapSmp        bmp;

// リソースファイルからビットマップを取得する
bmp = shell->LoadResBitmap(MYRESOURCE_RES_FILE, IDB_MY_PICTURE);

if (bmp != null) {
    // ビットマップを描画する
    display->BitBlt(SFXRectangle(0, 0, 100, 100), bmp, SFXGrid(0, 0));

    // 画面を更新する
    display->Update();
}

参照

BREW API ISHELL_LoadResBitmap | SFBShell::LoadBitmap | SFBBitmap

戻り値

リソースファイルからロードしたデータブロック。

エラーの場合は null。

解説

この関数は、 指定されたリソースファイル内の指定されたリソース ID、リソースタイプのデータブロックをロードします。

参照

BREW API ISHELL_LoadResData | ResType | SFBShell::FreeResData | SFBShell::LoadImage | SFBShell::LoadBitmap SFBShell::LoadResBitmap SFBShell::LoadResDataEx | SFBShell::LoadResImage | SFBShell::LoadResObject | SFBShell::LoadResSound | SFBShell::LoadResString | SFBShell::LoadSound

戻り値

指定されたリソースファイル内の指定されたリソース ID、リソースタイプのデータブロック （データは buf 引数に指定したバッファに格納されます）。

エラーの場合は null。

解説

この関数は、 指定されたリソースファイル内の指定されたリソース ID、リソースタイプのデータブロックをロードします （データは buf 引数に指定したバッファに格納されます）。

参照

BREW API ISHELL_LoadResDataEx | SFBShell::LoadImage | SFBShell::LoadBitmap SFBShell::LoadResBitmap SFBShell::LoadResData | SFBShell::LoadResImage | SFBShell::LoadResObject | SFBShell::LoadResSound | SFBShell::LoadResString | SFBShell::LoadSound | SFBShell::FreeResData | AEEResBlob

戻り値

指定されたリソースファイル内の指定されたリソース ID のイメージ。

エラーの場合は null。

解説

この関数は、 指定されたリソースファイル内の指定されたリソース ID のイメージをロードします。

使用例

リソースファイルからビットマップイメージを取得し、 端末画面に表示します。

// リソースファイルから読み込むビットマップのリソース ID
#define IDB_MY_PICTURE  0x0001

SFBShellSmp     shell     = SFBShell::GetInstance();
SFBImageSmp     image;
AEEImageInfo    imageInfo = {0};

// リソースファイルからイメージ（ビットマップイメージ）を取得する
image = shell->LoadResImage(MYRESOURCE_RES_FILE, IDB_MY_PICTURE);

if (image != null) {
    // イメージの情報を取得する
    image->GetInfo(&imageInfo);

    // SFBImage オブジェクトがイメージを持つかを確認する
    if (imageInfo.cx == 0) {
        DBGPRINTF("Failed to load image ... !");
        image.Release();
    }
    else {
        // イメージを描画する
        image->Draw(0, 0);
    }
}

参照

BREW API ISHELL_LoadResImage | SFBShell::LoadImage | SFBShell::LoadResData | SFBShell::LoadResDataEx | SFBShell::LoadResObject | SFBShell::LoadResSound | SFBShell::LoadResString | SFBShell::LoadSound | SFBShell::FreeResData | SFBImage

戻り値

指定されたリソースファイル内の指定されたリソース ID、リソースタイプのオブジェクト。

エラーの場合は null。

解説

この関数は、 指定されたリソースファイル内の指定されたリソース ID、リソースタイプのオブジェクトをロードします。

参照

BREW API ISHELL_LoadResObject | SFBShell::LoadImage | SFBShell::LoadBitmap SFBShell::LoadResBitmap SFBShell::LoadResData | SFBShell::LoadResDataEx | SFBShell::LoadResImage | SFBShell::LoadResSound | SFBShell::LoadResString | SFBShell::LoadSound | SFBShell::FreeResData | SFBBase

戻り値

指定されたリソースファイル内の指定されたリソース ID の音声データ。

エラーの場合は null。

解説

この関数は、 指定されたリソースファイル内の指定されたリソース ID の音声データをロードします。

	注意
	この関数は、 リソースファイルに未加工のストリームバイトのサウンドデータが含まれている場合に使用します。

参照

BREW API ISHELL_LoadResSound | SFBShell::LoadImage | SFBShell::LoadBitmap SFBShell::LoadResBitmap SFBShell::LoadResData | SFBShell::LoadResDataEx | SFBShell::LoadResImage | SFBShell::LoadResObject | SFBShell::LoadResString | SFBShell::LoadSound | SFBSoundPlayer

戻り値

戻り値が SInt32 型の場合:

指定されたリソースファイル内の指定されたリソース ID の UNICODE または ISOLATIN 文字列の長さ （データは buf 引数に指定したバッファに格納されます）。エラーの場合は 0。

解説

この関数は、 指定されたリソースファイル内の指定されたリソース ID の UNICODE または ISOLATIN 文字列をロードします （文字列は buf 引数に指定したバッファに格納されます）。

使用例

リソースファイルから文字列を取得し、 端末画面に表示します。

// リソースファイルから読み込む文字列のリソース ID
#define IDS_MY_LETTERS  0x0011

SFBShellSmp         shell   = SFBShell::GetInstance();
SFBDisplaySmp       display = SFBDisplay::NewInstance();
SFXWideString       string;

// リソースファイルから文字列を取得する
if (shell->LoadResString(MYRESOURCE_RES_FILE, IDS_MY_LETTERS, &string)) {

    // 画面に文字列を表示する
    display->DrawText(AEE_FONT_BOLD, string, -1, 0, 0, null, IDF_ALIGN_CENTER | IDF_ALIGN_MIDDLE);

    // 画面を更新する
    display->Update();
}

参照

BREW API ISHELL_LoadResString | SFBShell::LoadImage | SFBShell::LoadBitmap SFBShell::LoadResBitmap SFBShell::LoadResData | SFBShell::LoadResDataEx | SFBShell::LoadResImage | SFBShell::LoadResObject | SFBShell::LoadResSound | SFBShell::LoadSound | SFXWideString

戻り値

指定されたファイルから読み込んだサウンドデータ。

エラーの場合は null。

解説

この関数は、 指定されたファイルからサウンドデータをロードします。

	注意
	この関数は、内部で SFBShell::LoadResObject 関数を呼び出します。

参照

BREW API ISHELL_LoadSound | SFBShell::LoadResObject | SFBShell::LoadImage | SFBShell::LoadBitmap SFBShell::LoadResBitmap SFBShell::LoadResData | SFBShell::LoadResDataEx | SFBShell::LoadResImage | SFBShell::LoadResSound | SFBShell::LoadResString | SFBShell::FreeResData | SFBSoundPlayer

引数

戻り値

解説

この関数は、 指定されたリソースファイルから指定された ID のタイトルとテキストを取得し、 メッセージボックスを作成して表示します。

	注意
	メッセージボックスは、タイトルとテキストを表示するウィンドウです。 CLR キーを押下すると閉じます。

	注意
	タイトルまたはテキストのいずれかが最大サイズを超える場合は、 メッセージボックスは作成されません。

参照

BREW API ISHELL_MessageBox | SFBShell::MessageBoxText

戻り値

解説

この関数は、 指定されたタイトル文字列とテキスト文字列からメッセージボックスを作成し表示します。

	注意
	メッセージボックスは、タイトルとテキストを表示するウィンドウです。 CLR キーを押下すると閉じます。

	注意
	タイトルまたはテキストのいずれかが最大サイズを超える場合は、 メッセージボックスは作成されません。

参照

BREW API ISHELL_MessageBoxText | SFBShell::MessageBox

戻り値

解説

この関数は、 指定されたアプリに指定されたイベントが発生したことを通知します。

	注意
	イベントマスクは発生したイベントの種類を表し、 イベントを発行するクラスで定義します。 イベントが発生すると、 SFBShell::RegisterNotify 関数でに登録したすべてのアプリが呼び出されます。 指定されたアプリが現在アクティブでない場合は、ロードされイベントが送られます。 この場合は、EVT_APP_START または EVT_APP_STOP イベントは送られません。 イベントに基づいてアプリを起動する場合は、 SFBShell::StartApplet 関数を呼び出す必要があります。

参照

BREW API ISHELL_Notify | SFBShell::RegisterNotify | SFBShell::StartApplet

解説

この関数は、 アプリ終了時に呼び出されるコールバックを登録します。

参照

BREW API ISHELL_OnAppClose | SFXCallback

解説

この関数は、 BREW 終了時に呼び出されるコールバックを登録します。

参照

BREW API ISHELL_OnExit | SFXCallback

解説

この関数は、 BREW 初期化時に呼び出されるコールバックを登録します。

参照

BREW API ISHELL_OnInit

解説

この関数は、 システムのメモリが少量になったときに呼び出されるコールバックを登録します。

	注意
	この関数を利用して、 アプリはメモリのクリーンアップを行い、システム用にメモリを解放することが可能です。

参照

BREW API ISHELL_OnLowRAM

バージョン

この関数は、BREW 3.1 から使用可能です。

解説

この関数は、 システムメモリが少なくなり、SFBShell::OnLowRAM 関数で登録する AEE_SCB_LOW_RAM コールバックによっても充分なメモリを確保できない場合に呼び出されるコールバックを登録します。

	注意
	この関数を利用して、 アプリはメモリのクリーンアップを行い、システム用にメモリを解放することが可能です。 コールバックを正常に登録するためには、 呼び出し側アプリが AEEGROUPID_LOW_RAM グループに属している必要があります。

参照

BREW API ISHELL_OnLowRAMCritical | SFBShell::OnLowRAM

解説

この関数は、 ファイルシステム容量が少量になったときに呼び出されるコールバックを登録します。

	注意
	この関数を利用して、 アプリはファイルシステムのクリーンアップを行い、システム用にファイルシステム容量を解放することが可能です。

参照

BREW API ISHELL_OnLowStorage

解説

この関数は、 モジュールがアンロードされる直前に呼び出されるコールバックを登録します。

	注意
	コールバックはクライアント側で割り当てる必要があります。

参照

BREW API ISHELL_OnModUnload | SFBShell::RegisterSystemCallback

戻り値

解説

この関数は、 指定されたアプリに指定された非同期イベントをポストします。

clsid 引数にアプリの ClassID を指定することで、 EVT_USER 以上のユーザーイベントをアプリにポストすることが可能です。 ClassID を指定せずに EVT_USER 以上のイベントをポストした場合、イベントのポストは失敗します。

戻り値は、イベントが正常にポスト（イベントキューに追加）されたかどうかのみを表します。 イベントが正常に受信側アプリへ送信されたことを意味しません。

	SFBShell::SendEvent 関数との違い
	SFBShell::SendEvent 関数がアプリに即座にイベントを送信するのに対し、 この関数は、アプリにイベントをポスト（イベントキューに追加）するだけです。 アプリが EVT_APP_STOP イベントを受信して終了処理を行うときに、 イベントキューにポストされて残っているイベントはキャンセルされ、アプリには送信されません。

	SFBShell::PostEventEx 関数との違い
	この関数は、 SFBShell::PostEventEx 関数と異なり、 アプリに対して同一タイプのイベント（＝同じイベントコードを持つイベント）を複数ポストできません。

	イベント固有の 16 / 32 ビット値の検査について
	AEE シェルは、イベント固有の 16 / 32 ビット値を検査しません。

使用例

アプリに強制再描画イベントをポストします。

SFBShellSmp     shell = SFBShell::GetInstance();

// アプリに強制再描画イベントをポストする
shell->PostEvent(SFCApplet::GetClassID(), SFXEvent(SREVT_RESPONDER_RENDER, SRP16_RENDER_INVOKE, true));

参照

BREW API ISHELL_PostEvent | AEEEvent | AEECLSID | SFBShell::PostEventEx | SFBShell::SendEvent

戻り値

解説

この関数は、 指定されたアプリに指定された非同期イベントをポストします。

clsid 引数にアプリの ClassID を指定することで、 EVT_USER 以上のユーザーイベントをアプリに送信することが可能です。 ClassID を指定せずに EVT_USER 以上のイベントをポストした場合、イベントのポストは失敗します。

戻り値は、イベントが正常にポスト（イベントキューに追加）されたかどうかのみを表します。 イベントが正常に受信側アプリへ送信されたことを意味しません。

	注意
	SFBShell::SendEvent 関数がアプリに即座にイベントを送信するのに対し、 この関数は、アプリにイベントをポスト（イベントキューに追加）するだけです。 アプリが EVT_APP_STOP イベントを受信して終了処理を行うときに、 イベントキューにポストされて残っているイベントはキャンセルされ、アプリには送信されません。

	SFBShell::PostEvent 関数との違い
	この関数は、 SFBShell::PostEvent 関数と異なり、 アプリに対して同一タイプのイベント（＝同じイベントコードを持つイベント）を複数ポストできます。

	flags 引数について
	一般に、flags 引数には 0 を指定します。 EVTFLG_UNIQUE を指定することもできますが、 このフラグはこのイベントタイプの 1 つだけをいつでも待機中にできることを示すものです。 この場合は、この関数は、SFBShell::PostEvent 関数と同じになります。

	イベント固有の 16 / 32 ビット値の検査について
	AEE シェルは、イベント固有の 16 / 32 ビット値を検査しません。

バージョン

この関数は、BREW 2.1 から使用可能です。

参照

BREW API ISHELL_PostEventEx | AEEEvent | AEECLSID | SFBShell::PostEvent | SFBShell::SendEvent

戻り値

解説

この関数は、 URL のスキームに関連付けられたアプリに対し、 非同期のイベントとして EVT_APP_POST_URL イベントをポストします。

	注意
	戻り値は、イベントが正常にイベントキューに追加されたかどうかのみを表します。 イベントが正常に受信側アプリへ送られたことは表しません。

バージョン

この関数は、BREW 3.1 から使用可能です。

参照

BREW API ISHELL_PostURL | SFBShell::PostEvent

戻り値

解説

この関数は、 マルチ選択のプロンプトを表示します。

参照

BREW API ISHELL_Prompt | AEEPromptInfo

戻り値

解説

この関数は、 指定された ClassID のクラスまたはアプリがサポートされているかどうかを判定します。

	注意
	AEEAppInfo 構造体を渡した場合は、 要求されたクラスが利用可能であってもアプリでなければ false が返されます。

参照

BREW API ISHELL_QueryClass | AEEAppInfo | SFBShell::CreateInstance

戻り値

指定されたイベント名に関連付けられているイベント（AEEEvent）。

イベントを登録できなかった場合、0。

解説

この関数は、 指定されたイベント名を基に他のユーザーイベントと競合しないイベント（AEEEvent）を登録します。

以下の点に注意してください。

	注意
	ユーザーイベントとは、EVT_USER 以上のイベントです。

バージョン

この関数は、BREW 3.1 から使用可能です。

参照

BREW API ISHELL_RegisterEvent | AEEEvent

戻り値

解説

この関数は、 指定されたハンドラを AEE シェルに登録します。

	注意
	コンテンツビューアまたはプロトコルエンジンが自らを AEE シェルに登録します。 このメカニズムによりほかのコンポーネントは、 コンテンツまたはプロトコルタイプに問題が発生した場合に機能を共有できます。 ハンドラはクラスにより指定されるため、必要に応じてダイナミックにロードされます。

参照

BREW API ISHELL_RegisterHandler | AEEHandlerType | SFBShell::GetHandler

引数

戻り値

解説

この関数は、 他のクラスから発行される通知を登録します。

参照

BREW API ISHELL_RegisterNotify | BREW API INOTIFIER_SetMask | BREW API GET_NOTIFIER_MASK | BREW API GET_NOTIFIER_VAL | AEENotifyFailure | SFBShell::Notify

解説

この関数は、 BREW の起動や終了、アプリの終了、モジュールのアンロードなどのシステムイベントに対するコールバックを登録します。

コールバックはクライアント側で割り当てる必要があります。 type 引数に指定できる値は以下のとおりです。

参照

BREW API ISHELL_RegisterSystemCallback | SFXCallback | SFBShell::OnInit | SFBShell::OnLowRAM | SFBShell::OnLowStorage | SFBShell::OnModUnload

戻り値

解説

この関数は、 デバイスをリセットします。

リセットには、ソフトリセットとハードリセットの 2 つのオプションがあります。

ソフトリセットオプションは、BREW を終了し、再初期化します。 BREW 終了時にコール側のアプリは停止します。

ハードリセットオプションは、デバイスの電源を OFF/ON します。

いずれのリセットオプションにおいても、コール側のアプリは自動的に再起動しません。

	注意
	この関数を使用するには、SYSTEM 特権レベルが必要です。

バージョン

この関数は、BREW 3.1 から使用可能です。

参照

BREW API ISHELL_Reset | AEEResetType

解説

この関数は、 AEE シェルにコールバックを登録します （コールバックを AEE シェルの待機中操作リストに追加します）。

	注意
	AEE シェルは、次回のイベントループで AEE シェルの待機中操作リストからコールバックを呼び出します。

参照

BREW API ISHELL_Resume | SFXCallback

戻り値

解説

この関数は、 BREW アラーム機能を再開します。

	注意
	期限が既に過ぎているすべてのアラームのイベントがスケジューリングされます。

バージョン

この関数は、BREW 3.1 から使用可能です。

参照

BREW API ISHELL_ResumeAlarms | SFBShell::SuspendAlarms | SFBShell::SetAlarm | SFBShell::CancelAlarm

戻り値

解説

この関数は、 指定されたアプリ（またはダイアログ）に指定された同期イベントを送信します。

clsid 引数にアプリの ClassID を指定することで、 EVT_USER 以上のユーザーイベントをアプリに送信することが可能です。 ClassID を指定せずに EVT_USER 以上のイベントを送信した場合、イベントの送信は失敗します。

アプリが現在実行されていない場合は、そのアプリがロードされイベントが直接送られます。 この場合は、アプリはバックグラウンドで起動されます （EVT_APP_START および EVT_APP_STOP イベントはアプリに送信されません）。

SFBShell::CreateDialog 関数で作成したダイアログがアクティブである場合、 イベントがアプリに渡される前にそのダイアログに渡されます。 なお、このイベントは、 ダイアログがイベントを処理しない場合にのみアプリに渡されます。

	SFBShell::PostEvent 関数との違い
	この関数がアプリに即座にイベントを送信するのに対し、 SFBShell::PostEvent 関数はアプリにイベントをポスト（イベントキューに追加）するだけです。

	イベント固有の 16 / 32 ビット値の検査について
	AEE シェルは、イベント固有の 16 / 32 ビット値を検査しません。

	非同期イベントについて
	EVT_KEY / EVT_KEY_PRESS / EVT_KEY_RELEASE / EVT_PEN_DOWN / EVT_PEN_UP / EVT_PEN_MOVE / EVT_JOYSTICK_POS / EVT_CHAR, EVT_UPDATECHAR イベントは非同期イベントです。 これらのイベントは、この関数を使用しても、非同期にポスト（イベントキューに追加）されるだけです。

使用例

アプリに強制再描画イベントを送信します。

SFBShellSmp         shell = SFBShell::GetInstance();

// アプリに強制再描画イベントを送信する
shell->SendEvent(SFCApplet::GetClassID(), SFXEvent(SREVT_RESPONDER_RENDER, SRP16_RENDER_INVOKE, true));

参照

BREW API ISHELL_SendEvent | AEEEvent | AEECLSID | SFBShell::PostEvent | SFBShell::PostEventEx | SFBShell::CreateDialog

戻り値

解説

この関数は、 URL のスキームに関連付けられたアプリに対し、同期のイベントとして EVT_APP_POST_URL イベントを送ります。

BREW はアプリに URL を渡す前に、内部に URL をコピーします。

SFBShell::BrowseURL 関数と異なり、 この関数はアプリをアクティブにしません。 この関数は、SFBShell::SendEvent 関数と同じ動作をします。

EVT_APP_POST_URL イベントを受信したアプリをフォアグラウンドで処理した場合は、 自分自身に対して SFBShell::StartApplet 関数を呼び出す必要があります。

EVT_APP_POST_URL イベントを受信したアプリをバックグラウンドで処理したい場合は、 自分自身に対して SFBShell::StartBackgroundApplet 関数を呼び出す必要があります。

バージョン

この関数は、BREW 3.1 から使用可能です。

参照

BREW API ISHELL_PostURL | SFBShell::BrowseURL | SFBShell::StartApplet | SFBShell::StartBackgroundApplet | SFBShell::SendEvent | SFBShell::PostEvent

戻り値

解説

この関数は、 （満了までの時間が長い）アラームをアプリに設定します。

アラームが発生した場合、 clsid 引数に指定したアプリがロードされ、 code 引数に指定した 16 ビット値を持つ EVT_ALARM イベントが渡されます。

このとき、EVT_APP_START イベントは送られません。 アプリをアクティブにするには、SFBShell::StartApplet 関数を呼び出します。

code 引数に 16 ビット値を指定することにより、 1 つのアプリに複数のアラームを設定できます。

参照

BREW API ISHELL_SetAlarm | SFBShell::CancelAlarm | SFBShell::StartApplet | SFBShell::SuspendAlarms | SFBShell::ResumeAlarms

戻り値

常に SFERR_NO_ERROR。

解説

この関数は、 指定されたアプリ固有のプリファレンスが含まれる構造体を設定します。

	注意
	アプリ特有の設定や基本設定を持続的に保存したり取得することができます （この情報はファイルに保存されます）。 基本設定を取得するには、SFBShell::GetAppPrefs 関数を使用します。

参照

BREW API ISHELL_SetAppPrefs | SFBShell::GetAppPrefs

戻り値

解説

この関数は、 指定されたアプリ固有のプリファレンスを設定します。

参照

BREW API ISHELL_SetPrefs | SFBShell::GetPrefs

戻り値

解説

この関数は、 指定された Class ID に関連付けられている基本モジュールのプロパティを設定します。

バージョン

この関数は、BREW 3.1 から使用可能です。

参照

BREW API ISHELL_SetProperty | AEECLSID | SFBShell::GetProperty | SFBShell::ClearProperty

戻り値

解説

この関数は、タイマーを設定します。[単位: ミリ秒]

タイマーに設定した時間が経過した場合は、指定したコールバック関数が呼び出され、 コールバック関数の第 1 引数として、指定したユーザーデータのポインタが渡されます。

以下の点に注意してください。

使用例

タイマーを使用して四角形を右方向に移動します。

#define TIMER_VAL   100

// シェイプクラスのクラス定義
SFMTYPEDEFCLASS(Shape)
class Shape :public SFRApplication
{
private:
    SFXRectangle    _rect;

public:
    static SFCInvokerPtr ructorConst() { return new Shape; }
private:
    Shape::Shape()
    {
        SFBShellSmp shell = SFBShell::GetInstance();

        // 描画ハンドラを登録する
        RegisterHandler(SREVT_RESPONDER_RENDER, SRP16_RENDER_CONTENT, HANDLER_BEFORE, OnDrawEntry, this);

        // タイマーを設定する
        shell->SetTimer(TIMER_VAL, OnTimerEntry, this);

        // 四角形を初期化する
        _rect.Set(0, 0, 32, 32);
    }

    // 描画ハンドラ
    Void OnDraw(SFXGraphicsPtr);
    static Bool OnDrawEntry(SFXEventConstRef event, VoidPtr data)
    {
        ShapePtr(data)->OnDraw(SFXGraphicsPtr(event.P32()));
        return true;
    }

    // タイマーハンドラ
    Void OnTimer(Void);
    static Void OnTimerEntry(VoidPtr data)
    {
        ShapePtr(data)->OnTimer();
    }
};

//
// タイマーで呼び出される関数
//
Void Shape::OnTimer(Void)
{
    SFBShellSmp     shell = SFBShell::GetInstance();

    // 四角形を右方向へ 3 移動する
    _rect.Offset(3, 0);

    // アプリに強制再描画イベントをポストする
    shell->PostEvent(SFCApplet::GetClassID(), SFXEvent(SREVT_RESPONDER_RENDER, SRP16_RENDER_INVOKE, true));

    // 再度タイマーを設定する
    shell->SetTimer(TIMER_VAL, OnTimerEntry, this);
}

//
//    描画ハンドラ
//
Void Shape::OnDraw(SFXGraphicsPtr g)
{

    SFBShellSmp   shell = SFBShell::GetInstance();

    // 背景を白色で塗りつぶす
    g->SetBackground(SFXRGBColor(255, 255, 255));
    g->ClearRect(GetContentWorld());

    // 赤色で塗り潰した四角形を描画する
    g->SetFillMode(true);
    g->SetFillColor(SFXRGBColor(255, 0, 0));
    g->DrawRect(_rect);
}

参照

BREW API ISHELL_SetTimer | BREW API IApplet | PFNNOTIFY | SFBShell::GetTimerExpiration | SFBShell::CancelTimer

戻り値

解説

この関数は、 コールバック構造体を使用してタイマーを設定します。[単位: ミリ秒]

タイマーに設定した時間が経過した場合は、指定したコールバック関数が呼び出され、 コールバック関数の第 1 引数として、指定したユーザーデータのポインタが渡されます。

以下の点に注意してください。

使用例

タイマーを使用して四角形を右方向に移動します。

#define TIMER_VAL   100

// シェイプクラスのクラス定義
SFMTYPEDEFCLASS(Shape)
class Shape : public SFRApplication
{
private:
    SFXRectangle      _rect;
    SFXCallback   _callback;

public:
    static SFCInvokerPtr ructorConst() { return new Shape; }
private:
    Shape::Shape()
    {
        SFBShellSmp shell = SFBShell::GetInstance();

        // 描画ハンドラを登録する
        RegisterHandler(SREVT_RESPONDER_RENDER, SRP16_RENDER_CONTENT, HANDLER_BEFORE, OnDrawEntry, this);

        // タイマーを設定する
        shell->SetTimerEx(TIMER_VAL, &_callback);

        // 四角形を初期化する
        _rect.Set(0, 0, 32, 32);
    }

    // 描画ハンドラ
    Void OnDraw(SFXGraphicsPtr);
    static Bool OnDrawEntry(SFXEventConstRef event, VoidPtr data)
    {
        ShapePtr(data)->OnDraw(SFXGraphicsPtr(event.P32()));
        return true;
    }

    // タイマーハンドラ
    Void OnTimer(Void);
    static Void OnTimerEntry(VoidPtr data)
    {
        ShapePtr(data)->OnTimer();
    }
};

//
// タイマーで呼び出される関数
//
Void Shape::OnTimer(Void)
{
    SFBShellSmp  shell = SFBShell::GetInstance();

    // 四角形を右方向へ 3 移動する
    _rect.Offset(3, 0);

    // アプリに強制再描画イベントをポストする
    shell->PostEvent(SFCApplet::GetClassID(), SFXEvent(SREVT_RESPONDER_RENDER, SRP16_RENDER_INVOKE, true));

    // 再度タイマーを設定する
    shell->SetTimerEx(TIMER_VAL, &_callback);
}

//
//    描画ハンドラ
//
Void Shape::OnDraw(SFXGraphicsPtr g)
{

    SFBShellSmp   shell = SFBShell::GetInstance();

    // 背景を白色で塗りつぶす
    g->SetBackground(SFXRGBColor(255, 255, 255));
    g->ClearRect(GetContentWorld());

    // 赤色で塗り潰した四角形を描画する
    g->SetFillMode(true);
    g->SetFillColor(SFXRGBColor(255, 0, 0));
    g->DrawRect(_rect);
}

参照

BREW API ISHELL_SetTimerEx | AEECallback | SFBShell::SetTimer | SFBShell::CancelTimer

戻り値

参照

BREW API ISHELL_ShowCopyright

戻り値

解説

この関数は、 指定されたアプリをフォアグラウンドで起動します。

要求されたアプリがサポートされていて起動可能な場合は、 AEE シェルはアプリをロードしてそれを起動します。 この関数呼び出しはアプリの起動前に即座に呼び出し側に戻ることに注意してください。

アプリは非同期で起動されるため、 指定されたアプリの ClassID が見つからなかった場合は、 この関数の戻り値が SFERR_NO_ERROR であってもアプリは起動しません。

起動されたアプリは、 EVT_APP_START または EVT_APP_RESUME イベントを受信します （このとき、32 ビット値として AEEAppStart 構造体へのポインタが渡されます）。

他のアプリによりアプリが起動された場合は、 現在アクティブなアプリはサスペンドされた状態になります。

	注意
	この関数は、非同期の関数です。 新しいアプリは、コントロールがシステムに開放されるまで起動されません。 この関数により、 新しいアプリが起動する直前に、 現在アクティブなアプリは EVT_APP_SUSPEND イベントを受け取ります。 アプリが最後に実行されたときに正常に終了しなかった場合は、 EBADSHUTDOWN が返ります。

使用例

指定した ClassID のアプリ（サンプル アプリ）を起動します。

SFBShellSmp shell = SFBShell::GetInstance();

// アプリを起動する
shell->StartApplet(AEECLSID_SAMPLEAPPLET);

参照

BREW API ISHELL_StartApplet | AEECLSID | AEEAppStart | SFBShell::CreateInstance | SFBShell::CanStartApplet | SFBShell::CloseApplet | SFBShell::ActiveApplet | SFBShell::BrowseURL | SFBShell::SendURL

戻り値

解説

この関数は、 指定されたアプリを起動し、コマンドライン引数を渡します。

参照

BREW API ISHELL_StartAppletArgs | AEECLSID | SFBShell::CreateInstance | SFBShell::StartAppletEx | SFBShell::StartBackgroundApplet | SFBShell::BrowseFile | SFBShell::BrowseURL

戻り値

解説

この関数は、 指定されたフラグの内容で指定されたアプリをフォアグラウンドで起動します。

以下の点を除き、SFBShell::StartApplet 関数と同様に機能します。

	注意
	SSA_CONFIG と SSA_HIDDEN_CONFIG どちらのフラグも指定しなかった場合、 アプリは標準の EVT_APP_START イベントで起動することに注意してください。

使用例

SSA_CONFIG フラグを指定して ClassID が AEECLSID_SAMPLEAPPLET であるアプリ（サンプル アプリ）を起動します。 アプリは、起動時に EVT_APP_START の代わりに EVT_APP_CONFIG イベントを受信します。

SFBShellSmp shell = SFBShell::GetInstance();

// アプリを起動する
// SSA_CONFIG フラグを指定した場合、
// アプリは EVT_APP_CONFIG イベントで起動する
shell->StartAppletEx(AEECLSID_SAMPLEAPPLET, SSA_CONFIG);

参照

BREW API ISHELL_StartAppletEx | AEECLSID | SFBShell::StartApplet | SFBShell::BrowseFile | SFBShell::BrowseURL | SFBShell::SendURL

戻り値

解説

この関数は、 指定されたアプリをバックグラウンドで起動します。

指定されたアプリが既に起動されており、現在履歴に存在する場合は、 ENOTALLOWED が返されます。

	注意
	指定したアプリがバックグラウンドで起動する点を除き、 SFBShell::StartAppletArgs 関数と同じです。 起動されたアプリは、EVT_APP_START イベントの変わりに EVT_APP_START_BACKGROUND イベントを受信します。

バージョン

この関数は、BREW 3.1 から使用可能です。

参照

BREW API ISHELL_StartBackgroundApplet | AEECLSID | SFBShell::CreateInstance | SFBShell::StartAppletArgs | SFBShell::StartAppletEx | SFBShell::BrowseFile | SFBShell::BrowseURL | SFBShell::SendURL

戻り値

解説

この関数は、 BREW アラームサブシステムの操作を一時停止します。

	注意
	この関数は、アラームをスケジュールするアプリの機能には影響を与えません。 単に、SFBShell::ResumeAlarms 関数が呼び出されるまで、 または電話がリセットされるまでアラーム通知を延期するだけです。

バージョン

この関数は、BREW 3.1 から使用可能です。

参照

BREW API ISHELL_SuspendAlarms | SFBShell::ResumeAlarms | SFBShell::SetAlarm | SFBShell::CancelAlarm

戻り値

解説

この関数は、ハンドラの登録を解除します。

参照

BREW API ISHELL_RegisterHandler | SFBShell::RegisterHandler