Bookmark.ConvertToTable-Methode
Konvertiert Text innerhalb eines Bookmark-Steuerelements in eine Tabelle.
Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)
Syntax
'Declaration
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
)
Parameter
- Separator
Typ: System.Object%
Gibt das Zeichen an, mit dem Text in Zellen unterteilt wird.Kann ein Zeichen oder eine der folgenden WdTableFieldSeparator-Konstanten sein: wdSeparateByCommas, wdSeparateByDefaultListSeparator, wdSeparateByParagraphs oder wdSeparateByTabs.
Wenn dieses Argument weggelassen wird, wird der Wert der DefaultTableSeparator-Eigenschaft verwendet.
- NumRows
Typ: System.Object%
Die Anzahl der Zeilen in der Tabelle.Wenn dieses Argument weggelassen wird, legt Microsoft Office Word die Anzahl der Zeilen auf der Grundlage des Inhalts des Bookmark-Steuerelements fest.
- NumColumns
Typ: System.Object%
Die Anzahl der Zeilen in der Tabelle.Wenn dieses Argument weggelassen wird, legt Word die Anzahl der Zeilen auf der Grundlage des Inhalts des Bookmark-Steuerelements fest.
- InitialColumnWidth
Typ: System.Object%
Die anfängliche Breite der einzelnen Spalten in Punkt.Wenn dieses Argument weggelassen wird, berechnet Word die Breite der Spalte und passt diese so an, dass die Tabelle von Rand zu Rand reicht.
- Format
Typ: System.Object%
Gibt eines der vordefinierten, im Dialogfeld AutoFormat für Tabelle aufgelisteten Formate an.Kann eine der WdTableFormat-Konstanten sein.
- ApplyBorders
Typ: System.Object%
true, um die Rahmeneigenschaften des angegebenen Formats anzuwenden.
- ApplyShading
Typ: System.Object%
true, um die Schattierungseigenschaften des angegebenen Formats anzuwenden.
- ApplyFont
Typ: System.Object%
true, um die Schriftarteigenschaften des angegebenen Formats anzuwenden.
- ApplyColor
Typ: System.Object%
true, um die Farbeigenschaften des angegebenen Formats anzuwenden.
- ApplyHeadingRows
Typ: System.Object%
true, um die Eigenschaften der Überschriftzeile des angegebenen Formats anzuwenden.
- ApplyLastRow
Typ: System.Object%
true, um die Eigenschaften der letzten Zeile des angegebenen Formats anzuwenden.
- ApplyFirstColumn
Typ: System.Object%
true, um die Eigenschaften der ersten Spalte des angegebenen Formats anzuwenden.
- ApplyLastColumn
Typ: System.Object%
true, um die Eigenschaften der letzten Spalte des angegebenen Formats anzuwenden.
- AutoFit
Typ: System.Object%
true, um die Breite der Tabellenspalten so weit wie möglich zu verringern, ohne den Zeilenumbruch in den Zellen zu verändern.
- AutoFitBehavior
Typ: System.Object%
Legt die AutoAnpassen-Regeln dafür fest, wie Word die Größe einer Tabelle bestimmt.Kann eine der folgenden WdAutoFitBehavior-Konstanten sein: wdAutoFitContent, wdAutoFitFixed oder wdAutoFitWindow.Wenn DefaultTableBehaviorwdWord8TableBehavior ist, wird dieses Argument ignoriert.
- DefaultTableBehavior
Typ: System.Object%
Legt einen Wert fest, der angibt, ob Word automatisch die Zellengröße dem Inhalt der Zelle anpasst (AutoAnpassen).Kann eine der folgenden WdDefaultTableBehavior-Konstanten sein: wdWord8TableBehavior oder wdWord9TableBehavior.
Rückgabewert
Typ: Microsoft.Office.Interop.Word.Table
Eine Table.
Hinweise
Optionale Parameter
Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.
Beispiele
Im folgenden Codebeispiel wird dem Dokument ein Bookmark-Steuerelement mit Text hinzugefügt und anschließend der Text im Lesezeichen in eine Tabelle konvertiert.
Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.
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);
}
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.