w:personal (E-mail Message Style)

Marks a paragraph style as intended for use in e-mail message bodies, optionally for composition or reply/forward contexts.

Parent elements

w:style

Description

w:personal, w:personalCompose, and w:personalReply are toggle elements on paragraph styles that classify a style as an e-mail style:

w:personal — The style is used in the body of any e-mail message.
w:personalCompose — The style is used when composing a new message.
w:personalReply — The style is used in reply or forward messages.

They are defined in ECMA-376 Part 1 §17.7.4.12–14.

These hints allow e-mail clients and editors to automatically select the appropriate paragraph style based on the e-mail context.

Attributes

Each element has the same attribute:

Attribute	Type	Possible Values	Description
`w:val`	`ST_OnOff`	`true`, `false`, `1`, `0`, `on`, `off`	Enables or disables the classification. Omitting `w:val` is equivalent to `true`.

Examples

<!-- Style used for composing new e-mail messages -->
<w:style w:type="paragraph" w:styleId="EmailBody">
  <w:name w:val="E-mail Message"/>
  <w:personal/>
  <w:personalCompose/>
</w:style>

<!-- Separate style for reply messages -->
<w:style w:type="paragraph" w:styleId="EmailReply">
  <w:name w:val="E-mail Message Reply"/>
  <w:personal/>
  <w:personalReply/>
</w:style>

using DocumentFormat.OpenXml.Wordprocessing;

// w:personal
var personal = new Personal();
// w:personalCompose
var personalCompose = new PersonalCompose();
// w:personalReply
var personalReply = new PersonalReply();

Notes

A single style may carry more than one of these flags (e.g. both w:personal and w:personalCompose).
These elements are primarily used by e-mail clients that embed a WordprocessingML editor, such as Outlook. General-purpose word processors may ignore them.