com.nttdocomo.system
クラス MessageSent

Object
  com.nttdocomo.system.Message
      com.nttdocomo.system.MessageSent

すべての実装インタフェース:

MailConstants

public final class MessageSent

extends Message

ネイティブから取得したメッセージiアプリの送信メッセージを定義します。

MessageSentオブジェクトは、 MessageAgent.getMessage(int, int) メソッドにより取得される、 メッセージiアプリの送信または未送信メッセージを表します。

送信および未送信メッセージには、 サブジェクト(通常文字列)、 本文(通常文字列)、 送信日時(通常文字列として取得可能)、 宛先アドレス(通常文字列またはXStringまたはXStringの配列)、 添付バイナリデータが設定されています。

メッセージiアプリのメッセージ送信機能により作成(保存)された 送信および未送信メッセージについては、 そのメッセージiアプリでの作成状況に応じて 通常文字列またはXStringまたはXString配列の宛先アドレスが設定されています。 例えば、 宛先アドレスに通常文字列を指定して送信したメッセージを 送信フォルダから取得すると、 その宛先アドレスは通常文字列で設定されています。 これは、実行中のアプリケーションであるか否かにかかわらず、 このメッセージiアプリ用の送信または未送信フォルダにある、 自端末で作成されたすべてのメッセージiアプリ作成メッセージに適用されます。
メッセージiアプリが作成(保存)したメッセージでない場合、 宛先アドレスは1つであっても必ずXString配列で設定されています。
したがって、宛先アドレスは、

• 通常文字列(の配列)
• XStringの文字列1つ
• XStringの配列

のいずれかになっています。

なお、 「宛先アドレス」にはカーボンコピー(Cc)やブラインドカーボンコピー(Bcc) は含みません。 すなわち、ネイティブ機能のメーラによって作成(保存)したメールに Cc や Bcc が指定されていたとしても、それらの情報は一切取得できません。

導入されたバージョン:

DoJa-3.0 (505i)

関連項目:

MessageAgent

フィールドの概要

インタフェース com.nttdocomo.system.MailConstants から継承したフィールド

ADDRESS_DOMAIN, ADDRESS_FULL, ADDRESS_USER, RECEIVED, SENT, UNSENT

メソッドの概要

String[]	getRecipients() 宛先アドレス(通常文字列)を取得します。
String	getSubject() サブジェクト(通常文字列)を取得します。
XString	getXRecipient(int part) 宛先アドレス(XString)を取得します。
XString[]	getXRecipients(int part) 宛先アドレス(XString配列)を取得します。

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

getBody, getData, getDateString, getId, getType

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

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

メソッドの詳細

getSubject

public String getSubject()

サブジェクト(通常文字列)を取得します。

オーバーライド:

クラス Message 内の getSubject

戻り値:

サブジェクトを返します。 このメッセージがショートメール(PDC 端末の場合)・ SMS (FOMA 端末の場合) である場合には null を返します。 このメッセージにサブジェクトが設定されていない場合には、 空文字列を返します。

getRecipients

public String[] getRecipients()

宛先アドレス(通常文字列)を取得します。

戻り値:

宛先アドレスを配列で返します。 設定されていない場合、nullを返します。 返される配列は、このオブジェクトが内部で保持している配列のコピーです。

getXRecipient

public XString getXRecipient(int part)

宛先アドレス(XString)を取得します。

パラメータ:

part - アドレス中の取得する部分を指定します。 ADDRESS_FULL、 ADDRESS_USER、 ADDRESS_DOMAIN のいずれかを指定します。

戻り値:

宛先アドレスを返します。 設定されていない場合、nullを返します。

例外:

IllegalArgumentException - 引数 part の値が不正な場合に発生します。

getXRecipients

public XString[] getXRecipients(int part)

宛先アドレス(XString配列)を取得します。

このメッセージがショートメール(PDC 端末の場合)・SMS (FOMA 端末の場合) である場合には、宛先アドレスとして、当該ショートメール・SMS の宛先電話番号が設定されているものとして扱われます。

パラメータ:

part - アドレス中の取得する部分を指定します。 ADDRESS_FULL、 ADDRESS_USER、 ADDRESS_DOMAIN のいずれかを指定します。

戻り値:

宛先アドレスを配列で返します。 設定されていない場合、nullを返します。 返される配列は、このオブジェクトが内部で保持している配列のコピーです。

例外:

IllegalArgumentException - 引数 part の値が不正な場合に発生します。