createChildEntity (NotesMIMEEntity - JavaScript)

MIME エンティティを作成し、それを子 MIME エンティティのリストに挿入します。

定義場所

構文

createChildEntity() : NotesMIMEEntity

createChildEntity(nextSibling:NotesMIMEEntity) : NotesMIMEEntity

パラメータ	説明
`nextSibling`	呼び出し元の MIME エンティティの既存の子です。このパラメータが指定されている場合、新規の MIME エンティティはその直前に配置されます。

戻り値	説明
NotesMIMEEntity	子 MIME エンティティです。

使用法

マルチパート MIME エンティティは、親と子のエンティティで構成されます。親を別のエンティティの子にすることもできます。1 つの親の複数の子エンティティが逐次的なリストを構成します。

このメソッドは、呼び出し元のエンティティを親に、新規のエンティティを子に設定します。

親に既存の子エンティティがない場合、新規エンティティが最初の子になります。 nextSibling が指定されている場合、このエンティティはその直前に配置されます。この指定がない場合、このエンティティは既存の最後の子エンティティの後ろに配置されます。

親のコンテントタイプが multipart の場合、既存のコンテントタイプとサブタイプが保持されます。その他の場合は multipart/mixed が設定されます。親のコンテントタイプが multipart で、boundary パラメータが指定されている場合、既存の境界が保持されます。指定されていない場合は境界が生成されます。ただし、message/rfc822 のコンテントタイプ/サブタイプは例外で、境界なしで保持されます。

親エンティティにはコンテントを組み込めません。コンテントを組み込んでも失われます。プリアンブルは組み込むことができます。

例

このボタンは、マルチパート MIME エンティティを作成してメールメモとして送信します。

var stream:NotesStream = session.createStream();
// Do not automatically convert MIME to rich text
session.setConvertMIME(false);
var doc:NotesDocument = database.createDocument();
// Create parent entity
doc.replaceItemValue("Form", "Memo");
var body:NotesMIMEEntity = doc.createMIMEEntity();
var header:NotesMIMEHeader = body.createHeader("Content-Type");
header.setHeaderVal("multipart/mixed");
header = body.createHeader("Subject");
header.setHeaderVal("MIME message");
header = body.createHeader("To");
header.setHeaderVal(requestScope.query);
// Create first child entity
var child:NotesMIMEEntity = body.createChildEntity();
stream.writeText("Text of message for child 1.¥n");
child.setContentFromText(stream, "text/plain", NotesMIMEEntity.ENC_NONE);
stream.truncate();
// Create second child entity
child = body.createChildEntity();
stream.writeText("Text of message for child 2.");
child.setContentFromText(stream, "text/plain", NotesMIMEEntity.ENC_NONE);
doc.send(false);
// Restore conversion
session.setConvertMIME(true);

このボタンは、上記のボタンと同様にマルチパート MIME エンティティを作成してメールメモとして送信しますが、2 番目の子エンティティを最初の子エンティティの前に配置します。

var stream:NotesStream = session.createStream();
// Do not automatically convert MIME to rich text
session.setConvertMIME(false);
var doc:NotesDocument = database.createDocument();
// Create parent entity
doc.replaceItemValue("Form", "Memo");
var body:NotesMIMEEntity = doc.createMIMEEntity();
var header:NotesMIMEHeader = body.createHeader("Content-Type");
header.setHeaderVal("multipart/mixed");
header = body.createHeader("Subject");
header.setHeaderVal("MIME message");
header = body.createHeader("To");
header.setHeaderVal(requestScope.query);
// Create first child entity
var child:NotesMIMEEntity = body.createChildEntity();
stream.writeText("Text of message for child 1.¥n");
child.setContentFromText(stream, "text/plain", NotesMIMEEntity.ENC_NONE);
stream.truncate();
// Create second child entity
child = body.createChildEntity(child);
stream.writeText("Text of message for child 2.¥n");
child.setContentFromText(stream, "text/plain", NotesMIMEEntity.ENC_NONE);
doc.send(false);
// Restore conversion
session.setConvertMIME(true);

言語間の参照

LotusScript® NotesMIMEEntity クラスの CreateChildEntityメソッド

Java™ MIMEEntity クラスの createChildEntity メソッド