TRichView文档结构3

9.2     Tabulators 制表位

制表位是指在水平标尺上的位置，指定文字缩进的距离或一栏文字开始之处，制表位是在文档左间距的基础上计算，通过ParaStyle的LefIndent、paraStyle的Tabs以及TRVSyle.DefTabWidth进行定义的。

9.3     Pictures 图片

Pictures item用来显示存储在Tgraphic对象中的一张图片，Delphi支持以下几种标准的图片类：

l TBitmap (stores bitmap (*.bmp), probably with transparency);

l TMetafile (stores 32-bit (*.emf) or 16-bit (*.wmf) metafile);

l TIcon (stores icon; this class does not work with icons having more than 16 colors properly);

l JpegImage (D3+; stores Jpegs (*.jpg));

l TGifImage (D2007+, stores Gifs (*.gif));

l PngImage (D2009+, stores Png (*.png)).

另外还支持一些第三方的图片类。

Pictures item附加属性有：

l rvepImageWidth, rvepImageHeight

拉伸图片

l rvepTransparent, rvepTransparentMode, rvepTransparentColor

定义图片的透明度

l rvepAnimationInterval

定义bitmap动画的时间间隔

l rvepMinHeightOnPage

允许将一张图片打印在多页上

l rvepSpacing

定义图片边距

l rvepResizable

l 定义是否可以改变大小，TIcon不支持

9.4     Hot-Pictures 带超链接的图片

Hot-Picures是带有超链接的图片，属性同Pictures，主要的不同是插入Hot-Pictures的方法不同。

9.5     Breaks分页（占满整行的水平线）

Break是一条指定宽度和颜色的水平线或矩形，它总是占一行。

9.6     Controls Delphi/C++Builder控件

Controls是添加到文档上的普通的Delphi/C++Builder可视化控件，额外属性有：

l rvepSpacing

定义控件边距

l rvepResizable

定义是否可以改变大小

l rvepVisible

定义是否可以隐藏控件

9.7     Bullets 项目符号

项目符号是TimageList中的一个图片，他与段落的项目符号和列表没有关系，主要用于在文档中重复使用一张小图片。

额外属性有：

l rvepSpacing

定义边距

9.8     Hotspots 带超链接的项目符号

HotSpots是带有超链接的Bullet Item，当获得鼠标焦点后可以改变图像

9.9     Tables 表格

TrichView中的表格中的单元格都是一个子文档，表格可以嵌套。

额外属性有：

l rvspImageFileName

当导出HTML文件时，用于保存背景图的文件位置

方法：

TcustomRichView

添加/获取表格

方法名称	参数	说明
AddItem	Const Text:String 表格名称
	Item:TcustomRVItemInfo 添加表格专用的TRVTableItemInfo
GetItem	ItemNo：Integer 表格的ItemNo	返回指定ItemNo的表格的TRVTableItemInfo

TcustomRichViewEdit

插入/获取光标处表格

方法名称	参数	说明
InsertItem	Const Text:String 表格名称
	Item:TcustomRVItemInfo 添加表格专用的TRVTableItemInfo
GetCurrentItem		返回当前光标处的表格的TRVTableItemInfo
GetCurrentItemEx	RequiredClass：TCustomRVItemInfoClass 这里是TRVTableItemInfo类	返回给定类型的当前光标处的对象
	ItemRichViewEdit:TCustomRichViewEdit 输出参数，返回保护了这个表格的编辑器或者单元格内部的编辑器，比如嵌套表格
	Item:TCustomRVItemInfo 输出参数，返回当前表格的TRVTableItemInfo

TRVTableItemInfo

TRVTableItemInfo是TrichView文档的表达类，该类的实例由TRichView在运行时创建，或者在AddItem或InsertItem时创建。

TRVTableItemInfo = class(TRVFullLineItemInfo)

属性列表
属性名称	类型	说明
表格外边框属性
BorderWidth 边框宽度	TRVStyleLength	设置为0表示隐藏边框
BorderStyle 边框类型	TRVTableBorderStyle Ø rvtbRaised Ø rvtbLowered Ø rvtbColor Ø rvtbRaisedColor Ø rvtbLoweredColor
BorderColor 边框颜色	TColor	默认为clWindowText
BorderLightColor 3D边框亮色	Tcolor	默认为clBtnHighlight
VisibleBorder 边框可见性	TRVBooleanRect 4个Boolean值，代表 左、上、右、下	默认为True、True、True、True
BorderHSpacing	TRVStyleLength	边框水平间距
BorderVSpacing	TRVStyleLength	边框垂直间距
单元格外边框属性
CellBorderWidth	同上
CellBorderStyle	同上
CellBorderColor	同上
CellBorderLightColor	同上
单元格间距
CellHSpacing	TRVStyleLength	单元格水平间距
CellVSpacing	TRVStyleLength	单元格垂直间距
BorderHSpacing	TRVStyleLength	单元格边框水平间距
BorderVSpacing	TRVStyleLength	单元格边框垂直间距
CellHPadding	TRVStyleLength	单元格水平填充
CellVPadding	TRVStyleLength	单元格垂直填充
背景
Color	Tcolor	背景颜色
BackgroundImage	TGraphic	背景图片
BackgroundStyle	TRVItemBackgroundStyle Ø rvbsColor颜色 Ø rvbsStretched拉伸 Ø rvbsTiled平铺 Ø rvbsCentered置中	背景样式
BackgroundImageFileName	String	背景外部图片文件名
边框颜色
BorderColor	Tcolor	边框颜色
BorderLightColor	Tcolor	边框高亮色
CellBorderColor	Tcolor	单元格颜色
CellBorderLightColor	Tcolor	单元格高亮色
Rules
HRuleWidth	TRVStyleLength	水平标尺宽度
HRuleColor	TRVStyleLength	水平标尺颜色
HOutermostRule	Boolean	默认值Flase 是否在表格边框和最外层单元格绘制水平标尺
VRuleWidth	TRVStyleLength	垂直标尺宽度
VRuleColor	TRVStyleLength	垂直标尺颜色
VOutermostRule	Boolean	默认值Flase 是否在表格边框和最外层单元格绘制垂直标尺
导出
TextColSeparator	表格列分隔符	默认值：#13#10
TextRowSeparator	表格行分隔符	默认值：#13#10
BackgroundImageFileName	外部背景图文件名
其他
Options
PrintOptions	TRVTablePrintOption Ø rvtoHalftoneBorders 设置则打印表格和单元格边框 不设置，将不打印颜色，只有黑白色 Ø rvtoRowsSplit 拆分行，如果不设置，可以避免将表格打印在多个页上 Ø rvtoWhiteBackground 不打印背景	默认值： rvtoHalftoneBorders rvtoRowsSplit
HeadingRowCount	Integer	默认值：0 重复表头的行数
方法列表
方法名称	参数	说明
插入行和列
InsertColsLeft	Count: Integer 插入的列数	在选中的单元左边插入列
InsertColsRight	Count: Integer 插入的列数	在选中的单元右边插入列
InsertRowsAbove	Count: Integer 插入的行数	在选中的单元上面插入行
InsertRowsBelow	Count: Integer 插入的行数	在选中的单元下面插入行
删除行和列
DeleteSelectedCols		删除选中列
DeleteSelectedRows		删除选中行
合并和分拆单元格
MergeSelectedCells 合并单元格	AllowMergeRC:Boolean =False，禁止合并	执行前通过CanMergeSelectedCells判断是否可以合并 必须在文档Formatted之后执行
UnmergeSelectedCells 取消合并	UnmergeRows:Boolean 如果True，将每个选中的单元格拆分到RowSpan（行跨度）行中 UnmergeCols:Boolean 如果True，将每个选中的单元格拆分到ColSpan（列跨度）列中
SplitSelectedCellsHorizontally 拆分成行	RowCount:Integer 行数	将单元格拆分成指定RowCount的行
SplitSelectedCellsVertically 拆分成列	ColCount:Integer 列数	将单元格拆分成指定ColCount的列
其他
InsertCols 插入列	Index:Integer 要插入的列前索引 Count:Integer 列数 CopyIndex:Integer 如果<>-1,指定为要复制属性的目标列序号
InsertRows 插入行	Index:Integer 要插入的行前索引 Count:Integer 行数 CopyIndex:Integer 如果<>-1,指定为要复制属性的目标行序号
DeleteCols 删除列	Index:Integer 要删除的第一个列的索引 Count:Integer 要删除的列数 DecreaseWidth:Boolean 是否自动调整宽度
DeleteRows 删除行	Index:Integer 要删除的第一个列的索引 Count:Integer 要删除的列数 DecreaseHeight:Boolean 是否自动调整高度
MergeCells 合并单元格	TopRow:Integer 起始行索引 LeftCol:Integer 起始列索引 ColSpan:Integer 合并的列数 RowSpan:Integer 合并的行数 AllowMergeRC:Boolean =False，禁止合并
UnmergeCells 取消合并格	TopRow:Integer 起始行索引 LeftCol:Integer 起始列索引 ColSpan:Integer 合并的列数 RowSpan:Integer 合并的行数 UnmergeRows: Boolean =True，不将行放到RowSpan行中 UnmergeCols: Boolean =True，不将列放到RowCol行中
DeleteEmptyRows 删除所有空行		删除所有只包含了nil单元格的行
DeleteEmptyCols 删除所有空列		删除所有只包含了nil单元格的列

9.10         List Markers 段落项目符号或编号

表示段落项目符号和列表的特殊Item，属性由TRVStyle.ListStyle定义

9.11         Labels 不能换行的类似于文本的控件

Label是类似于Text Item的非文本Item，Label不能折行，在Delphi/C++Builder 2009及后续版本中，label的文本是Unicode，之前的版本是ANSI；

其属性由TRVLabelItemInfo定义，其属性都与RVSytle中的属性有关联：

l 显示的文本样式使用TextStyle的样式

l Label的光标；

l Label的最小宽度(MinWidth属性)；

l Label的水平文本对齐 Alignment；

9.12         Numbered Sequences 编号序列

编号序列是显示数字的类似于Labels的Item，编号序列也不能折行。编号序列用于对图片、表格、公式进行编号。

其属性由TRVSeqItemInfo定义，主要有：

l SeqName：用于定义序列名称，保证相同SeqName的值能够连续，@footnote@和@endnte@被脚注和尾注保留使用。

l NumberType 定义编号类型，包括数字、罗马数字等

9.13         Endnotes尾注

尾注类似与编号序列，尾注包含子文档，尾注不在TrichView插入处显示，所有尾注都在文档尾部显示和打印。

9.14         Footnotes脚注

脚注类似与编号序列，脚注包含子文档，脚注不在TrichView插入处显示，所有尾注都在文档每页的尾部显示和打印。