English: lcl-differences.en.md
TyControls 的属性名和语义尽量与 LCL 一致,从 Lazarus 移植的代码大多不用改。下面这些地方是故意不同的,移植时请留意。
| 属性 | TyControls | LCL | 说明 |
|---|---|---|---|
AutoSize(标签、编辑框、组合框、复选框、单选按钮) |
False |
True |
高度跟主题走;需要按内容定尺寸时显式打开 |
TTyMemo.WordWrap |
False |
True |
长行横向滚动 |
TTyMemo.ScrollBars |
ssAutoVertical |
ssNone |
内容超出时才出现竖向滚动条 |
TTyNumericEdit.Alignment(及其子类) |
taRightJustify |
taLeftJustify |
数字右对齐 |
TTyRadioButton.TabStop |
True |
False |
每个单选按钮都能用 Tab 到达 |
TTySpeedButton.Spacing |
-1 |
4 |
-1 表示图标与文字的间距由主题的 --glyph-button-gap 决定 |
TTyCoolBar.ShowText、TTyCoolBand.Break |
False |
True |
|
TTyStatusBar.SimplePanel |
False |
True |
没有面板的状态栏照样显示 SimpleText |
TTyTreeView.RightClickSelect |
True |
False |
右键先选中节点,再弹出菜单 |
TTyListView.ReadOnly |
True |
False |
需要原地改名时设为 False |
TTyScrollBar.Kind |
sbVertical |
sbHorizontal |
见 TTyScrollBar |
TTyScrollBar.LargeChange |
0 |
1 |
0 表示按 PageSize 翻页,见 TTyScrollBar |
- 像素属性都是逻辑像素(96 PPI 下的像素)。宽度、高度、内边距、
BorderWidth等由控件按自己的 PPI 缩放,高 DPI 下不用手工换算。 TTyScrollBar.Position可以到达Max。 LCL 的滚动条最大只到Max - PageSize + 1。TabStop = False的控件点击时不获得焦点,键盘焦点留在原来的控件上。文本框、多行文本框和数值、日期时间这类输入字段除外:点进去就是为了输入。TTyTrackBar按 PageUp 增大Position,与 Qt 一致,与 Win32 相反。Reversed的条上按键和滚轮跟着屏幕走:滑块在屏幕上往哪边走和没翻转时一样,所以 PageUp 减小Position。TTyTreeView.AutoExpand沿用 Delphi 的语义:焦点移到哪个节点就展开哪个,离开的节点收起。LCL 的含义是"给节点添加子节点时展开它"。TTyTitleBar禁用后外观不变。 它代表窗口本身,窗口不会变灰;要表示"窗口不可用"请禁用窗口里的内容。- 窗体自己的
Font不覆盖主题。 整个窗口的字体来自主题;要换字体,改主题或用StyleOverride。控件自己设置的字体照常生效。 TTyScrollPanel.AutoPan需要宿主驱动。 拖动经过时在OnDragOver里调用AutoPanTo,拖动结束时调用StopAutoPan。TTyColorDialog.Color是TTyColor($AARRGGBB,带透明度),不是TColor。 直接把clRed赋给它,得到的是一个透明的蓝色;要按TColor读写,用LCLColor。- 在
TTyDateTimePicker里按Delete会把整个日期清成 NULL,和N键一样(LCL 只认N)。不想让用户清空,设NullInputAllowed := False。
主题化的容器上可以直接放普通的 LCL 控件(TPanel、TFrame、TScrollBox ……)。运行时,能放子控件的 TyControls 容器(面板、分组框、卡片、工具窗口、页面等)会让自己的 LCL Color 等于子控件身后的那个颜色:
| 容器的主题背景 | 它的 Color |
|---|---|
| 纯色 | 这个颜色 |
| 半透明 | 叠在容器身后的颜色上之后的结果 |
| 没有(比如分组框) | 容器身后的颜色 |
| 渐变 | 渐变中点的颜色 |
ParentColor = True 的普通控件于是自己就画成这个颜色,再放到它上面的 TyControls 控件,圆角外侧取到的也是它,不再是 clBtnFace。换主题、换 Controller、改 StyleClass / StyleOverride、把容器挪到别的父控件上,颜色都跟着变。
- 只在运行时。 设计器里容器的
Color不动,这个颜色也不会写进.lfm。 - 取静止状态的样式。 鼠标悬停、获得焦点不会改它。
- 你设过的
Color归你。 给容器的Color赋过值之后库不再碰它;赋回clDefault(TTyFrame也可以设ParentColor := True)就重新跟主题。 - 渐变只能给一个平色。 普通 LCL 控件只会画一种颜色。要在渐变宿主上看不出接缝,把视图做成 TTyFrame,它画的是宿主背景在自己位置上的那一片。
- 自己写的容器不想要这个行为,重写
ThemesChildBackdrop返回False。
窗体(TTyForm)一直是这样做的:ApplyChromeTheme 把纯色的窗体背景写进窗体的 Color。
下列控件没有"按内容"的自然尺寸,AutoSize 不改变它们的大小:TTyMemo、TTyListView、TTyTreeView、TTyDrawGrid、TTyStringGrid、TTyValueListEditor、仪表类控件、TTyChart、TTySparkline、TTyProgressBar、TTyShape、TTyStarShape、TTyArrow、TTyBevel、TTySplitter、取色控件、TTyPreviewBox、TTyImageView、TTyTransfer、TTyRibbonBackstage、TTyRibbonGallery、TTyTitleBar、TTyTerminalView(要固定行列用 SizeForGrid)。
下面这些属性对所在的控件不可能起作用,4.0 起不再发布(3.0 里只是在对象查看器里隐藏)。3.x 的窗体里给它们设过的值,4.0 载入时直接丢掉,窗体照常打开;再保存一次,.lfm 里就没有这几行了。
| 控件 | 属性 | 原因 |
|---|---|---|
数值框:TTyNumericEdit、TTyCurrencyEdit、TTyCalcEdit、TTyCalcCurrencyEdit、TTyFloatSpinEdit、TTyTrackEdit 及它们的 DB 版本 |
CharCase |
只能输入数字、符号和小数点 |
TTyAdvancedComboBox、TTyCheckComboBox、TTyColorBox、TTyColorComboBox、TTyFilterComboBox、TTyOfficeComboBox、TTyShellComboBox |
MaxLength、CharCase、ReadOnly |
只能选、不能输入,没有可编辑的文字 |
TTyDrawGrid |
HideSelectionWhenInactive、FadeUnfocusedSelection、MinEditorWidth |
没有选区,也没有内置的单元格编辑器;TTyStringGrid 照常发布 |
网格的 Header |
MainColumn |
网格没有主列;TTyListView、TTyTreeView 的表头照常发布 |
TTyShellListView |
OwnerData、ItemCount、Items、OnGetItemText、OnGetItemImage、OnGetItemGroup |
列表内容由它自己从文件夹读;TTyListView 照常发布 |
TTyShellTreeView |
NodeDataSize、RootNodeCount、Items、OnInitChildren |
节点由它自己从文件系统建;TTyTreeView 照常发布 |
TTyDBLookupListBox |
MultiSelect、ExtendedSelect |
查找列表只存一个键(LCL 也不发布);TTyDBListBox 照常发布 |
文本输入控件:TTyEdit、TTyMaskEdit、TTyComboEdit、TTyURLEdit、数值框、TTyMemo、TTySpinEdit、TTyDateTimePicker 及它们的 DB 版本 |
ChildSizing |
没有要排的子控件 |
TTyRangeTrackBar、TTyMultiTrackBar、TTyGradientTrackBar |
ChildSizing |
没有要排的子控件 |
TTyTerminalView |
ChildSizing |
滚动条由终端自己摆;设了它,滚动条会盖到最后几列上 |
TTyToolWindowActions |
AutoSize、ChildSizing、BorderSpacing |
位置和尺寸由所在的工具窗口排,子控件由它自己排成一排 |
上面这些只能选的组合框(TTyColorBox、TTyColorComboBox 除外)的 Style 仍然发布,但对象查看器的下拉列表里只列出只能选的样式;可编辑的样式设上去也会被换成对应的只能选样式。
TTyRichEdit 由本库自己绘制,不是 Windows 的富文本控件。Delphi TRichEdit 的大部分成员和 RichMemo 的方法都在,名字不变,但有一些能编译、做的事却不一样。下面逐条列出。
Delphi 的 uses ComCtrls(或 RichMemo 的 RichMemo)换成 tyControls.RichEdit,再加上声明它的成员所用类型和取值的那些单元。tyControls.RichEdit 不转出它们,就像 tyControls.Memo 不转出 tyControls.ScrollBar 一样:没写上这些单元之前,移植过来的代码第一次编译就会停在 TTyRichPos、nsBullet 或 stMatchCase 上。IDE 生成的事件处理方法不受影响:它会自己加上参数所需的单元。
uses
tyControls.RichEdit, tyControls.RichEdit.Text, tyControls.RichEdit.Attrs,
tyControls.RichEdit.Model, tyControls.RichEdit.Layout, tyControls.RichEdit.Find,
tyControls.ScrollBar; // 要用 Document.Execute 时再加 tyControls.RichEdit.Commands| 单元 | 提供的名字 |
|---|---|
tyControls.RichEdit |
TTyRichEdit、ETyRichEdit、TTyRichFormat(rfAuto、rfRtf、rfText)、各个事件类型(OnFallbackFont 的 TTyRichFallbackEvent 在 tyControls.RichEdit.Layout 里)、TTyRichFindEnd(rfeFound ……)、TTyRichReplaceEnd(rreDone ……)、TTyRichReplaceResult、TTyRichFindTask(rftFind、rftReplace) |
tyControls.RichEdit.Text |
TTyRichPos |
tyControls.RichEdit.Attrs |
TTyRichTextAttributes、TTyRichParaAttributes、TNumberingStyle 及 nsNone、nsBullet,TTySearchTypes(stWholeWord、stMatchCase)、TTySearchOptions(soMatchCase、soWholeWord、soBackward)、TTyRichConsistentAttributes(caBold ……)、TTyRichConsistentParaAttributes(cpaAlignment ……)、TTySubscriptType(sstNone ……);RichMemo 的记录、集合和辅助过程:TTyFontParams、InitFontParams、TTyParaMetric、TTyParaNumbering(pnBullet ……)、TTyParaAlignment(paLeft ……)、TTyTabStopList、TTyTextModifyMask(tmm_Styles ……)、TTyParaModifyMask、TTyParaRange |
tyControls.RichEdit.Model |
各种编号列表(lkDecimal …… lkUpperRoman)、ParaAlign 用的 TTyParaAlign(paraLeft、paraCenter、paraRight、paraJustify)、LineSpacingRule 用的 TTyLineSpacing(lsSingle ……)、TTyTextEncoding(teAuto、teUtf8 ……)、TTyRichDocument |
tyControls.RichEdit.Layout |
TTyRichWrapMode(rwmWindow、rwmPage、rwmNone) |
tyControls.RichEdit.Find |
TTyRichFindOptions(rfoMatchCase、rfoWholeWord、rfoBackward、rfoWrap) |
tyControls.RichEdit.Commands |
给 Document.Execute 用的命令(TTyRichInsertText ……) |
tyControls.ScrollBar |
TTyScrollBarAutoHide(sbahDefault、sbahNever、sbahAuto) |
- 位置按字符(码点)计,不按 UTF-16 单元。 BMP 以外的字符(表情、生僻字)在这里占一个位置,在 Delphi 和 Windows 上的 RichMemo 里占两个;段落结束占一个位置。
- 位置和长度是
TTyRichPos(Int64)。SelStart、SelLength、FindText的结果和 RichMemo 风格的方法都用它。赋给Integer变量能编译,没有任何警告,超过High(Integer)的位置会被截断;类型是 64 位的,就是为了这么大的文档,所以要声明为TTyRichPos。 Lines的一行是一个段落,不是 Delphi 那样屏幕上折行后的一行:Lines.Count是段落数,Lines[i]是一个段落的文字。大文档从不整篇排版,Lines必须不排版就能回答。CaretPos和 Delphi 一样是选区末端的TPoint:Y是段落,X是段内第几个字符。RichMemo 的CaretPos(即 LCL 多行文本框的)读的是选区起点。- 给
CaretPos赋值时X限制在段落之内。 Delphi 直接把X加到行首,超出行尾的列会落到后面的行里。 - 读
SelText得到的是复制到剪贴板的纯文本:段落结束是平台的换行符(Delphi 是 CR),图片不出现(Delphi 是 U+FFFC)。所以Length(SelText)不像 Delphi 那样等于SelLength。 Text里图片是 U+FFFC,段落之间用平台的换行符连接;在大文档里读它会把全文复制一份。Text :=和Clear换掉整个内容:撤销历史清空,之后Modified为False,Clear不能撤销,和 Delphi 的WM_SETTEXT一样。在BeginEdit … EndEdit之间调用两者都会抛ETyRichEdit。
- 每次经控件载入都会设置
PlainText:文本文件设为True,RTF 文件设为False。Delphi 的PlainText从不自己改变。 - 代码或对象查看器把
PlainText设为True后,它一直说了算:此后不指定格式的载入都按文本读,不指定格式的文件保存都写文本,和 Delphi 一样。用rfText载入不会结束它;PlainText := False、LoadRichText、LoadFromStream(S, rfRtf)或按文件内容决定格式的载入会结束它。 - 不指定格式的载入看文件开头(可选的 BOM 和空白之后是
{\rtf就是 RTF,否则是文本)。Delphi 先试 RTF,失败再按文本读,并且不动PlainText。 - 单参数的
Lines.LoadFromFile、LoadFromStream、SaveToFile、SaveToStream就是控件自己的载入和保存,所以 RTF 文件会按 RTF 读。带TEncoding的重载是 TStrings 的,把文件当纯文本;要指定编码,设TextEncoding再用单参数的版本。 Lines.SaveToFile会清除Modified,Delphi 的不动它。否则保存之后关闭窗口时"是否保存修改"还会再问一次。- 撤销或重做回到上次载入或保存时的内容,
Modified会重新变成False;Delphi 的一直是True。 - 撤销恢复这一步之前的选区,重做后是一个不带选区的光标,停在这一步结束的位置,和 Windows 的富文本控件一样。连续输入合成一步;一次格式写入、代码的每一次编辑各算一步。
- 写入文字已有的值不算一步撤销:不触发
OnChange,不动Modified。 CanUndo和CanRedo是替用户回答的:ReadOnly或禁用时为False。代码要问,用Document.CanUndo。ReadOnly只拦用户。 代码照样能通过SelText、Lines、Text、格式接口和替换方法修改内容,和 Delphi 的SelAttributes一样;剪切、粘贴、ClearSelection、Undo、Redo在只读控件上什么也不做,也和 Delphi 一样。ClearSelection删除选区,和 Delphi 一样;只想取消选区用CollapseSelection。- 没选中文字时选好的格式(先点粗体再输入)遇到任何一次设置选区就作废,哪怕是
SelStart := SelStart,和 Windows 一样。 - 在
Lines.BeginUpdate … EndUpdate、Document.BeginUpdate … EndUpdate和BeginEdit … EndEdit之间,每次写入的效果和在外面一样:光标和选区跟着SelText、Lines、InDelText走。BeginEdit … EndEdit把重画和两种通知都压到结尾:最后触发一次OnChange和一次OnSelectionChange。Lines.BeginUpdate和Document.BeginUpdate只压住OnChange和重画;在里面设置选区(SelStart、SelLength、CaretPos、CaretIndex)会立即通知,和 Delphi 一样。 - 在这些括号之间用户的操作不起作用:剪切、粘贴、
ClearSelection、Undo、Redo和按键都被忽略,不报错,也不触发OnEditRefused。 - 在括号之间直接用
Document.Execute做的修改:同一个括号里还设置过选区或经控件写过文字时,它不移动选区。两样都没有时,选区只在结尾按整个括号合并成的一次修改移动:夹在两处这样的修改之间的光标会落到第一处的开头。 BeginEdit … EndEdit算一步撤销:撤销恢复BeginEdit时的选区,重做后是一个光标,停在EndEdit时光标所在的位置。- 文件还在载入、载入被取消之后、或正在保存时,写格式会抛
ETyRichEdit,Delphi 的控件没有这些状态。含有嵌套表格的表格行会被跳过,保持文件里的样子。 - 写格式之前先结束正在进行的输入法组字。
SendMessage(Handle, EM_…)和Perform(EM_…)能编译,但什么也不做:没有系统控件来接收它们。改用对应的成员:EM_SCROLLCARET用ScrollCaretIntoView,EM_LINEFROMCHAR用Document.Text.ParaOfPos,EM_LINEINDEX用Document.Text.ParaStart,EM_GETFIRSTVISIBLELINE用TopParagraph,EM_POSFROMCHAR用PositionRect,EM_CHARFROMPOS用PositionAtPoint,EM_GETTEXTRANGE用GetText,EM_SETZOOM用Zoom,EM_SETTARGETDEVICE用WrapMode。EM_EXLIMITTEXT无需设置:没有长度上限。
TNumberingStyle有七个成员(nsNone、nsBullet和直到lkUpperRoman的各种编号),所以Paragraph.Numbering := TNumberingStyle(Button.Down)照常可用,但for … in TNumberingStyle、带else的case、以它为下标的数组看到的是七个值。Numbering := nsBullet(或某种编号)给没有缩进的段落加上写字板的悬挂缩进(首行 18 磅,其余行 36 磅);nsNone把缩进还原为 0。Delphi 的nsBullet把LeftIndent至少提到 10 磅,nsNone把LeftIndent设为 0。- 两端对齐的段落在
Paragraph.Alignment里读出taLeftJustify,因为TAlignment没有两端对齐;ParaAlign能读出全部四种。 - 从右到左的
BiDiMode下Paragraph.Alignment不左右互换:控件没有从右到左的排版。RTF 文件里从右到左的段落原样保留,保存时写回。 - 自动文字颜色读出
clDefault(Delphi 是clWindowText),没有突出显示读出clNone(Delphi 是clWindow),因为自动颜色跟着主题走。写入clWindowText、clWindow或clDefault表示自动或无,和 Delphi 一样。 Font.Assign(SelAttributes)对自动颜色的文字给出clDefault,也不设置字距类型(pitch)。SelAttributes.Assign(DefAttributes)去掉文字自己的字体,此后它跟着DefAttributes和主题走;Delphi 是把基础字体的值抄进文字。- 没有自己字体的文字,
Name和Size读出的是它显示用的字体。 把读到的值原样写回,这样的文字仍然没有自己的字体,所以工具栏读了再写回不会把字体固化进文字。Height、RichMemo 风格的方法和Assign(TFont)也是这样。 - 字体名
'default'在任何写入里都表示"没有名字",文件里不会出现一个叫default的字体。 Height是负数时取绝对值。DefAttributes是叠在主题上的控件Font:写它就是改Font,不算一步撤销。它的BackColor和Subscript不能设置(写入会抛ETyRichEdit)。ConsistentAttributes比较的是文字存的格式,不是显示出来的样子:没有字体名的文字和写明了基础字体名的文字放在一起,caFace算作不一致。ConsistentAttributes有工作量上限:选区非常大,或大 RTF 文件里还有没解析的部分时,它把不能证明一致的属性报成不一致,这样工具栏可以在每次选区变化时读它。- 选区从段落结尾开始时,
SelAttributes回答的是下一段第一个字符,也就是写入时会被设置格式的那个字符。 - 选中多个段落时,
FirstIndent、LeftIndent、RightIndent按每个段落自己的值来改,和 Delphi 一样。 - 缩进、段前段后间距和制表位读出时四舍五入到整磅;Delphi 是截断。写入是精确的。
Tab[i] :=超出TabCount时会一直补到i,于是个数变成i + 1;Delphi 把个数设为i。TabCount最多 32,下标 32 及以上被忽略。
FindText的选项是stWholeWord和stMatchCase(类型TTySearchTypes);RichMemo 风格的Search用soMatchCase、soWholeWord、soBackward(类型TTySearchOptions)。FPC 的StrUtils也有soMatchCase和soWholeWord:同时用到两者的单元里要加限定名。Length(Len)为负数时一直找到末尾。 Delphi 只有StartPos + Length等于 -1 时才是找到末尾。超出末尾的范围会被截到末尾。- RichMemo 风格的反向
Search从Start往前找Len个字符(Len为负数时找到 0),返回离Start最近的匹配,和 Windows 上的 RichMemo 一样。 - 带
var结果的Search报告的是匹配在本控件里的字符长度;RichMemo 报告的是要找的文字的长度。CR LF 匹配一个段落结尾时,这里给 1,RichMemo 给 2。也有Integer版本的重载,位置超过High(Integer)的匹配按没找到处理。 - 整词匹配按光标的分词规则:每个中文、日文、韩文字符两侧都算词的边界。大小写按码点逐个折叠(
ß不匹配ss,没有土耳其语规则),不做规范化。 - 要找的文字里 CR LF、LF、CR 各匹配一个段落结尾。 Delphi 会把 CR LF 变成 CR。
- 图片永远不会被匹配,链接的文字和合并掉的表格单元格里的文字也不会。
- 文件还在载入时,
FindText和Search只找已经载入的部分,其余部分返回 -1;FindNextAsync先找已经载入的部分,随着载入继续往下找。 - 在很大的 RTF 文件里查找,是边找边读文件里的段落,所以上百兆的文件上
FindNext、FindText、Search可能要十秒以上。这种文件优先用FindNextAsync:它在后台查找,可以取消。 ReplaceAll有三种形式:最简单的返回替换的个数;带out ASkipped的还数出没动的匹配;带范围(AStart、ALength,长度为负数表示到末尾,和FindText的取法一样)的填一个TTyRichReplaceResult。ReplaceAllAsync取同样的范围(默认整篇),把同样的记录交给OnReplaceDone。文档不允许用户编辑改动的匹配(在含有嵌套表格的表格行里,或删掉它会把文字跨过表格单元格或行的边界连起来)保持原样,计入Skipped。文档当下不接受改动时,所有匹配也都这样处理:载入被取消之后,ReplaceAll和ReplaceAllAsync都如此;文件正在载入或正在保存时,ReplaceAll如此(ReplaceAllAsync则等载入结束)。- 一次替换算一步撤销,这一步有上限,是
Document.MaxUndoBytes的四倍。TTyRichReplaceResult.Ending说明它怎么结束:rreDone(走完了范围)、rreLimit(这一步满了)、rreCancelled(被CancelFind、进度事件、再次开始、不是它自己做的编辑或撤销(在它下一轮之前又撤回的也算)、ClearUndo或其他让撤销历史放掉它那一步的操作、换了内容或保存停下;只有后台替换会这样)或rreFailed(无法继续);Replaced和Skipped是它做了多少。已经替换的保留,算一步撤销。撤销历史如果是在别的操作当中放掉这一步的(文档的ClearUndo、敲了一个键让历史超过字节上限、新的一步把重做那一侧丢掉),替换当场就结束(FindRunning为 False),OnReplaceDone随后从应用程序的消息循环里触发,不在那个操作里面。 - 遇到
rreLimit或rreCancelled后要接着替换,就从它报告的位置再调用一次:ReplaceAll(AFind, AReplace, AOptions, R.ResumeAt, R.ResumeLength, R),只要R.Ending是rreLimit就再重复(rreCancelled或rreFailed的调用不会自己接下去)。ResumeAt紧跟在它处理的最后一个匹配后面,按报告时的文字计算(后台替换停下以后做的编辑也算进去);不会有地方被替换两次,替换文字里含有要找的文字时也一样。没有剩下的或者内容已经换掉时,ResumeAt是 -1。后台替换被撤销它自己那一步而停下时,Replaced报 0,ResumeAt报范围的起点:它做的已经一点不剩(如果在它察觉之前又重做了,报的就是重做放回去的个数和那之后的位置)。带rfoWholeWord时,文字没有变动、又恰好从ResumeAt开始的再次调用,会把紧挨着上一个已替换匹配的那个匹配也替换掉,和一次做完的结果一样;中间有过编辑,或者从别的位置开始,这样的匹配就按当时的文字来判断。停下的那一次已经计入的被拒绝的匹配,再调用时可能又计入一次Skipped。 OnFindDone给出AEnd(rfeFound、rfeNotFound、rfeCancelled)和匹配的APos、ALen(没找到时是 -1 和 0);OnReplaceDone给出TTyRichReplaceResult。每次开始的后台查找或替换都恰好触发一次,控件被销毁时除外。OnFindProgress用ATask说明在跑的是查找(rftFind)还是替换(rftReplace),并给出所查范围里已经完成的字符数;ACancel让它停下。这些事件的处理方法可以释放控件:触发事件的那个调用照常返回,就像什么都没找到、没替换一样(FindNext返回 False,ReplaceAll返回 0 和rreCancelled),不会有异常传出来;这个调用本身是在这类处理方法里发出的,也一样。只有一个例外:不要在给Text赋值期间运行的处理方法里释放控件(Text的写方法是 LCL 自己的,控件的代码返回以后它还要读这个控件);等赋值返回以后再释放,比如用Application.ReleaseComponent。
- Delphi 的类型名:属性类是
TTyRichTextAttributes和TTyRichParaAttributes,集合类型是TTyRichConsistentAttributes、TTyRichConsistentParaAttributes和TTySubscriptType。成员名和 Delphi 一样(caBold、cpaAlignment、sstSuperscript……),所以用到这些值的代码能编译,用 Delphi 类型名声明变量的代码不能。序号也不同。 - RichMemo 的类型名:记录、枚举和集合都带本库的前缀(
TTyFontParams、TTyParaMetric、TTyParaNumbering、TTyTabStopList、TTyTextModifyMask……),TTabStop是TTyRichTabStop。成员保留 RichMemo 的名字(paLeft、tmm_Styles……);在同时用了RichMemo或Menus的单元里要加限定名。 - 把
Integer变量传给GetStyleRange或GetParaRange编译不过:改声明为TTyRichPos。 - 控件不保存的属性:
Protected、Disabled、Hidden、Link、Offset、Pitch、RevAuthor、UseForAllText以及ConsistentAttributes里对应的成员(caProtected……)。RTF 文件里的这些内容按原字节保留,保存时写回。 - 多行文本框的成员:控件不是
TCustomMemo,所以没有WordWrap(用WrapMode)、ScrollBars(需要时自动出现;ScrollBarAutoHide)、Alignment(按段落设:Paragraph.Alignment)、MaxLength、WantReturns(回车总是新起一段)、BorderStyle、Color和ParentColor(颜色来自主题,用StyleOverride改)、HideSelection、HideScrollBars、GetSelTextBuf、SetSelTextBuf;is TCustomEdit判断和 LCL 的标准编辑动作也认不出它。右键菜单是本库的文本菜单。 - Delphi 的其他成员:
OnProtectChange、OnResizeRequest、OnSaveClipboard、OnLinkClick、EnableURLs、ShowURLHint、SelectionStreamMode、SpellChecking、ShowSpellCheckMenu、Transparent、EditMargins、ActiveLineNo、ScrollPosition(用ScrollY,视图顶端的像素位置,可以写入;ScrollX读出水平偏移)、Print、RenderRange、PageRect、DefaultConverter、RegisterConversionFormat和SetSelTextToFriendlyURL。 - RichMemo 的其他成员:
SetLink、isLink、OnLinkAction、Print、OnPrintAction、InDelInline、InitParaNumber、InitParaBullet、第二个InitTabStopList、GetFontParams、InitPrintParams和InitTextUIParams。 - 替换当前匹配:用
SelText :=或InDelText。 - 窗体文件里的
Lines。 富文本不能脱离格式按行保存,所以Lines不发布:在运行时设置文字或载入文件。 - 从 Delphi 转换来的窗体,对下表里 Delphi 的
TRichEdit存过、本控件不发布的每个属性都会报属性不存在。把它们删掉就够了(打开窗体时 IDE 会弹出"Repair LFM file"对话框,选"移除所有无效属性";或者在编辑器里打开这个 .lfm,用"工具 → 在编辑器中检查 LFM 文件"),除非表里写了要改设什么。
| Delphi 的属性 | 改用 |
|---|---|
Lines.Strings |
在运行时设置文字或载入文件 |
WordWrap |
WrapMode(False 对应 rwmNone) |
ScrollBars、HideScrollBars |
不用设:滚动条需要时自动出现;ScrollBarAutoHide |
HideSelection |
不用设:没有焦点时选区照样显示,颜色是主题给的 |
Alignment |
在运行时按段落设 Paragraph.Alignment 或 ParaAlign |
MaxLength |
不用设:没有长度上限 |
WantReturns |
不用设:回车总是新起一段 |
Color、ParentColor、BorderStyle、BorderWidth、BevelEdges、BevelInner、BevelOuter、BevelKind、BevelWidth、Ctl3D、ParentCtl3D、StyleElements、StyleName |
主题;用 StyleOverride 或 StyleClass |
ParentFont |
不用设:Font 是控件自己叠在主题上的基础字体 |
BiDiMode、ParentBiDiMode |
不用设:没有从右到左的排版 |
ImeMode、ImeName |
不用设:输入法由系统决定 |
EditMargins |
主题的内边距;用 StyleOverride |
EnableURLs、ShowURLHint、SelectionStreamMode、SpellChecking、Transparent、Touch |
没有对应 |
OnLinkClick、OnProtectChange、OnResizeRequest、OnSaveClipboard、OnGesture、OnMouseActivate、OnStartDock、OnEndDock |
没有对应;处理方法留在单元里,不再挂上 |
- RichMemo 的
TTyParaNumbering只保留Style和NumberStart:pnCustomChar变成项目符号,Indent、CustomChar、SepChar、ForceNewNum读出 0、#0或False。 - 竖线制表位:
tabWordBar按左对齐制表位写入。
- 对没有自己字体的文字,
GetTextAttributes给出显示用的字体名和字号;自动颜色是clDefault。读、改、写回的写法不会把字体固化进文字。 TTyParaMetric.LineSpacing用 RichMemo 的刻度(单倍 1.2、1.5 倍 1.8、双倍 2.4)。写入时取控件支持的四种里最接近的一种;0 或负数不改行距,固定值或最小值行距读出 0。SetParaMetric和SetRangeParaParams按每个段落自己的值来改,算一步撤销。SetRangeParams里同一个样式既在添加集合又在移除集合时,结果是去掉,和 RichMemo 一样。- 在光标处用长度 0 调用
SetTextAttributes,设置的是接下来输入的格式;在别处长度 0 什么也不做。 GetStyleRange不超出位置所在的段落。InDelText算一步撤销,插入的文字用被替换的第一个字符的格式,返回插入的字符数。LoadRichText把PlainText设为False;它和SaveRichText出错时返回False(内存不足照常抛出)。ZoomFactor等于Zoom / 100,写入时取整到百分之一。
- 段落:
ParaAlign(含两端对齐)、NumberingStart、SpaceBefore、SpaceAfter、LineSpacingRule、LineSpacing(单位是磅);每次写入只改每个段落里自己那一项。 - 选区和编辑:
CaretIndex(光标所在的那一端)、CollapseSelection、BeginEdit/EndEdit(多次写入合成一步撤销)、RangeText。 - 查找和替换:
FindNext、FindNextAsync、ReplaceAll(三种形式)、ReplaceAllAsync、CancelFind、FindRunning、OnFindProgress、OnFindDone、OnReplaceDone。一次替换算一步撤销,不受ReadOnly限制。 Action是发布的,和TTyMemo一样(Delphi 的TRichEdit和 LCL 的TMemo不发布它):关联了动作时,点击编辑区会执行它;它的Caption不会进入文字。- 大文件:RTF 文件在后台读入(
Loading、FinishLoading、CancelLoad、OnLoadProgress);OnSaveProgress报告保存进度。 - 事件和设置:
OnModifiedChange、OnEditRefused(用户的编辑被文档拒绝)、OnZoomChange、OnFallbackFont、WrapMode、TextEncoding、TextCodePage、ScrollBarAutoHide。 - 文档本身:
Document(命令、撤销历史、格式),给需要的不只是控件成员的代码用。