Metodo Bookmark.ConvertToTable
Converte in una tabella il testo all'interno di un controllo Bookmark.
Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)
Sintassi
'Dichiarazione
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
)
Parametri
- Separator
Tipo: System.Object%
Specifica il carattere utilizzato per separare il testo in celle.Può essere un carattere o una delle seguenti costanti WdTableFieldSeparator: wdSeparateByCommas, wdSeparateByDefaultListSeparator, wdSeparateByParagraphs o wdSeparateByTabs.
Se questo argomento viene omesso, verrà utilizzato il valore della proprietà DefaultTableSeparator.
- NumRows
Tipo: System.Object%
Numero di righe nella tabella.Se questo argomento viene omesso, in Microsoft Office Word verrà impostato il numero di righe in base al contenuto del controllo Bookmark.
- NumColumns
Tipo: System.Object%
Numero di colonne nella tabella.Se questo argomento viene omesso, in Word verrà impostato il numero di colonne in base al contenuto del controllo Bookmark.
- InitialColumnWidth
Tipo: System.Object%
Larghezza iniziale di ciascuna colonna, in punti.Se questo argomento viene omesso, in Word verrà calcolata e regolata la larghezza delle colonne in modo che la tabella venga estesa da margine a margine.
- Format
Tipo: System.Object%
Specifica uno dei formati predefiniti elencati nella finestra di dialogo Formattazione automatica tabella.Può essere una delle costanti WdTableFormat.
- ApplyBorders
Tipo: System.Object%
true per applicare le proprietà del bordo del formato specificato.
- ApplyShading
Tipo: System.Object%
true per applicare le proprietà dello sfondo del formato specificato.
- ApplyFont
Tipo: System.Object%
true per applicare le proprietà del tipo di carattere del formato specificato.
- ApplyColor
Tipo: System.Object%
true per applicare le proprietà del colore del formato specificato.
- ApplyHeadingRows
Tipo: System.Object%
true per applicare le proprietà della riga del titolo del formato specificato.
- ApplyLastRow
Tipo: System.Object%
true per applicare le proprietà dell'ultima riga del formato specificato.
- ApplyFirstColumn
Tipo: System.Object%
true per applicare le proprietà della prima colonna del formato specificato.
- ApplyLastColumn
Tipo: System.Object%
true per applicare le proprietà dell'ultima colonna del formato specificato.
- AutoFit
Tipo: System.Object%
true per ridurre il più possibile la larghezza delle colonne della tabella senza modificare il modo in cui il testo viene mandato a capo nelle celle.
- AutoFitBehavior
Tipo: System.Object%
Imposta le regole di adattamento automatico relative al modo in cui in Word viene ridimensionata una tabella.Può essere una delle seguenti costanti WdAutoFitBehavior: wdAutoFitContent, wdAutoFitFixed, wdAutoFitWindow.Se DefaultTableBehavior è wdWord8TableBehavior, questo argomento verrà ignorato.
- DefaultTableBehavior
Tipo: System.Object%
Imposta un valore che specifica se in Word le celle di una tabella vengono ridimensionate automaticamente per adattarne il contenuto (adattamento automatico).Può essere una delle seguenti costanti WdDefaultTableBehavior: wdWord8TableBehavior, wdWord9TableBehavior.
Valore restituito
Tipo: Microsoft.Office.Interop.Word.Table
Oggetto Table.
Note
Parametri facoltativi
Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.
Esempi
Nell'esempio di codice seguente viene aggiunto un controllo Bookmark con testo al documento e il testo nel segnalibro viene convertito in una tabella.
Questo esempio è valido per una personalizzazione a livello di 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);
}
Sicurezza di .NET Framework
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.