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

[DoJa-1.0]
ダイアログが表示されている間に、タイマのイベントなどにより、そのダイアログの背後になっている キャンバスまたはパネルを切り替えようとした場合の振舞は機種依存です。典型的な実装では、 その場合のキャンパスまたはパネルの切り替えは行われません。
[DoJa-2.0]
ダイアログが表示されている間に別スレッドからその背後のキャンバスまたは パネルを切り替えようとした場合は、ダイアログが閉じた後にそのキャンバスまたは パネルに切り替わります。
[DoJa-2.0]
ダイアログを Display.setCurrent メソッドの引数に指定した場合は例外が発生します。

関連項目:

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が指定された場合は、空文字列("")が設定されます。

例外:

IllegalArgumentException - 引数 type に不正な値が指定された場合に発生します。

メソッドの詳細

setBackground

public void setBackground(int c)

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

オーバーライド:

クラス Frame 内の setBackground

パラメータ:

c - 背景色を表す整数値を指定します。

例外:

IllegalArgumentException - 引数 c に不正な値が指定された場合に発生します。

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 - ラベル文字列を指定します。