HorizontalMerge Class

Defines the HorizontalMerge Class.When the object is serialized out as xml, its qualified name is w:hMerge.

Inheritance Hierarchy


Namespace:  DocumentFormat.OpenXml.Wordprocessing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)


Public Class HorizontalMerge _
    Inherits OpenXmlLeafElement
Dim instance As HorizontalMerge
public class HorizontalMerge : OpenXmlLeafElement


[ISO/IEC 29500-1 1st Edition]

17.4.22 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., whether this cell continues the horizontal merge or starts a new merged group of cells).

[Note: This property is maintained for compatibility with legacy word processing documents which defined tables in this manner. Whenever possible, this form or horizontal merges should not be produced, and should be translated to the appropriate gridSpan (§17.4.17) settings on the table cells instead. end 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.

[Example: Consider a table with one row and three columns with the last two columns horizontally merged:

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

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

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

Parent Elements

tcPr (§; tcPr (§; tcPr (§17.4.70); tcPr (§17.4.71)



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.

[Example: Consider a table cell where a horizontal cell merge begins represented as the following WordprocessingML:

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

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

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

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

© ISO/IEC29500: 2008.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also


HorizontalMerge Members

DocumentFormat.OpenXml.Wordprocessing Namespace