【连载】Aspose.Words使用教程之插入文档元素(一)

1.插入文本的字符串：

插入文本的字符串需要通过DocumentBuilder.Write方法插入到文档。文本格式是由字体属性决定，这个对象包含不同的字体属性(字体名称,字体大小,颜色,等等)。
 
一些重要的字体属性也由[{ { DocumentBuilder } }]属性允许您直接访问它们。这些都是布尔属性[{{Font.Bold}}],[{{Font.Italic}}], and [{{Font.Underline}}]。

注意字符格式设置将适用于所有插入的文本。

Example

使用DocumentBuilder插入格式化文本

DocumentBuilder builder = new DocumentBuilder();
// Specify font formatting before adding text.
Aspose.Words.Font font = builder.Font;
font.Size = 16;
font.Bold = true;
font.Color = Color.Blue;
font.Name = "Arial";
font.Underline = Underline.Dash;
builder.Write("Sample text.");

Visual Basic

Dim builder As New DocumentBuilder()
‘ Specify font formatting before adding text.
Dim font As Aspose.Words.Font = builder.Font
font.Size = 16
font.Bold = True
font.Color = Color.Blue
font.Name = "Arial"
font.Underline = Underline.Dash
builder.Write("Sample text.")

2.插入一个段落

DocumentBuilder.Writeln可以插入一段文本的字符串也能添加一个段落。当前字体格式也也是

DocumentBuilder所规定。字体属性和当前段落格式是由DocumentBuilder.ParagraphFormat属性所决

定。

Example

如何添加一个段落到文档

C#

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Specify font formatting
Aspose.Words.Font font = builder.Font;
font.Size = 16;
font.Bold = true;
font.Color = System.Drawing.Color.Blue;
font.Name = "Arial";
font.Underline = Underline.Dash;
// Specify paragraph formatting
ParagraphFormat paragraphFormat = builder.ParagraphFormat;
paragraphFormat.FirstLineIndent = 8;
paragraphFormat.Alignment = ParagraphAlignment.Justify;
paragraphFormat.KeepTogether = true;
builder.Writeln("A whole paragraph.");

Visual Basic

Dim doc As New Document()
Dim builder As New DocumentBuilder(doc)
‘ Specify font formatting
Dim font As Aspose.Words.Font = builder.Font
font.Size = 16
font.Bold = True
font.Color = System.Drawing.Color.Blue
font.Name = "Arial"
font.Underline = Underline.Dash
‘ Specify paragraph formatting
Dim paragraphFormat As ParagraphFormat = builder.ParagraphFormat
paragraphFormat.FirstLineIndent = 8
paragraphFormat.Alignment = ParagraphAlignment.Justify
paragraphFormat.KeepTogether = True
builder.Writeln("A whole paragraph.")

3.插入一张表

使用DocumentBuilder创建一个表的基本算法是非常简单的：

1.使用[{{DocumentBuilder.StartTable}}]启动表；

2.使用[{{DocumentBuilder.InsertCell}}]插入单元格，这自动生成一个新行，如果需要，使用 [{{DocumentBuilder.CellFormat}}]属性来指定单元格格式；

3.使用DocumentBuilder.methods写入单元格内容；

4.重复步骤2和3,直到行内容写完；

5.调用[{{DocumentBuilder.EndRow}}]来结束当前的行，如果需要，使用[{ { DocumentBuilder.RowFormat }}]属性来指定行格式;

6.重复步骤2 - 5直到表完成;

7.调用[{{DocumentBuilder.EndTable}}]来完成表的创建。

Example

如何创建一个2行2列的格式化表格：

C#

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Table table = builder.StartTable();
// Insert a cell
builder.InsertCell();
// Use fixed column widths.
table.AutoFit(AutoFitBehavior.FixedColumnWidths);
builder.CellFormat.VerticalAlignment = CellVerticalAlignment.Center;
builder.Write("This is row 1 cell 1");
// Insert a cell
builder.InsertCell();
builder.Write("This is row 1 cell 2");
builder.EndRow();
// Insert a cell
builder.InsertCell();
// Apply new row formatting
builder.RowFormat.Height = 100;
builder.RowFormat.HeightRule = HeightRule.Exactly;
builder.CellFormat.Orientation = TextOrientation.Upward;
builder.Writeln("This is row 2 cell 1");
// Insert a cell
builder.InsertCell();
builder.CellFormat.Orientation = TextOrientation.Downward;
builder.Writeln("This is row 2 cell 2");
builder.EndRow();
builder.EndTable();

Visual Basic

Dim doc As New Document()
Dim builder As New DocumentBuilder(doc)
Dim table As Table = builder.StartTable()
‘ Insert a cell
builder.InsertCell()
‘ Use fixed column widths.
table.AutoFit(AutoFitBehavior.FixedColumnWidths)
builder.CellFormat.VerticalAlignment = CellVerticalAlignment.Center
builder.Write("This is row 1 cell 1")
‘ Insert a cell
builder.InsertCell()
builder.Write("This is row 1 cell 2")
builder.EndRow()
‘ Insert a cell
builder.InsertCell()
‘ Apply new row formatting
builder.RowFormat.Height = 100
builder.RowFormat.HeightRule = HeightRule.Exactly
builder.CellFormat.Orientation = TextOrientation.Upward
builder.Writeln("This is row 2 cell 1")
‘ Insert a cell
builder.InsertCell()
builder.CellFormat.Orientation = TextOrientation.Downward
builder.Writeln("This is row 2 cell 2")
builder.EndRow()
builder.EndTable()

Aspose.Words最新版免费下载