17.14.29 recipients

This element specifies all of the inclusion/exclusion data for the contents of the specified mail merge data source. It is the root element for the Mail Merge Recipient Data part.

[Example: Consider a document which is the source document for a mail merge operation. If two records of the three specified by the data source were excluded from the mail merge, the resulting recipient data part would appear as follows:

<w:recipients>
  <w:recipientData>
    <w:active w:val="false"/>
    …
  </w:recipientData>
  <w:recipientData>
    <w:active w:val="false"/>
    …
  </w:recipientData>
  <w:recipientData>
    …
  </w:recipientData>
</w:recipients>

The recipients element contains all of the recipient inclusion/exclusion data for this mail merge document. end example]

[Note: The W3C XML Schema definition of this element’s content model (CT_Recipients) is located in A.1. end note]