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 |