<hMerge> (Horizontally Merged Cell)

This element specifies that this cell is part of a horizontally merged set of cells in a table. The @val attribute on this element determines how this cell is defined with respect to the previous cell in the table (i.e. does this cell continue the horizontal merge or start a new merged group of cells).

Note:

If this element is omitted, then this cell shall not be part of any horizontally merged grouping of cells, and any horizontal merge group in the preceding cells shall be closed.

The second cell in the first row starts a merge that is completed in the right adjacent cell, resulting in the following WordprocessingML:

<w:tbl>
   …
  <w:tr>
     <w:tc>
       …
    </w:tc>
     <w:tc>
       <w:tcPr>
         <w:hmerge w:val="restart"/>
      </w:tcPr>
      …
    </w:tc>
    <w:tc>
      <w:tcPr>
        <w:hmerge/>
      </w:tcPr>
      …
    </w:tc>
  </w:tr>
</w:tbl>

The <hmerge> element defines the cells which are horizontally merged, and how each group is merged together. ]

Parent Elements

<tcPr> (§2.7.5.8); <tcPr> (§2.4.66); <tcPr> (§2.7.5.9); <tcPr> (§2.4.67)

Attributes

Description

<val> (Horizontal Merge Type)

Specifies how the table cell is part of a horizontally merged region. This determine whether the cell should join onto an existing grouping of merged cells if any exist, or start a new group of merged cells. Refer to the simple type definition for a full description of each type.

If this attribute is omitted, its value shall be assumed to be continue.

<w:tcPr>
    <w:hmerge w:val="restart"/>
</w:tcPr>

The attribute value of restart specifies that this element shall start a new horizontally merged region in this table. ]

The possible values for this attribute are defined by the ST_Merge simple type (§2.18.64).

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_HMerge">
	<attribute name="val" type="ST_Merge"/>
</complexType>