共用方式為

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%
    表格中的欄數。如果省略這個引數，Microsoft Office 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 命名空間