Bookmark.ConvertToTable (Método)
Convierte el texto de un control Bookmark en una tabla.
Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)
Sintaxis
'Declaración
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
- Separator
Tipo: System.Object%
Especifica el carácter utilizado para separar el texto en celdas.Puede ser una de las siguientes constantes WdTableFieldSeparator: wdSeparateByCommas, wdSeparateByDefaultListSeparator, wdSeparateByParagraphs o wdSeparateByTabs.
Si se omite este argumento, se utilizará el valor actual de la propiedad DefaultTableSeparator.
- NumRows
Tipo: System.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
Tipo: System.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
Tipo: System.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
Tipo: System.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
Tipo: System.Object%
true, para aplicar las propiedades de borde del formato especificado.
- ApplyShading
Tipo: System.Object%
true, para aplicar las propiedades de sombreado del formato especificado.
- ApplyFont
Tipo: System.Object%
true, para aplicar las propiedades de fuente del formato especificado.
- ApplyColor
Tipo: System.Object%
true, para aplicar las propiedades de color del formato especificado.
- ApplyHeadingRows
Tipo: System.Object%
true, para aplicar las propiedades de fila de título del formato especificado.
- ApplyLastRow
Tipo: System.Object%
true, para aplicar las propiedades de la última fila del formato especificado.
- ApplyFirstColumn
Tipo: System.Object%
true, para aplicar las propiedades de la primera columna del formato especificado.
- ApplyLastColumn
Tipo: System.Object%
true, para aplicar las propiedades de la última columna del formato especificado.
- AutoFit
Tipo: System.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
Tipo: System.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, se omite este argumento.
- DefaultTableBehavior
Tipo: System.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.
Valor devuelto
Tipo: Microsoft.Office.Interop.Word.Table
Un objeto Table.
Comentarios
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
El ejemplo de código siguiente agrega un control Bookmark con texto al documento y, a continuación, convierte el texto del marcador en una tabla.
Se trata de un ejemplo para una personalización en el nivel del 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);
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.