Bookmark.ConvertToTable Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.Tools.Word

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

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Convertit le texte d'un contrôle Bookmark en tableau.

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

Paramètres

Separator: Object

Spécifie le caractère utilisé pour répartir le texte dans des cellules. Il peut s’agir d’un caractère ou de l’une des constantes suivantes WdTableFieldSeparator : wdSeparateByCommas, wdSeparateByDefaultListSeparator, wdSeparateByParagraphsou wdSeparateByTabs. Si cet argument est omis, la valeur de la DefaultTableSeparator propriété est utilisée.

NumRows: Object

Nombre de lignes du tableau. Si cet argument est omis, Microsoft Office Word définit le nombre de lignes, selon le contenu du contrôle Bookmark.

NumColumns: Object

Nombre de colonnes du tableau. Si cet argument est omis, Word définit le nombre de colonnes, selon le contenu du contrôle Bookmark.

InitialColumnWidth: Object

Largeur initiale de chaque colonne, en points. Si cet argument est omis, Word calcule et ajuste la largeur des colonnes de sorte que le tableau s'étende d'une marge à l'autre.

Format: Object

Spécifie l’un des formats prédéfinis répertoriés dans la boîte de dialogue Mise en forme automatique de tableau. Ce peut être l’une des constantes WdTableFormat.

ApplyBorders: Object

true pour appliquer les propriétés de bordure du format spécifié.

ApplyShading: Object

true pour appliquer les propriétés de trame de fond du format spécifié.

ApplyFont: Object

true pour appliquer les propriétés de police du format spécifié.

ApplyColor: Object

true pour appliquer les propriétés de couleur du format spécifié.

ApplyHeadingRows: Object

true pour appliquer les propriétés de ligne de titre du format spécifié.

ApplyLastRow: Object

true pour appliquer les propriétés de dernière ligne du format spécifié.

ApplyFirstColumn: Object

true pour appliquer les propriétés de première colonne du format spécifié.

ApplyLastColumn: Object

true pour appliquer les propriétés de dernière colonne du format spécifié.

AutoFit: Object

true pour diminuer autant que possible la largeur des colonnes du tableau sans modifier la façon dont le texte revient à la ligne dans les cellules.

AutoFitBehavior: Object

Définit les règles d'ajustement automatique appliquées par Word pour dimensionner un tableau. Il peut s'agir de l'une des constantes WdAutoFitBehavior suivantes : wdAutoFitContent, wdAutoFitFixed, wdAutoFitWindow. Si DefaultTableBehavior a la valeur wdWord8TableBehavior, cet argument est ignoré.

DefaultTableBehavior: Object

Définit une valeur qui spécifie si Word redimensionne automatiquement les cellules de tableau pour les adapter au contenu (ajustement automatique). Il peut s'agir de l'une des constantes WdDefaultTableBehavior suivantes : wdWord8TableBehavior, wdWord9TableBehavior.

Retours

Table

Un Table.

Exemples

L’exemple de code suivant ajoute un Bookmark contrôle avec du texte au document, puis convertit le texte du signet en tableau.

Cet exemple concerne une personnalisation au niveau du document.

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

Remarques

Paramètres facultatifs

Pour plus d’informations sur les paramètres facultatifs, consultez Paramètres facultatifs dans les solutions Office.

S’applique à

Partager via