Bookmark.ConvertToTable 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將 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.TablePublic 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 。
- 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。 如果 為 DefaultTableBehaviorwdWord8TableBehavior，則會忽略這個自變數。
- DefaultTableBehavior
- Object
設定值，指定 Word 是否自動將表格儲存格重新調整成內容大小 (自動調整)。 這可以是下列其中一個 WdDefaultTableBehavior 常數：wdWord8TableBehavior 或 wdWord9TableBehavior。
傳回
範例
下列程式代碼範例會將含有文字的控件新增 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 方案中的選擇性參數。