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 |
插入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 |