TRichView文档结构2

9                Item的属性和方法

9.1     Text Item 文本

Text Item用来显示ANSI或Unicode字符串，主要的属性在TextStyle中进行定义；

TextItem不能包含以下内容：

n CR 和LF（#13和#10）字符，即回车和换行

n TAB（#09）tab键字符

n #0字符，即空字符

n FF（#12）字符，即换页符

方法：

TcustomRichView

添加Text Item

n 单个Item方法

在文档尾部添加单个Ietm，并通过Sytle-No设置TextStyle和ParaNo设置ParaStyle

方法名称	参数	说明
AddNLTag	s:String text item的文本	Text Item不能包含 CR 回车 LF 换行 TAB 步进 FF 换页
	StyleNo:Integer TextStyle的序号
	ParaNo:Integer ParaStyle的序号
	Tag:Integer TextItem的Tag
AddNLATag	Const s:TRVAnsiString 传入Ansi格式字符串
	StyleNo:Integer TextStyle的序号
	ParaNo:Integer ParaStyle的序号
	Tag:Integer TextItem的Tag
ADDNLWTag	Const s:TRVUnicodeString 传入Unicode格式字符串
	StyleNo:Integer TextStyle的序号
	ParaNo:Integer ParaStyle的序号
	Tag:Integer TextItem的Tag
AddNL	等同于 AddNLTag(…,0)	缩略版本，不带Tag标记
Add	等同于 AddNLTag(…,-1,0)	缩略版本，不带paraNo和Tag标记
AddTag	AddNLTag(s,StyleNo,-1,Tag)	缩略版本，不带paraNo标记

n 多个Item方法

用于在文档上尾部添加多行text item

方法名称	参数	说明
AddTextNL	s:String text item的文本	TextItem可以包含 CR 回车 LF 换行 TAB 步进 FF 换页
	StyleNo:Integer TextStyle的序号
	FirstParaNo:Integer 第一行的ParaStyle的序号 如果=-1延续上一行 如果>0，设置新的paraStyle
	OtherParaNo:Integer TextItem的Tag 设置其他行的paraSytle,必须>0
AddTextNLA	s:TRVAnsiString text item的文本	TextItem可以包含 CR 回车 LF 换行 TAB 步进 FF 换页
	StyleNo:Integer TextStyle的序号
	FirstParaNo:Integer 第一行的ParaStyle的序号 如果=-1延续上一行 如果>0，设置新的paraStyle
	OtherParaNo:Integer TextItem的Tag 设置其他行的paraSytle,必须>0
AddTextNLW	s:TRVUnicodeString text item的文本	TextItem可以包含 CR 回车 LF 换行 TAB 步进 FF 换页
	StyleNo:Integer TextStyle的序号
	FirstParaNo:Integer 第一行的ParaStyle的序号 如果=-1延续上一行 如果>0，设置新的paraStyle
	OtherParaNo:Integer TextItem的Tag 设置其他行的paraSytle,必须>0
	DefAsSingleParagraph:Boolean False:使用当前的添加段落模式 True：将#13回车和#10换行认为是行分割，而不是段落分割

修改Text Item

方法名称	参数	说明
SetItemText	ItemNo:Integer 要修改的Text item的序号
	Const s:String 要修改的字符串
SetItemTextA	ItemNo:Integer 要修改的Text item的序号
	S:TRVAnsiString Ansi字符串
SetItemTextW	ItemNo:Integer 要修改的Text item的序号
	S:TRVUnicodeString Unicode的字符串

获取Text Item

方法名称	参数	说明
GetItemText	ItemNo:Integer 要修改的Text item的序号	返回String
GetItemTextA	ItemNo:Integer 要修改的Text item的序号	返回TRVAnsiString
GetItemTextW	ItemNo:Integer 要修改的Text item的序号	返回TRVUnicodeString

从文件或流添加文本

方法名称	参数	说明
LoadText	Const FileName:String 文件名
	StyleNo TextStyle的序号
	ParaNo ParaStyle的序号
	AsSingleParagraph False:使用当前的添加段落模式 True：将#13回车和#10换行认为是行分割，而不是段落分割
LoadTextW	同上	支持Unicode标记字符
LoadTextFromStream	Stream:Tstream 流
LoadTextFromStreamW	Stream:Tstream 流	返回TRVUnicodeString

 

TCustomRichViewEdit

插入Text Item

n 单个Item方法

在光标处插入单个Ietm，插入的text item具有当前光标处的TextSytle和ParaStyle

方法名称	参数	说明
InsertStringTag 返回值：Boolean	s:String text item的文本	l S参数不能包含 CR 回车 LF 换行 FF 换页 l TAB被替换成空格，即使设置SpaceInTab=0 l 插入的字符串不与周围的textitem合并，即使是有相同的textSytle和Tag
	Tag:Integer TextItem的Tag
InsertStringATag 返回值：Boolean	Const s:TRVAnsiString 传入Ansi格式字符串
InsertStringWTag 返回值：Boolean	Const s: TRVUnicodeString 传入Unicode格式字符串

n 多个Item方法

插入具有

方法名称	参数	说明
InsertText 返回值：Boolean	Const text:String text item的文本	l S参数可以包含 CR 回车 LF 换行 FF 换页 Tab 步进 l CaretBefore=True 表示完成操作后，光标在Item的前面 CaretBefore=False 表示完成操作后，光标在Item的后面
	CaretBefore:Boolean=False TextItem的Tag
InsertTextA 返回值：Boolean	Const text:TRVAnsiString 传入Ansi格式字符串
InsertTextW 返回值：Boolean	Const text: TRVUnicodeString 传入Unicode格式字符串

修改Text Item

在编辑模式下，修改textItm的文本，或者非文本item的name

方法名称	参数	说明
SetItemTextEd	ItemNo:Integer 要修改的Text item的序号
	Const s:String 要修改的字符串
SetItemTextEdA	ItemNo:Integer 要修改的Text item的序号
	S:TRVAnsiString Ansi字符串
SetItemTextEdW	ItemNo:Integer 要修改的Text item的序号
	S:TRVUnicodeString Unicode的字符串
SetCurrentItemText	Const s:String 修改的值	等同于TopLevelEditor.SetItemTextEd(TopLevelEditor.CurItemNo, s)
SetCurrentItemTextA	Const s:TRVAnsiString 修改的值	等同于 TopLevelEditor.SetItemTextEdA(TopLevelEditor.CurItemNo, s)
SetCurrentItemTextW	Const s:TRVUnicodeString 修改的值	等同于 TopLevelEditor.SetItemTextEdW(TopLevelEditor.CurItemNo, s)

获取Text Item

返回当前光标出的Text Item

方法名称	参数	说明
GetCurrentItemText	ItemNo:Integer 要修改的Text item的序号	返回String 等同于 TopLevelEditor.GetItemText(TopLevelEditor.CurItemNo).
GetCurrentItemTextA	ItemNo:Integer 要修改的Text item的序号	返回TRVAnsiString 等同于 TopLevelEditor.GetItemTextA(TopLevelEditor.CurItemNo)
GetCurrentItemTextW	ItemNo:Integer 要修改的Text item的序号	返回TRVUnicodeString 等同于 TopLevelEditor.GetItemTextW(TopLevelEditor.CurItemNo)

从文件插入文本

从文件插入文本Item，并具有当前的TextStyle和ParaStyle

方法名称	参数	说明
InsertTextFromFile	Const FileName:String 文件名	如果当前的textStyle是Unicode，会自动转换成Unicode
InsertTextFromFileW	同上	支持Unicode标记字符 如果当前的textStyle是ANSI，会自动转换成ANSI