iモード対応Java API: クラス Dialog

概要

パッケージ

クラス

階層ツリー

非推奨 API

索引

ヘルプ

前のクラス 次のクラス

フレームあり フレームなし

概要: 内部クラス | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

com.nttdocomo.ui
クラス Dialog

java.lang.Object
  |
  +--com.nttdocomo.ui.Frame
        |
        +--com.nttdocomo.ui.Dialog

public final class Dialog
extends Frame

ダイアログを定義します。ダイアログクラスは、低レベル API/高レベル APIにおいて、ユーザに対してメッセージを提示して確認を求める機能を実現します。ダイアログはボタンを持っています。表示されるボタンは、ダイアログタイプに依存します。

ダイアログタイプ	ボタン
DIALOG_ERROR	BUTTON_OK
DIALOG_WARNING	BUTTON_OK
DIALOG_INFO	BUTTON_OK
DIALOG_YESNO	BUTTON_YES, BUTTON_NO
DIALOG_YESNOCANCEL	BUTTON_YES, BUTTON_NO, BUTTON_CANCEL

ダイアログが表示されている間に、タイマのイベントなどにより、そのダイアログの背後になっているキャンバスまたはパネルを切り替えようとした場合の振舞は機種依存です。典型的な実装では、その場合のキャンバスまたはパネルの切り替えは行われません。

関連項目:: Canvas, Panel

フィールドの概要

static int BUTTON_CANCEL
          キャンセルボタン (=0x0002)。

static int BUTTON_NO
          NO ボタン (=0x0008)。

static int BUTTON_OK
          OK ボタン (=0x0001)。

static int BUTTON_YES
          YES ボタン (=0x0004)。

static int DIALOG_ERROR
          エラーダイアログタイプ (=2)。

static int DIALOG_INFO
          情報ダイアログタイプ (=0)。

static int DIALOG_WARNING
          警告ダイアログタイプ (=1)。

static int DIALOG_YESNO
          YES, NO の二つのボタンを持つダイアログタイプ (=3)。

static int DIALOG_YESNOCANCEL
          YES, NO, キャンセルの三つのボタンを持つダイアログタイプ (=4)。

クラス com.nttdocomo.ui.Frame から継承したフィールド

SOFT_KEY_1, SOFT_KEY_2

コンストラクタの概要

Dialog(int type, java.lang.String title)
          コンストラクタ。

メソッドの概要

void setBackground(int c)
          背景色を設定します。

void setSoftLabel(int key, java.lang.String label)
          ソフトキーのラベル文字列を設定します。

void setText(java.lang.String msg)
          表示するメッセージ文字列を設定します。

int show()
          ダイアログをスクリーンに表示します。

クラス com.nttdocomo.ui.Frame から継承したメソッド

getHeight, getWidth

クラス java.lang.Object から継承したメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

DIALOG_INFO

public static final int DIALOG_INFO

情報ダイアログタイプ (=0)。 OK ボタンを持ちます。

DIALOG_WARNING

public static final int DIALOG_WARNING

警告ダイアログタイプ (=1)。 OK ボタンを持ちます。

DIALOG_ERROR

public static final int DIALOG_ERROR

エラーダイアログタイプ (=2)。 OK ボタンを持ちます。

DIALOG_YESNO

public static final int DIALOG_YESNO

YES, NO の二つのボタンを持つダイアログタイプ (=3)。

DIALOG_YESNOCANCEL

public static final int DIALOG_YESNOCANCEL

YES, NO, キャンセルの三つのボタンを持つダイアログタイプ (=4)。

BUTTON_OK

public static final int BUTTON_OK

OK ボタン (=0x0001)。

BUTTON_CANCEL

public static final int BUTTON_CANCEL

キャンセルボタン (=0x0002)。

BUTTON_YES

public static final int BUTTON_YES

YES ボタン (=0x0004)。

BUTTON_NO

public static final int BUTTON_NO

NO ボタン (=0x0008)。

コンストラクタの詳細

Dialog

public Dialog(int type,
              java.lang.String title)

コンストラクタ。ダイアログの種類とダイアログのタイトル文字列を指定してダイアログを生成します。

パラメータ:: type - ダイアログの種類を指定します。; title - ダイアログのタイトル文字列を指定します。null が指定された場合には、空文字列(“”)が設定されます。
例外:: java.lang.IllegalArgumentException - type に不正な値が設定された場合に発生します。

メソッドの詳細

setBackground

public void setBackground(int c)

背景色を設定します。このメソッドが呼ばれると直ちに背景色が変更されます。デフォルトでは機種依存の色が設定されています。

オーバーライド:: クラス Frame 内の setBackground

パラメータ:: c - 背景色を表す整数値を指定します。
例外:: java.lang.IllegalArgumentException - 引数の値が不正な場合に発生します。

setText

public void setText(java.lang.String msg)

表示するメッセージ文字列を設定します。デフォルトでは空文字列("")が設定されます。メッセージ文字列が長く、ダイアログに表示しきれない場合の振舞は、機種依存です。

パラメータ:: msg - メッセージ文字列を指定します。

show

public int show()
         throws UIException

ダイアログをスクリーンに表示します。

戻り値:: 押されたボタンを返します。
例外:: UIException - ダイアログが表示されている状態でダイアログを表示しようとした場合に発生します。とりうるステータスは、BUSY_RESOURCE です。

setSoftLabel

public void setSoftLabel(int key,
                         java.lang.String label)

ソフトキーのラベル文字列を設定します。ダイアログクラスでは、ソフトキーのラベル文字列の変更はできません。したがってこのメソッドを呼び出しても何もしません。

オーバーライド:: クラス Frame 内の setSoftLabel

パラメータ:: key - ラベル文字列を設定するソフトキーの番号を指定します。; label - ラベル文字列を指定します。

概要