通过

Bookmark.ConvertToTable 方法

  • 项目

将 Bookmark 控件中的文本转换为表。

命名空间：  Microsoft.Office.Tools.Word
程序集：  Microsoft.Office.Tools.Word（在 Microsoft.Office.Tools.Word.dll 中）

语法

声明
Function ConvertToTable ( _
    ByRef Separator As Object, _
    ByRef NumRows As Object, _
    ByRef NumColumns As Object, _
    ByRef InitialColumnWidth As Object, _
    ByRef Format As Object, _
    ByRef ApplyBorders As Object, _
    ByRef ApplyShading As Object, _
    ByRef ApplyFont As Object, _
    ByRef ApplyColor As Object, _
    ByRef ApplyHeadingRows As Object, _
    ByRef ApplyLastRow As Object, _
    ByRef ApplyFirstColumn As Object, _
    ByRef ApplyLastColumn As Object, _
    ByRef AutoFit As Object, _
    ByRef AutoFitBehavior As Object, _
    ByRef DefaultTableBehavior As Object _
) As Table

Table ConvertToTable(
    ref Object Separator,
    ref Object NumRows,
    ref Object NumColumns,
    ref Object InitialColumnWidth,
    ref Object Format,
    ref Object ApplyBorders,
    ref Object ApplyShading,
    ref Object ApplyFont,
    ref Object ApplyColor,
    ref Object ApplyHeadingRows,
    ref Object ApplyLastRow,
    ref Object ApplyFirstColumn,
    ref Object ApplyLastColumn,
    ref Object AutoFit,
    ref Object AutoFitBehavior,
    ref Object DefaultTableBehavior
)

参数

  • NumRows
    类型：System.Object%
    表的行数。如果省略此参数，则 Microsoft Office Word 根据 Bookmark 控件的内容设置行数。
  • NumColumns
    类型：System.Object%
    表中的列数。如果省略此参数，则 Word 根据 Bookmark 控件的内容设置列数。
  • InitialColumnWidth
    类型：System.Object%
    每一列的初始宽度（以磅为单位）。如果省略此参数，则 Word 计算并调整列宽度，以便表在边距间拉伸。
  • Format
    类型：System.Object%
    指定**“表格自动套用格式”**对话框中列出的预定义格式之一。可以是 WdTableFormat 常数之一。
  • ApplyBorders
    类型：System.Object%
    为 true，则应用指定格式的边框属性。
  • ApplyShading
    类型：System.Object%
    为 true，则应用指定格式的底纹属性。
  • ApplyFont
    类型：System.Object%
    为 true，则应用指定格式的字体属性。
  • ApplyColor
    类型：System.Object%
    为 true，则应用指定格式的颜色属性。
  • ApplyHeadingRows
    类型：System.Object%
    为 true，则应用指定格式的标题行属性。
  • ApplyLastRow
    类型：System.Object%
    为 true，则应用指定格式的最后一行属性。
  • ApplyFirstColumn
    类型：System.Object%
    为 true，则应用指定格式的第一列属性。
  • ApplyLastColumn
    类型：System.Object%
    为 true，则应用指定格式的最后一列属性。
  • AutoFit
    类型：System.Object%
    为 true，则在不更改单元格中的文本换行方式的情况下尽可能地缩小表列的宽度。

返回值

类型：Microsoft.Office.Interop.Word.Table
Table 。

备注

可选参数

有关可选参数的信息，请参见Office 解决方案中的可选参数。

示例

下面的代码示例向文档中添加一个带有文本的 Bookmark 控件，然后将该书签中的文本转换为表。

此示例针对的是文档级自定义项。

Private Sub BookmarkConvertToTable()

    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")

    Bookmark1.Text = "1,2,3,4,5,6"

    Dim Table1 As Word.Table = Bookmark1.ConvertToTable( _
        Separator:=Word.WdTableFieldSeparator.wdSeparateByCommas, _
        Format:=Word.WdTableFormat.wdTableFormatClassic1, _
        ApplyBorders:=True, AutoFit:=True, AutoFitBehavior:= _
        Word.WdAutoFitBehavior.wdAutoFitContent)

End Sub

private void BookmarkConvertToTable()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");
    bookmark1.Text = "1,2,3,4,5,6";

    object Separator = Word.WdTableFieldSeparator.wdSeparateByCommas;
    object Format = Word.WdTableFormat.wdTableFormatClassic1;
    object ApplyBorders = true;
    object AutoFit = true;
    object AutoFitBehavior = Word.WdAutoFitBehavior.wdAutoFitContent;

    Word.Table Table1 = bookmark1.ConvertToTable(ref Separator,
        ref missing, ref missing, ref missing, ref Format,
        ref ApplyBorders, ref missing, ref missing, ref missing,
        ref missing, ref missing, ref missing,
        ref missing, ref AutoFit, ref AutoFitBehavior,
        ref missing);
}

.NET Framework 安全性

请参见

参考

Bookmark 接口

Microsoft.Office.Tools.Word 命名空间