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.