com.docomostar.ui
クラス Dialog

Object
  com.docomostar.ui.Frame
      com.docomostar.ui.Dialog

public final class Dialog
extends Frame

ダイアログを定義します。 ダイアログクラスは、ユーザに対してメッセージを提示して確認を求める機能を実現します。

ダイアログはボタンを持っています。表示されるボタンは、ダイアログタイプに依存します。

ダイアログタイプ	ボタン
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 及び FlashPlayerPane)を切り替えようとした場合は、 ダイアログが閉じた後にそのフレームに切り替わります。

ダイアログを Display.setCurrent(Frame) メソッドの引数に指定した場合は例外が発生します。

導入されたバージョン:

Star-1.0

関連項目:

Canvas, Panel, FlashPlayerPane

フィールドの概要

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.docomostar.ui.Frame から継承されたフィールド

ARROW_DOWN, ARROW_LEFT, ARROW_RIGHT, ARROW_UP, SELECT_KEY, SOFT_KEY_1, SOFT_KEY_2, SOFT_KEY_3, SOFT_KEY_4

コンストラクタの概要

Dialog(int type, String title)
ダイアログの種類とダイアログのタイトル文字列を指定して ダイアログを生成します。

メソッドの概要

void	setBackground(int c) 背景色を設定します。
void	setFont(Font f) このダイアログの文字列描画に使用するフォントを設定します。
void	setSoftArrowLabel(int key) 上下左右キーの上下左右矢印の表示を設定します。
void	setSoftLabel(int key, String label) ファンクションキーのラベル文字列を設定します。
void	setSoftLabelVisible(boolean b) [iアプリオプションAPI] ファンクションキーを表示するかどうかを設定します。
void	setText(String msg) 表示するメッセージ文字列を設定します。
int	show() ダイアログをスクリーンに表示します。

クラス com.docomostar.ui.Frame から継承されたメソッド

getHeight, getWidth

クラス 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,
              String title)

ダイアログの種類とダイアログのタイトル文字列を指定して ダイアログを生成します。 タイトル文字列が長く、ダイアログに表示しきれない場合は、 表示できない部分を切り捨てて表示します。

パラメータ:

type - ダイアログの種類を指定します。

title - ダイアログのタイトル文字列を指定します。nullが指定された場合は、空文字列("")が設定されます。

例外:

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

メソッドの詳細

setBackground

public void setBackground(int c)

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

オーバーライド:

クラス Frame 内の setBackground

パラメータ:

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

関連項目:

Graphics.clearRect(int, int, int, int)

例外:

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

setText

public void setText(String msg)

表示するメッセージ文字列を設定します。 デフォルトでは空文字列("")が設定されます。 メッセージ文字列が長く、ダイアログに表示しきれない場合は、表示できない部分を切り捨てて表示します。

引数 msg に null が指定された場合は空文字列("")が設定されます。

パラメータ:

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

show

public int show()

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

戻り値:

押されたボタンを返します。

例外:

UIException -
(BUSY_RESOURCE)
ダイアログが表示されている状態で ダイアログを表示しようとした場合に発生します。

setSoftLabel

public void setSoftLabel(int key,
                         String label)

ファンクションキーのラベル文字列を設定します。 ダイアログクラスでは、 ファンクションキーのラベル文字列の変更はできないので このクラスでは、オーバライドにより機能を止めています。したがって、このメソッドを 呼び出してもなにもしません。

オーバーライド:

クラス Frame 内の setSoftLabel

パラメータ:

key - ラベル文字列を設定する ファンクションキーの番号を指定します。

label - ラベル文字列を指定します。

setSoftLabelVisible

public void setSoftLabelVisible(boolean b) [iアプリオプションAPI]

ファンクションキーを表示するかどうかを設定します。

ダイアログクラスでは、 ファンクションキーの表示・非表示を設定できないので、 このクラスでは、オーバライドにより機能を止めています。したがって、 このメソッドを呼び出した場合、常に UnsupportedOperationException 例外が発生します。

オーバーライド:

クラス Frame 内の setSoftLabelVisible

パラメータ:

b - 指定に意味を持ちません。

例外:

UnsupportedOperationException -
このメソッドが呼ばれた場合に発生します。

setFont

public void setFont(Font f)

このダイアログの文字列描画に使用するフォントを設定します。 タイトル文字列およびボタンの文字列には影響しません。 デフォルトでは、ダイアログが生成されたときの Font クラスの getDefaultFont メソッドが返すフォントが設定されています。

パラメータ:

f - 描画に使用するフォントを指定します。

関連項目:

Font.getDefaultFont()

例外:

NullPointerException -
引数 f に null が指定された場合に発生します。

setSoftArrowLabel

public void setSoftArrowLabel(int key)

上下左右キーの上下左右矢印の表示を設定します。

ダイアログクラスでは、上下左右矢印の表示を設定できないので、 このクラスでは、オーバライドにより機能を止めています。したがって、 このメソッドを呼び出した場合、常に UnsupportedOperationException 例外が発生します。

オーバーライド:

クラス Frame 内の setSoftArrowLabel

パラメータ:

key - 指定に意味を持ちません。

例外:

UnsupportedOperationException -
このメソッドが呼ばれた場合に発生します。