Bookmark.ConvertToTable Método

Definición

Espacio de nombres:

Microsoft.Office.Tools.Word

Ensamblado:

Microsoft.Office.Tools.Word.dll

Convierte el texto de un control Bookmark en una tabla.

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 el carácter utilizado para separar el texto en celdas. Puede ser un carácter o una de las siguientes WdTableFieldSeparator constantes: wdSeparateByCommas, wdSeparateByDefaultListSeparator, wdSeparateByParagraphso wdSeparateByTabs. Si se omite este argumento, se utiliza el valor de la DefaultTableSeparator propiedad .

NumRows

Object

Número de filas de la tabla. Si se omite este argumento, Microsoft Office Word establece el número de filas en función del contenido del control Bookmark.

NumColumns

Object

Número de columnas de la tabla. Si se omite este argumento, Word establece el número de columnas en función del contenido del control Bookmark.

InitialColumnWidth

Object

Ancho inicial de cada columna, en puntos. Si se omite este argumento, Word calcula y ajusta el ancho de columna para que la tabla se expanda de margen a margen.

Format

Object

Especifica uno de los formatos predefinidos enumerados en el cuadro de diálogo Autoformato de tablas. Puede ser una de las constantes WdTableFormat.

ApplyBorders

Object

true, para aplicar las propiedades de borde del formato especificado.

ApplyShading

Object

true, para aplicar las propiedades de sombreado del formato especificado.

ApplyFont

Object

true, para aplicar las propiedades de fuente del formato especificado.

ApplyColor

Object

true, para aplicar las propiedades de color del formato especificado.

ApplyHeadingRows

Object

true, para aplicar las propiedades de fila de título del formato especificado.

ApplyLastRow

Object

true, para aplicar las propiedades de la última fila del formato especificado.

ApplyFirstColumn

Object

true, para aplicar las propiedades de la primera columna del formato especificado.

ApplyLastColumn

Object

true, para aplicar las propiedades de la última columna del formato especificado.

AutoFit

Object

true, para disminuir el ancho de las columnas de la tabla tanto como sea posible sin cambiar la forma en que se ajusta el texto en la celda.

AutoFitBehavior

Object

Establece las reglas de autoajuste que definen la forma en que Word asigna el tamaño a una tabla. Puede ser una de las constantes WdAutoFitBehavior siguientes: wdAutoFitContent, wdAutoFitFixed, wdAutoFitWindow. Si DefaultTableBehavior es wdWord8TableBehavior, este argumento se omite.

DefaultTableBehavior

Object

Establece un valor que especifica si Word cambia automáticamente el tamaño de las celdas de una tabla para ajustar el contenido (AutoFit). Puede ser una de las constantes WdDefaultTableBehavior siguientes: wdWord8TableBehavior, wdWord9TableBehavior.

Devoluciones

Table

Un objeto Table.

Ejemplos

En el ejemplo de código siguiente se agrega un Bookmark control con texto al documento y, a continuación, se convierte el texto del marcador en una tabla.

Este ejemplo es para una personalización de nivel 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

Comentarios

Parámetros opcionales

Para obtener información sobre los parámetros opcionales, vea Parámetros opcionales en soluciones de Office.