Поделиться через


VerticalMerge Class

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

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.VerticalMerge

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

Syntax

'Декларация
Public Class VerticalMerge _
    Inherits OpenXmlLeafElement
'Применение
Dim instance As VerticalMerge
public class VerticalMerge : OpenXmlLeafElement

Remarks

[ISO/IEC 29500-1 редакция 1]

17.4.85 vMerge (Vertically Merged Cell)

This element specifies that this cell is part of a vertically 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 vertical merge or starts a new merged group of cells).

If this element is omitted, then this cell shall not be part of any vertically merged grouping of cells, and any vertically merged group of preceding cells shall be closed. If a vertically merged group of cells do not span the same set of grid columns, then the document is non-conformant.

[Example: Consider a table with three rows and two columns with the last column completely vertically merged:

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

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

The vmerge element defines the cells which are vertically merged, and how each cell is merged together. end example]

Parent Elements

tcPr (§17.7.6.8); tcPr (§17.7.6.9); tcPr (§17.4.70); tcPr (§17.4.71)

Attributes

Description

val (Vertical Merge Type)

Specifies how the table cell is part of a vertically merged region. This determines 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 vertical cell merge begins . This setting is represented as the following WordprocessingML:

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

The attribute value of restart specifies that this element must start a new vertically 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_VMerge) is located in §A.1. end note]

© ISO/IEC29500: 2008. Приведенный выше текст переведен с английского языка на русский корпорацией Майкрософт (или ее подрядчиками) и ISO не несет ответственности за эти переводы.

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

Reference

VerticalMerge Members

DocumentFormat.OpenXml.Wordprocessing Namespace