共用方式為


Bookmark.ConvertToTable 方法

定義

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 其中一個常數: wdSeparateByCommaswdSeparateByDefaultListSeparatorwdSeparateByParagraphswdSeparateByTabs。如果省略此自變數,則會使用 屬性的值 DefaultTableSeparator

NumRows
Object

表格中的列數。 如果省略這個引數,Microsoft Office Word 便會依據 Bookmark 控制項的內容設定列數。

NumColumns
Object

表格中的欄數。 如果省略這個引數,Microsoft Office 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 常數:wdAutoFitContentwdAutoFitFixedwdAutoFitWindow。 如果 為 DefaultTableBehaviorwdWord8TableBehavior,則會忽略這個自變數。

DefaultTableBehavior
Object

設定值,指定 Word 是否自動將表格儲存格重新調整成內容大小 (自動調整)。 這可以是下列其中一個 WdDefaultTableBehavior 常數:wdWord8TableBehaviorwdWord9TableBehavior

傳回

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 方案中的選擇性參數

適用於