Bookmark.ConvertToTable Método

Referência

Definição

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Converte o texto em um controle Bookmark para uma tabela.

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

Parâmetros

Separator: Object

Especifica o caractere usado para separar o texto em células. Pode ser um caractere ou uma das seguintes WdTableFieldSeparator constantes: wdSeparateByCommas, wdSeparateByDefaultListSeparator, wdSeparateByParagraphsou wdSeparateByTabs. Se esse argumento for omitido, o valor da DefaultTableSeparator propriedade será usado.

NumRows: Object

O número de linhas da tabela. Se esse argumento for omitido, o Microsoft Office Word definirá o número de linhas com base no conteúdo do controle Bookmark.

NumColumns: Object

O número de colunas na tabela. Se esse argumento for omitido, o Word definirá o número de colunas com base no conteúdo do controle Bookmark.

InitialColumnWidth: Object

A largura inicial de cada coluna, em pontos. Se esse argumento for omitido, o Word calculará e ajustará a largura da coluna para que a tabela se estenda de margem a margem.

Format: Object

Especifica um dos formatos predefinidos listados na caixa de diálogo Formatação Automática da Tabela. Pode ser uma das constantes WdTableFormat.

ApplyBorders: Object

true para aplicar as propriedades de borda do formato especificado.

ApplyShading: Object

true para aplicar as propriedades de sombreamento do formato especificado.

ApplyFont: Object

true para aplicar as propriedades de fonte do formato especificado.

ApplyColor: Object

true para aplicar as propriedades de cor do formato especificado.

ApplyHeadingRows: Object

true para aplicar as propriedades de linha de título do formato especificado.

ApplyLastRow: Object

true para aplicar as propriedades de última linha do formato especificado.

ApplyFirstColumn: Object

true para aplicar as propriedades de primeira coluna do formato especificado.

ApplyLastColumn: Object

true para aplicar as propriedades de última coluna do formato especificado.

AutoFit: Object

true para diminuir a largura das colunas da tabela tanto quanto possível, sem alterar a maneira como o texto está disposto nas células.

AutoFitBehavior: Object

Define as regras de AutoAjuste em relação à forma como o Word dimensiona as tabelas. Pode ser uma das seguintes constantes de WdAutoFitBehavior: wdAutoFitContent, wdAutoFitFixed ou wdAutoFitWindow. Se DefaultTableBehavior for wdWord8TableBehavior, esse argumento será ignorado.

DefaultTableBehavior: Object

Define um valor que especifica se o Word redimensiona automaticamente as células em uma tabela para ajustar o conteúdo (AutoAjuste). Pode ser uma das seguintes constantes de WdDefaultTableBehavior: wdWord8TableBehavior ou wdWord9TableBehavior.

Retornos

Table

Uma Table.

Exemplos

O exemplo de código a seguir adiciona um Bookmark controle com texto ao documento e converte o texto no indicador em uma tabela.

Este exemplo destina-se a uma personalização no nível de documento.

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

Comentários

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Aplica-se a

Compartilhar via