Bookmark.ConvertToTable Метод (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Преобразует текст в элементе управления Bookmark в таблицу.

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)

Синтаксис

'Декларация
Public 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
'Применение
Dim instance As Bookmark
Dim Separator As Object
Dim NumRows As Object
Dim NumColumns As Object
Dim InitialColumnWidth As Object
Dim Format As Object
Dim ApplyBorders As Object
Dim ApplyShading As Object
Dim ApplyFont As Object
Dim ApplyColor As Object
Dim ApplyHeadingRows As Object
Dim ApplyLastRow As Object
Dim ApplyFirstColumn As Object
Dim ApplyLastColumn As Object
Dim AutoFit As Object
Dim AutoFitBehavior As Object
Dim DefaultTableBehavior As Object
Dim returnValue As Table

returnValue = instance.ConvertToTable(Separator, _
    NumRows, NumColumns, InitialColumnWidth, _
    Format, ApplyBorders, ApplyShading, _
    ApplyFont, ApplyColor, ApplyHeadingRows, _
    ApplyLastRow, ApplyFirstColumn, _
    ApplyLastColumn, AutoFit, AutoFitBehavior, _
    DefaultTableBehavior)

public 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 автоматически изменять размер ячеек в таблице для подгонки содержимого (функция автоподбора). Может принимать значение одной из следующих констант 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);
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

Поделиться через