PhoneSystem (DoJa-5.0 (APIリファレンス))

あるメニュー階層下のサブメニューのアイコンを一括設定します。引数 path によって、アイコンを一括設定したい階層の位置を指定し、引数 ids に静止画のエントリ ID の配列を指定することによって、どのメニューアイテムにどのアイコンを設定するかを指定します。

[図] トップメニューから、3番目 -- 1番目 -- 2番目のアイコンを設定する場合メニュー階層は、トップメニュー階層をルートとしたツリー構造としてモデル化されており、各メニュー階層には、その階層内の各メニューアイテムに 0, 1, 2, ... と、位置番号が割り振られています。引数 path には、ルートを長さ0の int 配列 (new int[0]) として、アイコンを設定したい階層までのパスを、位置番号を並べて指定します。例えば、右図において、トップメニュー (「i-mode」、「iアプリ」、「メール」、… がある階層) にアイコンを指定したい時には new int[0] を、色の付いている部分のアイコンを指定したい場合には new int[] {3, 1, 2} を、path として指定することとなります。

引数 ids には、上記のように指定した path 配下にあるメニューアイコンに設定する静止画の配列を、エントリ ID の配列として指定します。 ids[i] に指定された静止画エントリ ID は、位置番号 i のアイコン画像として設定されます。例えば、前掲の図において、色の付いている部分のアイコンを、 0番目から順に、エントリ ID が a, b, c, d, e の静止画としたい場合には、 new int[] {a, b, c, d, e} を、 ids として指定することとなります。なお、ある階層の、一部のアイコンを設定したくない場合には、 id として -1 を指定して下さい。 -1 が指定された部分のアイコン画像は変化しません。

アイコンの数よりも長い配列を指定した場合には、余分な要素は単に無視されます。余分な要素に不正な値が入っていた場合でも例外は発生しません。アイコンの数よりも短い配列を指定した場合には、足りない要素には -1 が指定されているものとみなされます。

どの位置にどのメニューアイテムが割り当てられているかは、機種によって異なります。別途提供されるメニュー構成図を参照しながら位置番号を設定してください。

このメソッドをサポートしていない実装も存在します。その場合には、例外 UnsupportedOperationException が発生します。

このメソッドをサポートしている実装では、少なくともトップメニュー (path = new int[0]) のアイコン画像が設定できることは保証されています。その他の階層のアイコン画像が設定できるかどうかは機種依存です。

パーミッションとしてテーマ設定が許可されているトラステッド i アプリのみ、このメソッドを呼び出すことができます。

フィールドの概要
`static int`	`ATTR_BACKLIGHT_OFF` バックライトの属性の一つで、オフであることを表します (=0)。
`static int`	`ATTR_BACKLIGHT_ON` バックライトの属性の一つで、オンであることを表します (=1)。
`static int`	`ATTR_BATTERY_CHARGING` 電池残量の属性の一つで、充電中であることを表します(=2)。
`static int`	`ATTR_BATTERY_FULL` 電池残量の属性の一つで、充電中でなく、ピクト表示がFULLであることを表します(=1)。
`static int`	`ATTR_BATTERY_PARTIAL` 電池残量の属性の一つで、充電中でなく、ピクト表示がFULL以外であることを表します(=0)。
`static int`	`ATTR_FOLDING_CLOSE [iアプリオプションAPI]` 折りたたみ状態の属性の一つで、端末が折りたたまれているか、フリップが閉じていることを表します (=0)。
`static int`	`ATTR_FOLDING_OPEN [iアプリオプションAPI]` 折りたたみ状態の属性の一つで、端末が折りたたまれていないか、フリップが開いていることを表します (=1)。
`static int`	`ATTR_MAIL_AT_CENTER` メール受信状態の属性の一つで、未読メールがセンターに保管されていることを表します (=2)。
`static int`	`ATTR_MAIL_NONE` メール受信状態の属性の一つで、未読メールがないことを表します (=0)。
`static int`	`ATTR_MAIL_RECEIVED` メール受信状態の属性の一つで、未読メールがあることを表します (=1)。
`static int`	`ATTR_MANNER_OFF` マナーモードの属性の一つで、オフであることを表します(=0)。
`static int`	`ATTR_MANNER_ON` マナーモードの属性の一つで、オンであることを表します(=1)。
`static int`	`ATTR_MESSAGE_AT_CENTER` メッセージ受信状態の属性の一つで、未読メッセージがセンターに保管されていることを表します (=2)。
`static int`	`ATTR_MESSAGE_NONE` メッセージ受信状態の属性の一つで、未読メッセージがないことを表します (=0)。
`static int`	`ATTR_MESSAGE_RECEIVED` メッセージ受信状態の属性の一つで、未読メッセージがあることを表します (=1)。
`static int`	`ATTR_SCREEN_INVISIBLE [iアプリオプションAPI]` 画面がユーザに見えるかどうかの属性の一つで、画面が見えない状態であることを表します(=0)。
`static int`	`ATTR_SCREEN_VISIBLE [iアプリオプションAPI]` 画面がユーザに見えるかどうかの属性の一つで、画面が見える状態であることを表します(=1)。
`static int`	`ATTR_SERVICEAREA_INSIDE` 電界強度情報の属性の一つで、ピクト表示が圏内であることを表します(=1)。
`static int`	`ATTR_SERVICEAREA_OUTSIDE` 電界強度情報の属性の一つで、ピクト表示が行われていないまたは圏外(セルフモード時も含む)であることを表します(=0)。
`static int`	`ATTR_SURROUND_OFF [iアプリオプションAPI]` オーディオ出力のサラウンド機能の属性の一つで、サラウンド機能が無効であることを表します(=0)。
`static int`	`ATTR_SURROUND_ON [iアプリオプションAPI]` オーディオ出力のサラウンド機能の属性の一つで、サラウンド機能が有効であることを表します(=1)。
`static int`	`ATTR_VIBRATOR_OFF` バイブレータの属性の一つで、オフであることを表します(=0)。
`static int`	`ATTR_VIBRATOR_ON` バイブレータの属性の一つで、オンであることを表します (=1)。
`static int`	`DEV_AUDIO_SURROUND [iアプリオプションAPI]` オーディオ出力のサラウンド機能を表します(=10)。
`static int`	`DEV_BACKLIGHT` バックライトを表します (=0)。
`static int`	`DEV_BATTERY` 電池残量を表します (=5)。
`static int`	`DEV_FOLDING [iアプリオプションAPI]` 折りたたみ状態を表します (=2)。
`static int`	`DEV_KEYPAD [iアプリオプションAPI]` キーパッドを表します (=8)。
`static int`	`DEV_MAILBOX` メール受信状態を表します (=3)。
`static int`	`DEV_MANNER` マナーモードを表します (=7)。
`static int`	`DEV_MESSAGEBOX` メッセージ（メッセージフリー、メッセージリクエスト）の受信状態を表します (=4)。
`static int`	`DEV_SCREEN_VISIBLE [iアプリオプションAPI]` 画面がユーザに見える状態かどうかを表します(=9)。
`static int`	`DEV_SERVICEAREA` 電界強度情報を表します (=6)。
`static int`	`DEV_VIBRATOR` バイブレータを表します (=1)。
`static int`	`MAX_OPTION_ATTR` オプションのネイティブリソース属性の最大値です(=255)。
`static int`	`MAX_VENDOR_ATTR` ベンダ定義のネイティブリソース属性の最大値です(=127)。
`static int`	`MIN_OPTION_ATTR` オプションのネイティブリソース属性の最小値です(=128)。
`static int`	`MIN_VENDOR_ATTR` ベンダ定義のネイティブリソース属性の最小値です(=64)。
`static int`	`SOUND_ALARM` ユーザにスケジュールなどのイベントを通知するタイプの標準サウンドを表します (=3)。
`static int`	`SOUND_CONFIRM` ユーザの操作に対して処理を受け付けたことを通知するタイプの標準サウンドを表します (=4)。
`static int`	`SOUND_ERROR` ユーザにエラーを通知するタイプの標準サウンドを表します (=2)。
`static int`	`SOUND_INFO` ユーザに情報を通知するタイプの標準サウンドを表します (=0)。
`static int`	`SOUND_WARNING` ユーザに警告を通知するタイプの標準サウンドを表します (=1)。
`static int`	`THEME_AV_CALL_IN` テレビ電話着信を表すテーマ設定タイプです(=5)。
`static int`	`THEME_AV_CALLING [iアプリオプションAPI]` テレビ電話通話中の代替画像を表すテーマ設定タイプです (=7)。
`static int`	`THEME_CALL_IN` 音声着信を表すテーマ設定タイプです(=2)。
`static int`	`THEME_CALL_OUT` 音声発信を表すテーマ設定タイプです(=1)。
`static int`	`THEME_CHAT_RECEIVED` チャットメール着信を表すテーマ設定タイプです (=6)。
`static int`	`THEME_MESSAGE_RECEIVE` メールおよびショートメール・SMS、メッセージ(R、F)着信を表すテーマ設定タイプです(=4)。
`static int`	`THEME_MESSAGE_SEND` メールおよびショートメール・SMS発信を表すテーマ設定タイプです(=3)。
`static int`	`THEME_STANDBY` 待ち受け画面を表すテーマ設定タイプです(=0)。

メソッドの概要
`static int`	`getAttribute(int attr)` ネイティブリソースの属性を取得します。
`static boolean`	`isAvailable(int attr)` ネイティブのリソースが制御可能かどうか調べます。
`static void`	`playSound(int type)` 標準サウンドを鳴らします。
`static void`	`setAttribute(int attr, int value)` ネイティブリソースの制御を行います。
`static void`	`setImageTheme(int target, int id)` 音声発着信時等に表示される静止画や Video トラックのみの動画、アバターデータを設定します。
`static void`	`setMenuIcons(int[] path, int[] ids) [iアプリオプションAPI]` あるメニュー階層下のサブメニューのアイコンを一括設定します。
`static void`	`setMovieTheme(int target, int id) [iアプリオプションAPI]` 音声着信時等に再生される動画を設定します。
`static void`	`setSoundTheme(int target, int id)` 音声着信時等に再生されるサウンドやAudio トラックのみの動画を設定します。

コンストラクタの概要
`protected`	`PhoneSystem()` アプリケーションが直接このクラスのインスタンスを生成することはできません。

com.nttdocomo.ui クラス PhoneSystem

DEV_BACKLIGHT

ATTR_BACKLIGHT_OFF

ATTR_BACKLIGHT_ON

DEV_VIBRATOR

ATTR_VIBRATOR_OFF

ATTR_VIBRATOR_ON

DEV_FOLDING

ATTR_FOLDING_CLOSE

ATTR_FOLDING_OPEN

DEV_MAILBOX

ATTR_MAIL_NONE

ATTR_MAIL_RECEIVED

ATTR_MAIL_AT_CENTER

DEV_MESSAGEBOX

ATTR_MESSAGE_NONE

ATTR_MESSAGE_RECEIVED

ATTR_MESSAGE_AT_CENTER

DEV_BATTERY

ATTR_BATTERY_PARTIAL

ATTR_BATTERY_FULL

ATTR_BATTERY_CHARGING

DEV_SERVICEAREA

ATTR_SERVICEAREA_OUTSIDE

ATTR_SERVICEAREA_INSIDE

DEV_MANNER

ATTR_MANNER_OFF

ATTR_MANNER_ON

DEV_KEYPAD

DEV_SCREEN_VISIBLE

ATTR_SCREEN_INVISIBLE

ATTR_SCREEN_VISIBLE

DEV_AUDIO_SURROUND

ATTR_SURROUND_OFF

ATTR_SURROUND_ON

MIN_VENDOR_ATTR

MAX_VENDOR_ATTR

MIN_OPTION_ATTR

MAX_OPTION_ATTR

SOUND_INFO

SOUND_WARNING

SOUND_ERROR

SOUND_ALARM

SOUND_CONFIRM

THEME_STANDBY

THEME_CALL_OUT

THEME_CALL_IN

THEME_MESSAGE_SEND

THEME_MESSAGE_RECEIVE

THEME_AV_CALL_IN

THEME_CHAT_RECEIVED

THEME_AV_CALLING

PhoneSystem

setAttribute

getAttribute

isAvailable

playSound

setImageTheme

setSoundTheme

setMovieTheme

setMenuIcons

com.nttdocomo.ui
クラス PhoneSystem