Bookmark.ConvertToTable 方法

定义

命名空间:

Microsoft.Office.Tools.Word

程序集:

Microsoft.Office.Tools.Word.dll

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

public Microsoft.Office.Interop.Word.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);

abstract member ConvertToTable : obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj -> Microsoft.Office.Interop.Word.Table

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

参数

Separator

Object

指定用于将文本分隔成单元格的字符。 可以是字符或下列 WdTableFieldSeparator 常量之一： wdSeparateByCommas、 wdSeparateByDefaultListSeparator、 wdSeparateByParagraphs或 wdSeparateByTabs。如果省略此参数，则使用 属性的值 DefaultTableSeparator 。

NumRows

Object

表中的行数。 如果省略此参数，则 Microsoft Office Word 根据 Bookmark 控件的内容设置行数。

NumColumns

Object

表中的列数。 如果省略此参数，则 Word 根据 Bookmark 控件的内容设置列数。

InitialColumnWidth

Object

每一列的初始宽度（以磅为单位）。 如果省略此参数，则 Word 计算并调整列宽度，以便表在边距间拉伸。

Format

Object

指定“表格自动套用格式”对话框中列出的预定义格式之一。 可以是 WdTableFormat 常量之一。

ApplyBorders

Object

为 true，则应用指定格式的边框属性。

ApplyShading

Object

为 true，则应用指定格式的底纹属性。

ApplyFont

Object

为 true，则应用指定格式的字体属性。

ApplyColor

Object

为 true，则应用指定格式的颜色属性。

ApplyHeadingRows

Object

为 true，则应用指定格式的标题行属性。

ApplyLastRow

Object

为 true，则应用指定格式的最后一行属性。

ApplyFirstColumn

Object

为 true，则应用指定格式的第一列属性。

ApplyLastColumn

Object

为 true，则应用指定格式的最后一列属性。

AutoFit

Object

为 true，则在不更改单元格中的文本换行方式的情况下尽可能地缩小表列的宽度。

AutoFitBehavior

Object

设置规定 Word 如何调整表大小的自动调整规则。 可以是下列 WdAutoFitBehavior 常数之一：wdAutoFitContent、wdAutoFitFixed 或 wdAutoFitWindow。 如果 DefaultTableBehavior 为 wdWord8TableBehavior，则忽略此参数。

DefaultTableBehavior

Object

设置一个值，该值指定 Word 是否自动调整表中单元格的大小以适合内容（自动调整）。 可以是下列 WdDefaultTableBehavior 常数之一：wdWord8TableBehavior 或 wdWord9TableBehavior。

返回

Table

一个 Table。

示例

下面的代码示例将包含文本的 Bookmark 控件添加到文档中，然后将书签中的文本转换为表格。

此示例适用于文档级自定义项。

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);
}

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

注解

可选参数

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