Bookmark.ConvertToTable Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Converte in una tabella il testo all'interno di un controllo Bookmark.
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
Parametri
- Separator
- Object
Specifica il carattere utilizzato per separare il testo in celle. Può essere un carattere o una delle costanti seguenti WdTableFieldSeparator : wdSeparateByCommas, wdSeparateByDefaultListSeparator, wdSeparateByParagraphso wdSeparateByTabs. Se questo argomento viene omesso, viene utilizzato il valore della DefaultTableSeparator proprietà .
- NumRows
- 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
- 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
- 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
- Object
Specifica uno dei formati predefiniti elencati nella finestra di dialogo Formattazione automatica tabella. Può essere una delle costanti WdTableFormat.
- ApplyBorders
- Object
true
per applicare le proprietà del bordo del formato specificato.
- ApplyShading
- Object
true
per applicare le proprietà dello sfondo del formato specificato.
- ApplyFont
- Object
true
per applicare le proprietà del tipo di carattere del formato specificato.
- ApplyColor
- Object
true
per applicare le proprietà del colore del formato specificato.
- ApplyHeadingRows
- Object
true
per applicare le proprietà della riga del titolo del formato specificato.
- ApplyLastRow
- Object
true
per applicare le proprietà dell'ultima riga del formato specificato.
- ApplyFirstColumn
- Object
true
per applicare le proprietà della prima colonna del formato specificato.
- ApplyLastColumn
- Object
true
per applicare le proprietà dell'ultima colonna del formato specificato.
- AutoFit
- 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
- 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 viene ignorato.
- DefaultTableBehavior
- 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.
Restituisce
Oggetto Table.
Esempio
Nell'esempio di codice seguente viene aggiunto un Bookmark controllo con testo al documento e quindi viene convertito il testo nel segnalibro in una tabella.
Questo esempio è relativo a una personalizzazione a livello di documento.
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
Commenti
Parametri facoltativi
Per informazioni sui parametri facoltativi, vedere parametri facoltativi nelle soluzioni Office.