某些控件允许你使用超文本标记语言(HTML)来为显示文本设置格式。 HTML 格式化文本包含了定义文本外观的标记标签。 本文档列出了支持 HTML 文本格式设置的控件,描述可用的 HTML 格式设置标签,并提供了使用此功能的示例。
支持的控件
目前支持 HTML 格式设置的控件在下表中列出。 注意对于一些控件,要允许 HTML 格式设置,需要激活相应的 Boolean 属性。
套件 | 所支持的 HTML 格式设置... | 激活 HTML 格式设置的属性 |
---|---|---|
XtraCharts | Title 的文本的显示(Title.Text) | n/a |
XtraEditors | LabelControl 的文本的显示(LabelControl.Text) | LabelControl.AllowHtmlString |
XtraEditors | CheckEdit 控件的文本显示(CheckEdit.Text) | RepositoryItemCheckEdit.AllowHtmlString |
XtraEditors | 普通工具提示的显示(BaseControl.ToolTip),用于 BaseControl 的子类 | BaseControl.AllowHtmlTextInToolTip |
XtraGrid | 列标题的显示 (GridColumn.Caption) | GridOptionsView.AllowHtmlDrawHeaders |
XtraGrid | 带区标题的显示 (GridBand.Caption) | GridOptionsView.AllowHtmlDrawHeaders |
XtraLayout | 布局项标题的显示 (BaseLayoutItem.Text) | LayoutControlItem.AllowHtmlStringInCaption |
XtraBars | 通过 AlertControl 组件实现的提醒窗口的标题和文本。 | AlertControl.AllowHtmlText |
XtraGauges | label 的文本 | Label.AllowHTMLString |
全部控件 | 支持这些工具提示的控件的 SuperToolTips 的显示 | SuperToolTip.AllowHtmlText |
支持的标签
标签被使用 '<' 和 '>' 符号括起,并且通常有一个相应的结束标签。 如果某个标签没有与之配对的结束标签,那么此标签后面的所有文本都将被设置为相应的格式。
下列标签被支持:
标签 | 结束标签 | 说明 |
---|---|---|
<br> | - |
插入一个单独的换行。要使用此标签,你应该通过相应外观对象的 TextOptions.WordWrap 选项激活文本折行。
要在 GridControl 控件中使用此标签,需要通过 GridViewAppearances.HeaderPanel 或 BandedViewAppearances.BandPanel 对象激活文本折行。 要在 LabelControl 控件中使用此标签,需要通过 LabelControl.Appearance 对象激活文本折行。 要在 CheckEdit 控件中使用此标签,需要通过 CheckEdit.Properties.Appearance 对象 (RepositoryItem.Appearance) 激活文本折行。 要在布局项标题中使用这个标签,需要通过该项的或布局组的 BaseLayoutItem.AppearanceItemCaption 对象激活文本折行。 |
<color=value> 示例: <color=red> <color=0,255,0> <color=#0000FF> |
</color> | 指定文本颜色。 |
<size=value> 示例: <size=10> <size=+4> <size=-4> |
</size> | 指定字符大小。 |
<b> | </b> | 定义粗体文本。 |
<i> | </i> | 定义斜体文本。 |
<u> | </u> | 定义下划线文本。 |
![]() |
---|
注意,如果你需要在支持 HTML 文本格式设置的控件的文本中使用角括号('<' 和 '>'),那么你需要使用一个附加的 '<' 括号作为前导。例如,要得到 "< some text> ",你应该把 "< < some text> " 指派到相应的属性。 |
打印和导出时的注意事项
在打印或导出控件时,HTML 的格式设置不被支持。 HTML 标签不显示在已打印文档中。
示例
下面的示例展示了如何使用 HTML 标签设置 LabelControl 文本的格式。 HTML 格式设置通过 LabelControl.AllowHtmlString 属性激活。 下面的插图展示了结果:
C# | ![]() |
---|---|
labelControl1.Text = "<size=14>Size = 14 <br/> <b>Bold</b> <i>Italic</i> <u>Underline</u> <br/><size=11>Size = 11<br/> <color=255, 0, 0>Sample Text"; labelControl1.AllowHtmlString = true; labelControl1.Appearance.TextOptions.WordWrap = DevExpress.Utils.WordWrap.Wrap; labelControl1.Appearance.Options.UseTextOptions = true; labelControl1.AutoSizeMode = DevExpress.XtraEditors.LabelAutoSizeMode.None; |
Visual Basic | ![]() |
---|---|
labelControl1.Text = "<size=14>Size = 14 <br/> <b>Bold</b> <i>Italic</i> <u>Underline</u> " + _ "<br/><size=11>Size = 11<br/> <color=255, 0, 0>Sample Text" labelControl1.AllowHtmlString = True labelControl1.Appearance.TextOptions.WordWrap = DevExpress.Utils.WordWrap.Wrap labelControl1.Appearance.Options.UseTextOptions = True labelControl1.AutoSizeMode = DevExpress.XtraEditors.LabelAutoSizeMode.None |