Aspose.Words使用教程之插入文档元素(一)
1.插入文本的字符串:
插入文本的字符串需要通过DocumentBuilder.Write方法插入到文档。文本格式是由字体属性决定,这个对象包含不同的字体属性(字体名称,字体大小,颜色,等等)。
一些重要的字体属性也由[{ { DocumentBuilder } }]属性允许您直接访问它们。这些都是布尔属性[{{Font.Bold}}],[{{Font.Italic}}], and [{{Font.Underline}}]。
注意字符格式设置将适用于所有插入的文本。
Example
使用DocumentBuilder插入格式化文本
c#
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")