如何:创建 Word 表

更新:2007 年 11 月

适用对象

本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。

项目类型

  • 文档级项目

  • 应用程序级项目

Microsoft Office 版本

  • Word 2003

  • Word 2007

有关更多信息,请参见按应用程序和项目类型提供的功能

Tables 集合是 Microsoft.Office.Interop.Word.DocumentMicrosoft.Office.Tools.Word.DocumentSelectionRange 类的成员,这意味着您可以在其中任何上下文中创建一个表。可以使用 Tables 集合的 Add 方法在指定的范围添加表。

在文档级自定义项中创建表

向文档中添加简单的表

  • 使用 Add 方法在文档开头添加一个由三行四列组成的表。

    若要使用下面的代码示例,请从项目内的 ThisDocument 类中运行此示例。

    Dim tableLocation As Word.Range = Me.Range(Start:=0, End:=0)
    Me.Tables.Add(Range:=tableLocation, NumRows:=3, NumColumns:=4)
    
    object start = 0;
    object end = 0;
    
    Word.Range tableLocation = this.Range(ref start, ref end);
    this.Tables.Add(tableLocation, 3, 4, ref missing, ref missing);
    

创建表时,该表会自动添加到 Microsoft.Office.Tools.Word.Document 宿主项的 Tables 集合中。然后,您可以使用 Item 属性按表的项编号引用该表,如以下代码所示。

通过项编号引用表

  • 使用 Item 属性并提供要引用的表的项编号。

    若要使用下面的代码示例,请从项目内的 ThisDocument 类中运行此示例。

    Dim newTable As Word.Table = Me.Tables.Item(1)
    
    Word.Table newTable = this.Tables[1];
    

每个 Table 对象还有一个 Range 属性 (property),通过该属性可以设置格式设置属性 (attribute)。

对表应用样式

  • 使用 Style 属性对表应用 Word 内置样式之一。

    若要使用下面的代码示例,请从项目内的 ThisDocument 类中运行此示例。

    Me.Tables.Item(1).Range.Font.Size = 8
    Me.Tables.Item(1).Style = "Table Grid 8"
    
    object styleName = "Table Grid 8";
    
    this.Tables[1].Range.Font.Size = 8;
    this.Tables[1].set_Style(ref styleName);
    

在应用程序级外接程序中创建表

向文档中添加简单的表

  • 使用 Add 方法在文档开头添加一个由三行四列组成的表。

    下面的代码示例向活动文档中添加表。若要使用此示例,请从项目内的 ThisAddIn 类中运行此示例。

    Dim tableLocation As Word.Range = Me.Application.ActiveDocument.Range(Start:=0, End:=0)
    Me.Application.ActiveDocument.Tables.Add(Range:=tableLocation, NumRows:=3, NumColumns:=4)
    
    object start = 0;
    object end = 0;
    
    Word.Range tableLocation = 
        this.Application.ActiveDocument.Range(ref start, ref end);
    this.Application.ActiveDocument.Tables.Add(
        tableLocation, 3, 4, ref missing, ref missing);
    

创建表时,该表会自动添加到 Microsoft.Office.Interop.Word.DocumentTables 集合中。然后,您可以使用 Item 属性按表的项编号引用该表,如以下代码所示。

通过项编号引用表

  • 使用 Item 属性并提供要引用的表的项编号。

    下面的代码示例使用活动文档。若要使用此示例,请从项目内的 ThisAddIn 类中运行此示例。

    Dim newTable As Word.Table = Me.Application.ActiveDocument.Tables.Item(1)
    
    Word.Table newTable = this.Application.ActiveDocument.Tables[1];
    

每个 Table 对象还有一个 Range 属性 (property),通过该属性可以设置格式设置属性 (attribute)。

对表应用样式

  • 使用 Style 属性对表应用 Word 内置样式之一。

    下面的代码示例使用活动文档。若要使用此示例,请从项目内的 ThisAddIn 类中运行此示例。

    Me.Application.ActiveDocument.Tables.Item(1).Range.Font.Size = 8
    Me.Application.ActiveDocument.Tables.Item(1).Style = "Table Grid 8"
    
    object styleName = "Table Grid 8";
    
    this.Application.ActiveDocument.Tables[1].Range.Font.Size = 8;
    this.Application.ActiveDocument.Tables[1].set_Style(ref styleName);
    

请参见

任务

如何:向 Word 表中的单元格添加文本和格式设置

如何:向 Word 表添加行和列

如何:用文档属性填充 Word 表

概念

了解 Office 解决方案中的可选参数