TableRowHeight Class
Defines the TableRowHeight Class.When the object is serialized out as xml, its qualified name is w:trHeight.
Inheritance Hierarchy
System.Object
DocumentFormat.OpenXml.OpenXmlElement
DocumentFormat.OpenXml.OpenXmlLeafElement
DocumentFormat.OpenXml.Wordprocessing.TableRowHeight
Namespace: DocumentFormat.OpenXml.Wordprocessing
Assembly: DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)
Syntax
'Declaration
Public Class TableRowHeight _
Inherits OpenXmlLeafElement
'Usage
Dim instance As TableRowHeight
public class TableRowHeight : OpenXmlLeafElement
Remarks
[ISO/IEC 29500-1 1st Edition]
17.4.81 trHeight (Table Row Height)
This element specifies the height of the current table row within the current table. This height shall be used to determine the resulting height of the table row, which can be absolute or relative (depending on its attribute values).
If omitted, then the table row shall automatically resize its height to the height required by its contents (the equivalent of an hRule value of auto).
[Example: Consider the following WordprocessingML table:
Some text in R1C1.
Examining the WordprocessingML for this table, the trHeight element is not specified, so the row heights are automatically determined by their contents (in the first row, the text Some text in R1C1.). If the first row shall be restricted to 0.1 inches high (144 twentieths of a point) regardless of its contents, that would be specified using the trHeight element as follows:
<w:trPr> <w:trHeight w:val="144" w:hRule="exact"/> </w:trPr>
The resulting table row would be exactly 144 twentieths of a point high:
Some text in R1C1.
end example]
Parent Elements |
|---|
trPr (§17.4.82); trPr (§17.7.6.10); trPr (§17.7.6.11); trPr (§17.4.83) |
Attributes |
Description |
|---|---|
hRule (Table Row Height Type) |
Specifies the meaning of the height specified for this table row. The meaning of the value of the val attribute is defined based on the value of the hRule attribute for this table row as follows:
If this attribute is omitted, then its value shall be assumed to be auto. [Example: Consider the following paragraph containing a table row:
<w:tr>
<w:trPr>
<w:trHeight w:val="2189" w:hRule="atLeast"/>
</w:trPr>
…
</w:tr>
The hRule attribute specifies a value of atLeast, so the table row is a minimum of 2189 twentieths of a point high regardless of its contents, since its val value is 2189 twentieths of a point. end example] The possible values for this attribute are defined by the ST_HeightRule simple type (§17.18.37). |
val (Table Row Height) |
Specifies the table row's height. This height is expressed in twentieths of a point. If this attribute is omitted, then its value shall be assumed to be 0. The meaning of the value of the val attribute is defined based on the value of the hRule attribute for this table row as follows:
[Example: Consider the following table row:
<w:tr>
<w:trPr>
<w:trHeight w:val="2189" w:hRule="atLeast"/>
</w:trPr>
…
</w:tr>
The val attribute specifies a value of 2189 twentieths of a point, so this table row is a minimum of 2189 twentieths of a point high regardless of its contents (growing if needed), since its hRule value is set to atLeast. end example] The possible values for this attribute are defined by the ST_TwipsMeasure simple type (§22.9.2.14). |
[Note: The W3C XML Schema definition of this element’s content model (CT_Height) 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.