Bookmark.ConvertToTable, méthode
Convertit le texte d'un contrôle Bookmark en tableau.
Espace de noms : Microsoft.Office.Tools.Word
Assembly : Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)
Syntaxe
'Déclaration
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
)
Paramètres
- Separator
Type : System.Object%
Spécifie le caractère utilisé pour répartir le texte dans des cellules.Il peut s'agir d'un caractère ou d'une des constantes WdTableFieldSeparator suivantes : wdSeparateByCommas, wdSeparateByDefaultListSeparator, wdSeparateByParagraphs ou wdSeparateByTabs.
Si cet argument est omis, la valeur actuelle de la propriété DefaultTableSeparator est utilisée.
- NumRows
Type : System.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
Type : System.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
Type : System.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
Type : System.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.Il peut s'agir de l'une des constantes WdTableFormat.
- ApplyBorders
Type : System.Object%
true pour appliquer les propriétés de bordure du format spécifié.
- ApplyShading
Type : System.Object%
true pour appliquer les propriétés de trame de fond du format spécifié.
- ApplyFont
Type : System.Object%
true pour appliquer les propriétés de police du format spécifié.
- ApplyColor
Type : System.Object%
true pour appliquer les propriétés de couleur du format spécifié.
- ApplyHeadingRows
Type : System.Object%
true pour appliquer les propriétés de ligne de titre du format spécifié.
- ApplyLastRow
Type : System.Object%
true pour appliquer les propriétés de dernière ligne du format spécifié.
- ApplyFirstColumn
Type : System.Object%
true pour appliquer les propriétés de première colonne du format spécifié.
- ApplyLastColumn
Type : System.Object%
true pour appliquer les propriétés de dernière colonne du format spécifié.
- AutoFit
Type : System.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
Type : System.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
Type : System.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.
Valeur de retour
Type : Microsoft.Office.Interop.Word.Table
Table
Notes
Paramètres optionnels
Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.
Exemples
L'exemple de code suivant ajoute au document un contrôle Bookmark avec du texte, puis convertit le texte du signet en tableau.
Cet exemple illustre une personnalisation au niveau du document.
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);
}
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.