Partilhar via

Método Bookmark.ConvertToTable

  • Artigo

Converte o texto dentro de um Bookmark o controle a uma tabela.

Namespace:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)

Sintaxe

'Declaração
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
)

Parâmetros

  • NumRows
    Tipo: System.Object%
    O número de linhas na tabela.Se esse argumento for omitido, o Word de Microsoft Office define o número de linhas com base no conteúdo do Bookmark de controle.
  • NumColumns
    Tipo: System.Object%
    O número de colunas na tabela.Se esse argumento for omitido, o Word define o número de colunas, com base no conteúdo do Bookmark de controle.
  • InitialColumnWidth
    Tipo: System.Object%
    A largura inicial de cada coluna, em pontos.Se esse argumento for omitido, o Word calcula e ajusta a largura da coluna para que a tabela se estenda de margem a margem.
  • Format
    Tipo: System.Object%
    Especifica um dos formatos predefinidos listados na AutoFormatação da tabela caixa de diálogo.Pode ser uma da WdTableFormat constantes.
  • ApplyBorders
    Tipo: System.Object%
    true Para aplicar as propriedades de borda do formato especificado.
  • ApplyShading
    Tipo: System.Object%
    true Para aplicar as propriedades de sombreamento do formato especificado.
  • ApplyFont
    Tipo: System.Object%
    true Para aplicar as propriedades de fonte do formato especificado.
  • ApplyColor
    Tipo: System.Object%
    true Para aplicar as propriedades de cor do formato especificado.
  • ApplyHeadingRows
    Tipo: System.Object%
    true Para aplicar as propriedades de linha de título do formato especificado.
  • ApplyLastRow
    Tipo: System.Object%
    true Para aplicar as propriedades de última linha do formato especificado.
  • ApplyFirstColumn
    Tipo: System.Object%
    true Para aplicar as propriedades da primeira coluna do formato especificado.
  • ApplyLastColumn
    Tipo: System.Object%
    true Para aplicar as propriedades de última coluna do formato especificado.
  • AutoFit
    Tipo: System.Object%
    true para diminuir a largura das colunas da tabela tanto quanto possível sem alterar a maneira como o texto é disposto nas células.

Valor de retorno

Tipo: Microsoft.Office.Interop.Word.Table
A Table.

Comentários

Optional Parameters

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

Exemplos

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

Este exemplo é para uma personalização em nível de documento.

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);
}

Segurança do .NET Framework

Consulte também

Referência

Bookmark Interface

Namespace Microsoft.Office.Tools.Word