クラス _Main

アプリの雛型を提供します。アプリは必ずこのクラスを継承して作成しなければなりません。

対象:
Flash7 Flash8
携帯向け PC向け

メソッド

setQuality

setQuality(quality:String):Void

レンダリング品質を設定します。

パラメータ:
quality レンダリング品質を指定します。次のいずれかを指定します。

_QUALITY_LOW 低いレンダリング品質。
_QUALITY_MEDIUM 普通のレンダリング品質。この設定は、テキストを含まないムービーに適しています。
_QUALITY_HIGH 高いレンダリング品質。デフォルトのレンダリング品質設定です。
_QUALITY_BEST 非常に高いレンダリング品質。

setTimer

setTimer():Void

タイマーによる paint() メソッド呼び出しを開始します。

killTimer

killTimer():Void

タイマーを停止します。

repaint

repaint():Void

paint() メソッド呼び出しを指示します。

getParameter

getParameter(key:String):String

アプリ起動時のパラメータを取得します。

パラメータ:
key 取得するパラメータのキー文字列を指定します。

戻り値:
キーに対応する値を返します。URLデコードは自動的に行われます。

getGraphics

getGraphics():_Graphics

_Graphics オブジェクトを取得します。

戻り値:
_Graphics オブジェクトを返します。

getKeypadState

getKeypadState():Number

キーパッド状態を取得します。

戻り値:
キーパッド状態を返します。

補足説明:
戻り値の各ビットの位置が「_Global.h」で定義されている _KEY_〜 に対応します。キーに対応するビットがONのときの値は keyBit(_KEY_〜) で取得でき、その値とAND("&")をとることで、キーが押されているか判定できます。

keyBit

keyBit(key:Number):Number

キーに対応するビットがONのときの値を取得します。

パラメータ:
key キーを指定します。「_Global.h」で定義されている _KEY_〜 を指定します。

戻り値:
キーに対応するビットがONのときの値を返します。

getResString

getResString(id:Number):String

文字列リソースから文字列を取得します。

パラメータ:
id 文字列リソースのIDを指定します。
ツール「string2xml」使用時に指定した「文字列リソース定義ファイル」で設定したIDを指定します。

戻り値:
取得した文字列を返します。

setSoftKey

setSoftKey(softkey:_SoftKey):Void

ソフトキーを適用します。

パラメータ:
softkey ソフトキー情報を保持する _SoftKey オブジェクト。null を指定すると、ソフトキーを解除します。

補足説明:
ソフトキーを適用すると、マウス操作でキーイベントが発生するようになります。getKeypadState() メソッドも有効です。
「GlobalDef.h」で _USE_SOFTKEY を定義した場合にのみ使用できます。

getMouseX

getMouseX():Number

マウスポインタX座標を取得します。

戻り値:
マウスポインタX座標を返します。

補足説明:
「GlobalDef.h」で _USE_MOUSE を定義した場合にのみ使用できます。

getMouseY

getMouseY():Number

マウスポインタY座標を取得します。

戻り値:
マウスポインタY座標を返します。

補足説明:
「GlobalDef.h」で _USE_MOUSE を定義した場合にのみ使用できます。

unuseFocus

unuseFocus():Void

フォーカス機能をOFFにします。

補足説明:
フォーカス機能とは、携帯において方向キーの上下入力を検知する機能のことです。
「GlobalDef.h」で _USE_FOCUS を定義した場合にのみ使用できます。

useFocus

useFocus():Void

フォーカス機能をONにします。

補足説明:
フォーカス機能とは、携帯において方向キーの上下入力を検知する機能のことです。
「GlobalDef.h」で _USE_FOCUS を定義した場合にのみ使用できます。

launch

launch(url:String, vars:LoadVars):Void

他のアプリを起動します。

パラメータ:
url URLを指定します。
vars URLの後ろに追加するパラメータを LoadVars オブジェクト形式で指定します。
パラメータが不要な場合、null を指定します。

start

start():Boolean

アプリが起動したら呼ばれるメソッドです。

戻り値:
true を返すと、タイマーによる paint() メソッド呼び出しが開始されます。
false を返すと、タイマーが停止した状態になります。

paint

paint():Void

タイマーにより呼び出されるメソッドです。また、repaint() メソッド実行時にも呼び出されます。

processEvent

processEvent(type:Number, param:Number):Void

各種イベントが通知されたときに呼ばれるメソッドです。

パラメータ:
type イベントのタイプが渡されます。
param イベントのパラメータが渡されます。パラメータの意味はイベントによって異なります。

補足説明:
イベントのタイプには、次のものがあります。
_KEY_PRESSED_EVENT キーが押されると通知されます。パラメータには、キーの種類が渡されます。キーの種類とは、「_Global.h」で定義されている _KEY_〜 です。
_KEY_RELEASED_EVENT キーが離されると通知されます。パラメータには、キーの種類が渡されます。キーの種類とは、「_Global.h」で定義されている _KEY_〜 です。
_MOUSE_DOWN_EVENT マウスボタンが押されると通知されます。パラメータは常に 0 です。
_MOUSE_MOVE_EVENT マウスポインタが移動すると通知されます。パラメータは常に 0 です。
_MOUSE_UP_EVENT マウスボタンが離されると通知されます。パラメータは常に 0 です。
_FOCUS_PREV_EVENT 携帯において方向キーの上が入力されると通知されます。パラメータは常に 0 です。
_FOCUS_NEXT_EVENT 携帯において方向キーの下が入力されると通知されます。パラメータは常に 0 です。

onLoadMovieStart

onLoadMovieStart():Void

_LoadMovie クラスの load() メソッドを実行すると、ロードが開始されたときに呼び出されます。

onLoadMovieError

onLoadMovieError(errorCode:String, httpStatus:Number):Void

_LoadMovie クラスの load() メソッドを実行すると、クリップをロードできなかった場合に呼び出されます。

パラメータ:
errorCode "URLNotFound" または "LoadNeverCompleted" のエラーの理由を示すストリング
httpStatus サーバーから返されたHTTPステータスコード

onLoadMovieProgress

onLoadMovieProgress(loadedBytes:Number, totalBytes:Number):Void

_LoadMovie クラスの load() メソッドを実行すると、ロードプロセスの進行時にリアルタイムに呼び出されます。

パラメータ:
loadedBytes ロード済みバイト数
totalBytes ロード対象ファイルの総バイト数

onLoadMovieComplete

onLoadMovieComplete(httpStatus:Number):Void

_LoadMovie クラスの load() メソッドを実行すると、ファイルのダウンロードが終了し、ロードされたムービークリップのメソッドとプロパティが使用可能になる前に呼び出されます。

パラメータ:
httpStatus サーバーから返されたHTTPステータスコード

onLoadMovieInit

onLoadMovieInit():Void

_LoadMovie クラスの load() メソッドを実行すると、クリップの先頭フレームのアクションが実行された後に呼び出されます。

onLoadText

onLoadText(text:String):Void

_LoadText クラスの load() メソッドを実行すると、テキスト読み込みが終了したときに呼び出されます。

パラメータ:
text 正常に読み込めた場合は読み込んだテキスト、読み込みに失敗した場合 null

onLoadVars

onLoadVars(success:Boolean, vars:LoadVars):Void

_LoadVars クラスの connect() メソッドを実行すると、サーバーから変数を受信したときに呼び出されます。

パラメータ:
success ロード処理が正常に完了した場合は true、正常に完了しなかった場合は false
vars 受信した変数

musicComplete

musicComplete(music:_Music):Void

_Music クラスの play() メソッドを実行すると、再生が完了したときに呼び出されます。

パラメータ:
music 再生が完了した _Music オブジェクト