TableCellProperties 类

定义

命名空间:

DocumentFormat.OpenXml.Wordprocessing

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

表单元格属性。

此类在 Office 2007 及更高版本中可用。

将对象序列化为 xml 时，其限定名称为 w：tcPr。

public class TableCellProperties : DocumentFormat.OpenXml.OpenXmlCompositeElement

type TableCellProperties = class
    inherit OpenXmlCompositeElement

Public Class TableCellProperties
Inherits OpenXmlCompositeElement

继承

Object

OpenXmlElement

OpenXmlCompositeElement

TableCellProperties

示例

以下示例在字处理文档中创建一个表，并使用 TableCellProperties 类指定表格单元格的宽度。

using System;  
using DocumentFormat.OpenXml;  
using DocumentFormat.OpenXml.Packaging;  
using DocumentFormat.OpenXml.Wordprocessing;  

namespace TableCellPropertiesEx  
{  
    class Program  
    {  
         // Insert a table into an existing word processing document.  
        static void Main(string[] args)  
        {  
            string fileName = @"C:\users\public\documents\TableCellPropertiesEx.docx";  
            using (WordprocessingDocument document  
                = WordprocessingDocument.Open(fileName, true))  
            {  
                // Create an empty table.  
                Table table = new Table();  

                // Create a TableProperties object and specify its border information.  
                TableProperties tblProp = new TableProperties(  
                    new TableBorders(new TopBorder()  
                        { Val = new EnumValue<BorderValues>(BorderValues.Sawtooth), Size = 24 },  
                        new BottomBorder()  
                        { Val = new EnumValue<BorderValues>(BorderValues.Sawtooth), Size = 24 },  
                        new LeftBorder()  
                        { Val = new EnumValue<BorderValues>(BorderValues.Sawtooth), Size = 24 },  
                        new RightBorder()  
                        { Val = new EnumValue<BorderValues>(BorderValues.Sawtooth), Size = 24 },  
                        new InsideHorizontalBorder()  
                        { Val = new EnumValue<BorderValues>(BorderValues.Sawtooth), Size = 24 },  
                        new InsideVerticalBorder()  
                        { Val = new EnumValue<BorderValues>(BorderValues.Sawtooth), Size = 24 } )  
                );  

                // Append the TableProperties object to the empty table.  
                table.AppendChild<TableProperties>(tblProp);  

                // Create a row and a cell.  
                TableRow tableRow = new TableRow();  
                TableCell tableCell1 = new TableCell();  

                // Specify the width property of the table cell.  
                tableCell1.Append(new TableCellProperties(  
                    new TableCellWidth() { Type = TableWidthUnitValues.Dxa, Width = "2400" }));  

                // Write some text in the cell.  
                tableCell1.Append(new Paragraph(new Run(new Text("Some cell text."))));  

                // Append the cell to the row.  
                tableRow.Append(tableCell1);  

                // Create a second table cell by copying the OuterXml value of the first table cell.  
                TableCell tableCell2 = new TableCell(tableCell1.OuterXml);  

                // Append the cell to the row.  
                tableRow.Append(tableCell2);  

                // Append the table row to the table.  
                table.Append(tableRow);  

                // Append the table to the document.  
                document.MainDocumentPart.Document.Body.Append(table);  
            }  
        }  
    }  
}  

Imports DocumentFormat.OpenXml  
Imports DocumentFormat.OpenXml.Packaging  
Imports DocumentFormat.OpenXml.Wordprocessing  

Module Module1  
    ' Insert a table into an existing word processing document.  
    Sub Main(ByVal args As String())  
        Dim fileName As String = "C:\users\public\documents\TableCellPropertiesEx.docx"  
        Using document As WordprocessingDocument = WordprocessingDocument.Open(fileName, True)  
            ' Create an empty table.  
            Dim table As New Table()  

            ' Create a TableProperties object and specify its border information.  
            Dim tblProp As New TableProperties(New TableBorders(New TopBorder() With { _  
             .Val = New EnumValue(Of BorderValues)(BorderValues.Sawtooth), _  
             .Size = 24 _  
            }, New BottomBorder() With { _  
             .Val = New EnumValue(Of BorderValues)(BorderValues.Sawtooth), _  
             .Size = 24 _  
            }, New LeftBorder() With { _  
             .Val = New EnumValue(Of BorderValues)(BorderValues.Sawtooth), _  
             .Size = 24 _  
            }, New RightBorder() With { _  
             .Val = New EnumValue(Of BorderValues)(BorderValues.Sawtooth), _  
             .Size = 24 _  
            }, New InsideHorizontalBorder() With { _  
             .Val = New EnumValue(Of BorderValues)(BorderValues.Sawtooth), _  
             .Size = 24 _  
            }, New InsideVerticalBorder() With { _  
             .Val = New EnumValue(Of BorderValues)(BorderValues.Sawtooth), _  
             .Size = 24 _  
            }))  

            ' Append the TableProperties object to the empty table.  
            table.AppendChild(Of TableProperties)(tblProp)  

            ' Create a row and a cell.  
            Dim tableRow As New TableRow()  
            Dim tableCell1 As New TableCell()  

            ' Specify the width property of the table cell.  
            tableCell1.Append(New TableCellProperties(New TableCellWidth() With { _  
             .Type = TableWidthUnitValues.Dxa, _  
             .Width = "2400" _  
            }))  

            ' Write some text in the cell.  
            tableCell1.Append(New Paragraph(New Run(New Text("Some cell text."))))  

            ' Append the cell to the row.  
            tableRow.Append(tableCell1)  

            ' Create a second table cell by copying the OuterXml value of the first table cell.  
            Dim tableCell2 As New TableCell(tableCell1.OuterXml)  

            ' Append the cell to the row.  
            tableRow.Append(tableCell2)  

            ' Append the table row to the table.  
            table.Append(tableRow)  

            ' Append the table to the document.  
            document.MainDocumentPart.Document.Body.Append(table)  
        End Using  
    End Sub  
End Module  

注解

[ISO/IEC 29500-1 第 1 版]

tcPr (表单元格属性)

此元素指定应应用特定表单元格的属性集。 每个唯一属性由此元素的子元素指定。 如果表级别、表级异常或行级别属性与相应的表单元格属性发生冲突，则这些属性应覆盖表或行宽属性。

[示例：考虑单元格宽度覆盖以下 WordprocessingML 中表示的表宽度的表：

<w:tbl>  
  <w:tblPr>  
    <w:tblCellMar>  
      <w:left w:w="0" w:type="dxa"/>  
    </w:tblCellMar>  
  </w:tblPr>  
  …  <w:tr>  
    <w:tc>  
      <w:tcPr>  
        <w:tcMar>  
          <w:left w:w="720" w:type="dxa"/>  
        </w:tcMar>  
      </w:tcPr>  
      …    </w:tc>  
  </w:tr>  
</w:tbl>  

此表单元格的左单元格边距为 点的 720 分之二十 (一个半英寸) ，如 tcMar 元素中指定的，这将覆盖表级设置的左表单元格边距 0 。 示例结束]

父元素
tc (§17.4.66)

子元素	第
cellDel (表单元格删除)	§17.13.5.1
cellIns (表单元格插入)	§17.13.5.2
cellMerge (垂直合并/拆分表单元格)	§17.13.5.3
cnfStyle (表格单元格条件格式)	§17.4.8
gridSpan (当前表单元格跨越的网格列)	§17.4.17
标头 (与表格单元格关联的标题单元格)	§17.4.19
hideMark (忽略行高度计算中单元格标记的末尾)	§17.4.21
hMerge (水平合并单元格)	§17.4.22
noWrap (请勿包装单元格内容)	§17.4.30
shd (表格单元格底纹)	§17.4.33
tcBorders (表单元格边框)	§17.4.67
tcFitText (单元格) 内拟合文本	§17.4.68
tcMar (单表单元格边距)	§17.4.69
tcPrChange (表单元格属性的修订信息)	§17.13.5.36
tcW (首选表格单元格宽度)	§17.4.72
textDirection (表格单元格文本流方向)	§17.4.73
vAlign (表格单元格垂直对齐)	§17.4.84
vMerge (垂直合并单元格)	§17.4.85

[注意：此元素的内容模型 (CT_TcPr) 的 W3C XML 架构定义位于 §A.1 中。 注释结束]

[ISO/IEC 29500-1 第 1 版]

tcPr (表样式条件格式表单元格属性)

此元素指定表单元格属性集，这些属性应应用于表内与父 tblStylePr 元素上指定的条件格式类型匹配的所有区域。 这些属性按通过样式层次结构指定的顺序应用。

[示例：考虑包含 firstRow 的条件格式的表格样式，定义如下：

<w:style w:type="table" w:styleId="exampleTableStyle">  
  …  <w:tblStylePr w:type="firstRow">  
    <w:tcPr>  
      <w:tcBorders>  
        <w:top w:val="nil" />  
        <w:left w:val="nil" />  
        <w:bottom w:val="nil" />  
        <w:right w:val="nil" />  
        <w:insideH w:val="nil" />  
        <w:insideV w:val="nil" />  
      </w:tcBorders>  
    </w:tcPr>  
    …  </w:tblStylePr>  
</w:style>  

在 tblStylePr 元素中指定的 tcPr 元素指定表单元格属性集，这些属性必须应用于表的所有部分，这些部分符合 firstRow 的类型值指定的条件 - 表的所有标题行。 在此示例中，应用的单个表单元格属性是通过 tcBorders 元素 (§17.4.67) 的一组表单元格边框。 在这种情况下，这些单元格边框只需将任何以前的单元格边框重置为 nil。 示例结束]

父元素
tblStylePr (§17.7.6.6)

子元素	第
cellDel (表单元格删除)	§17.13.5.1
cellIns (表单元格插入)	§17.13.5.2
cellMerge (垂直合并/拆分表单元格)	§17.13.5.3
cnfStyle (表格单元格条件格式)	§17.4.8
gridSpan (当前表单元格跨越的网格列)	§17.4.17
标头 (与表格单元格关联的标题单元格)	§17.4.19
hideMark (忽略行高度计算中单元格标记的末尾)	§17.4.21
hMerge (水平合并单元格)	§17.4.22
noWrap (请勿包装单元格内容)	§17.4.30
shd (表格单元格底纹)	§17.4.33
tcBorders (表单元格边框)	§17.4.67
tcFitText (单元格) 内拟合文本	§17.4.68
tcMar (单表单元格边距)	§17.4.69
tcPrChange (表单元格属性的修订信息)	§17.13.5.36
tcW (首选表格单元格宽度)	§17.4.72
textDirection (表格单元格文本流方向)	§17.4.73
vAlign (表格单元格垂直对齐)	§17.4.84
vMerge (垂直合并单元格)	§17.4.85

[注意：此元素的内容模型 (CT_TcPr) 的 W3C XML 架构定义位于 §A.1 中。 注释结束]

[ISO/IEC 29500-1 第 1 版]

tcPr (样式表单元格属性)

此元素指定应应用于表的表单元格属性集。 这些属性不是条件属性，应始终 (应用，尽管它们在所有条件格式属性) 之前应用。

[示例：考虑定义如下的表样式：

<w:style w:type="table" w:styleId="exampleTableStyle">  
  <w:tcPr>  
    <w:tcFitText/>  
  </w:tcPr>  
</w:style>  

在 style 元素中指定的 tcPr 元素指定一组表单元格属性，这些属性必须应用于表的所有部分。 在此示例中，应用的单个表单元格属性是通过 tcFitText 元素 (§17.4.68) 的拟合文本设置。 示例结束]

父元素
style (§17.7.4.17)

子元素	第
cellDel (表单元格删除)	§17.13.5.1
cellIns (表单元格插入)	§17.13.5.2
cellMerge (垂直合并/拆分表单元格)	§17.13.5.3
cnfStyle (表格单元格条件格式)	§17.4.8
gridSpan (当前表单元格跨越的网格列)	§17.4.17
标头 (与表格单元格关联的标题单元格)	§17.4.19
hideMark (忽略行高度计算中单元格标记的末尾)	§17.4.21
hMerge (水平合并单元格)	§17.4.22
noWrap (请勿包装单元格内容)	§17.4.30
shd (表格单元格底纹)	§17.4.33
tcBorders (表单元格边框)	§17.4.67
tcFitText (单元格) 内拟合文本	§17.4.68
tcMar (单表单元格边距)	§17.4.69
tcPrChange (表单元格属性的修订信息)	§17.13.5.36
tcW (首选表格单元格宽度)	§17.4.72
textDirection (表格单元格文本流方向)	§17.4.73
vAlign (表格单元格垂直对齐)	§17.4.84
vMerge (垂直合并单元格)	§17.4.85

[注意：此元素的内容模型 (CT_TcPr) 的 W3C XML 架构定义位于 §A.1 中。 注释结束]

ISO/IEC29500：2008。

构造函数

TableCellProperties()	初始化 TableCellProperties 类的新实例。
TableCellProperties(IEnumerable<OpenXmlElement>)	使用指定的子元素初始化 TableCellProperties 类的新实例。
TableCellProperties(OpenXmlElement[])	使用指定的子元素初始化 TableCellProperties 类的新实例。
TableCellProperties(String)	从外部 XML 初始化 TableCellProperties 类的新实例。

属性

ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
ConditionalFormatStyle	ConditionalFormatStyle。 表示架构中的以下元素标记：w：cnfStyle。
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FirstChild	获取当前 OpenXmlElement 元素的第一个子元素。 (继承自 OpenXmlCompositeElement)
GridSpan	GridSpan。 表示架构中的以下元素标记：w：gridSpan。
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlCompositeElement)
HideMark	HideMark。 表示架构中的以下元素标记：w：hideMark。
HorizontalMerge	HorizontalMerge。 表示架构中的以下元素标记：w：hMerge。
InnerText	获取或设置当前节点及其所有子节点的串联值。 (继承自 OpenXmlCompositeElement)
InnerXml	获取或设置仅表示当前节点的子节点的标记。 (继承自 OpenXmlCompositeElement)
LastChild	获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlCompositeElement)
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
NoWrap	NoWrap。 表示架构中的以下元素标记：w：noWrap。
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
OuterXml	获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement)
Parent	获取当前元素的父元素。 (继承自 OpenXmlElement)
Prefix	获取当前元素的命名空间前缀。 (继承自 OpenXmlElement)
Shading	底纹。 表示架构中的以下元素标记：w：shd。
TableCellBorders	TableCellBorders。 表示架构中的以下元素标记：w：tcBorders。
TableCellFitText	TableCellFitText。 表示架构中的以下元素标记：w：tcFitText。
TableCellMargin	TableCellMargin。 表示架构中的以下元素标记：w：tcMar。
TableCellVerticalAlignment	TableCellVerticalAlignment。 表示架构中的以下元素标记：w：vAlign。
TableCellWidth	TableCellWidth。 表示架构中的以下元素标记：w：tcW。
TextDirection	TextDirection。 表示架构中的以下元素标记：w：textDirection。
VerticalMerge	VerticalMerge。 表示架构中的以下元素标记：w：vMerge。
XmlQualifiedName	获取当前元素的限定名称。 (继承自 OpenXmlElement)
XName	获取当前元素的限定名称。 (继承自 OpenXmlElement)

方法

AddAnnotation(Object)	将 对象添加到当前 OpenXmlElement 元素的批注列表中。 (继承自 OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	如果指定元素是已知的子元素，则将其添加到 元素。 这会根据架构将 元素添加到正确的位置。 (继承自 OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	将命名空间声明添加到当前节点。 (继承自 OpenXmlElement)
Ancestors()	枚举当前元素的所有上级。 (继承自 OpenXmlElement)
Ancestors<T>()	仅枚举具有指定类型的当前元素的上级。 (继承自 OpenXmlElement)
Annotation(Type)	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotation<T>()	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotations(Type)	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Annotations<T>()	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	将元素列表中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
Append(OpenXmlElement[])	将元素数组中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
AppendChild<T>(T)	将指定的元素追加到当前元素的子节点列表的末尾。 (继承自 OpenXmlCompositeElement)
ClearAllAttributes()	清除所有属性，包括已知属性和扩展属性。 (继承自 OpenXmlElement)
Clone()	创建当前节点的副本。 (继承自 OpenXmlElement)
CloneNode(Boolean)	创建此节点的副本。
Descendants()	枚举当前元素的所有后代。 (继承自 OpenXmlElement)
Descendants<T>()	枚举类型为 T 的当前元素的所有后代。 (继承自 OpenXmlElement)
Elements()	枚举当前元素的所有子元素。 (继承自 OpenXmlElement)
Elements<T>()	仅枚举具有指定类型的当前元素的子元素。 (继承自 OpenXmlElement)
ElementsAfter()	枚举与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
ElementsBefore()	枚举当前元素之前且具有与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
GetAttribute(String, String)	获取具有指定标记名称和命名空间 URI 的 Open XML 属性。 (继承自 OpenXmlElement)
GetAttributes()	获取一个列表，该列表包含所有属性的副本。 (继承自 OpenXmlElement)
GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)
GetFirstChild<T>()	查找类型 T 中的第一个子元素。 (继承自 OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	在指定的引用元素之后立即插入指定的元素。 (继承自 OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	在当前元素之后立即插入指定的元素。 (继承自 OpenXmlElement)
InsertAt<T>(T, Int32)	在当前元素的子元素的指定索引处插入指定的元素。 (继承自 OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	将指定的元素紧接在指定的引用元素之前。 (继承自 OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	将指定的元素紧接在当前元素的前面。 (继承自 OpenXmlElement)
IsAfter(OpenXmlElement)	确定当前元素是否以文档顺序显示在指定元素之后。 (继承自 OpenXmlElement)
IsBefore(OpenXmlElement)	确定当前元素是否按文档顺序显示在指定元素之前。 (继承自 OpenXmlElement)
LookupNamespace(String)	解析当前节点上下文中的命名空间前缀。 (继承自 OpenXmlElement)
LookupPrefix(String)	查找当前元素范围内命名空间 URI 的相应前缀。 (继承自 OpenXmlElement)
NextSibling()	获取紧跟在当前 OpenXmlElement 元素后面的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
NextSibling<T>()	获取具有当前 OpenXmlElement 元素后面的指定类型的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
PrependChild<T>(T)	在当前元素的子节点列表的开头插入指定的元素。 (继承自 OpenXmlCompositeElement)
PreviousSibling()	获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic ) 中 Nothing。 (继承自 OpenXmlElement)
PreviousSibling<T>()	获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
Remove()	从其父元素中删除当前元素。 (继承自 OpenXmlElement)
RemoveAllChildren()	删除当前元素的所有子元素。 (继承自 OpenXmlCompositeElement)
RemoveAllChildren<T>()	删除类型为 T 的当前元素的所有子元素。 (继承自 OpenXmlElement)
RemoveAnnotations(Type)	从当前 OpenXmlElement 元素中删除指定类型的注释。 (继承自 OpenXmlElement)
RemoveAnnotations<T>()	从当前 OpenXmlElement 元素中删除具有指定类型的批注。 (继承自 OpenXmlElement)
RemoveAttribute(String, String)	从当前元素中删除 属性。 (继承自 OpenXmlElement)
RemoveChild<T>(T)	删除指定的子元素。 (继承自 OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	删除指定前缀的命名空间声明。 如果没有前缀，则不删除任何内容。 (继承自 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	将当前元素的子元素之一替换为另一个 OpenXmlElement 元素。 (继承自 OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	将特性设置为指定的元素。 如果该属性是已知属性，则设置该特性的值。 如果该属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	设置元素的多个属性。 如果属性是已知属性，则会设置该属性的值。 如果属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
WriteTo(XmlWriter)	将当前节点保存到指定的 XmlWriter。 (继承自 OpenXmlElement)

显式接口实现

IEnumerable.GetEnumerator()	表单元格属性。 此类在 Office 2007 及更高版本中可用。 将对象序列化为 xml 时，其限定名称为 w：tcPr。 (继承自 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)