Bookmark.ConvertToTable Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Word

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

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Konvertiert Text innerhalb eines Bookmark-Steuerelements in eine Tabelle.

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

Parameter

Separator: Object

Gibt das Zeichen an, mit dem Text in Zellen unterteilt wird. Kann ein Zeichen oder eine der folgenden WdTableFieldSeparator Konstanten sein: wdSeparateByCommas, wdSeparateByDefaultListSeparator, wdSeparateByParagraphsoder wdSeparateByTabs. Wenn dieses Argument weggelassen wird, wird der Wert der DefaultTableSeparator -Eigenschaft verwendet.

NumRows: 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: Object

Die Anzahl der Spalten in der Tabelle. Wenn dieses Argument weggelassen wird, legt Word die Anzahl der Zeilen auf der Grundlage des Inhalts des Bookmark-Steuerelements fest.

InitialColumnWidth: 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: Object

Gibt eines der vordefinierten, im Dialogfeld AutoFormat für Tabelle aufgelisteten Formate an. Einer der folgenden WdTableFormat-Konstanten ist möglich.

ApplyBorders: Object

true, um die Rahmeneigenschaften des angegebenen Formats anzuwenden.

ApplyShading: Object

true, um die Schattierungseigenschaften des angegebenen Formats anzuwenden.

ApplyFont: Object

true, um die Schriftarteigenschaften des angegebenen Formats anzuwenden.

ApplyColor: Object

true, um die Farbeigenschaften des angegebenen Formats anzuwenden.

ApplyHeadingRows: Object

true, um die Eigenschaften der Überschriftzeile des angegebenen Formats anzuwenden.

ApplyLastRow: Object

true, um die Eigenschaften der letzten Zeile des angegebenen Formats anzuwenden.

ApplyFirstColumn: Object

true, um die Eigenschaften der ersten Spalte des angegebenen Formats anzuwenden.

ApplyLastColumn: Object

true, um die Eigenschaften der letzten Spalte des angegebenen Formats anzuwenden.

AutoFit: Object

true, um die Breite der Tabellenspalten so weit wie möglich zu verringern, ohne den Zeilenumbruch in den Zellen zu verändern.

AutoFitBehavior: 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 DefaultTableBehavior ist wdWord8TableBehavior, wird dieses Argument ignoriert.

DefaultTableBehavior: 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.

Gibt zurück

Table

einen Table

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 gilt für eine Anpassung auf Dokumentebene.

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

Hinweise

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Projektmappen.

Gilt für: