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
)

パラメーター

• Separator
  型 : System.Object%
  テキストをセルに区切るための文字を指定します。文字または WdTableFieldSeparator 定数 (wdSeparateByCommas、wdSeparateByDefaultListSeparator、wdSeparateByParagraphs、wdSeparateByTabs) のいずれかです。
  この引数を省略した場合は、DefaultTableSeparator プロパティの値が使用されます。

• 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。

• AutoFitBehavior
  型 : System.Object%
  Word が表のサイズを決定する方法の設定には、自動調整の規則を設定します。WdAutoFitBehavior 定数 (wdAutoFitContent、wdAutoFitFixed、wdAutoFitWindow) のいずれかです。 DefaultTableBehavior に wdWord8TableBehavior を指定すると、この引数は無視されます。

• DefaultTableBehavior
  型 : System.Object%
  Word が表内のセルのサイズを内容に合わせて自動的に変更する (AutoFit) かどうかを指定する値を設定します。WdDefaultTableBehavior 定数 (wdWord8TableBehavior または wdWord9TableBehavior) のどちらかです。

戻り値

型 : 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 名前空間