Style 属性
UI 组件的样式
使用 Style
对象为表 UI 组件中的单元格、树 UI 组件中的节点以及列表框和下拉 UI 组件中的项创建可视样式。您可以使用 uistyle
函数创建 Style
对象,指定其属性,然后使用 addStyle
函数将其应用于组件。您可以使用 removeStyle
函数从组件中删除样式。
添加到 UI 组件的 Style
对象在视觉效果上优先于您为组件对象设置的属性,无论您创建它们的顺序如何。例如,在以下代码中,表中显示蓝色字体颜色,即使最后对 Table
对象设置红色前景颜色。
uit = uitable(uifigure,'Data',rand(100,10)); s = uistyle; s.FontColor = 'blue'; addStyle(uit,s); uit.ForegroundColor = 'red';

颜色
背景颜色,指定为 RGB 三元组、十六进制颜色代码或下表中列出的颜色选项之一。
RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。
RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]
范围内,例如[0.4 0.6 0.7]
。十六进制颜色代码是字符向量或字符串标量,以井号 (
#
) 开头,后跟三个或六个十六进制数字,范围可以是0
到F
。这些值不区分大小写。因此,颜色代码"#FF8800"
与"#ff8800"
、"#F80"
与"#f80"
是等效的。
此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" | |
"green" | "g" | [0 1 0] | "#00FF00" | |
"blue" | "b" | [0 0 1] | "#0000FF" | |
"cyan" | "c" | [0 1 1] | "#00FFFF" | |
"magenta" | "m" | [1 0 1] | "#FF00FF" | |
"yellow" | "y" | [1 1 0] | "#FFFF00" | |
"black" | "k" | [0 0 0] | "#000000" | |
"white" | "w" | [1 1 1] | "#FFFFFF" |
下表列出了浅色和深色主题中绘图的默认调色板。
调色板 | 调色板颜色 |
---|---|
在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。 |
|
|
|
您可以使用 orderedcolors
和 rgb2hex
函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如,获取 "gem"
调色板的 RGB 三元组并将其转换为十六进制颜色代码。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);
在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder")
获取 RGB 三元组。
在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255))
获取十六进制颜色代码。
字体颜色,指定为 RGB 三元组、十六进制颜色代码或下表中列出的选项之一。
RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。
RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]
范围内,例如[0.4 0.6 0.7]
。十六进制颜色代码是字符向量或字符串标量,以井号 (
#
) 开头,后跟三个或六个十六进制数字,范围可以是0
到F
。这些值不区分大小写。因此,颜色代码"#FF8800"
与"#ff8800"
、"#F80"
与"#f80"
是等效的。
此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" | |
"green" | "g" | [0 1 0] | "#00FF00" | |
"blue" | "b" | [0 0 1] | "#0000FF" | |
"cyan" | "c" | [0 1 1] | "#00FFFF" | |
"magenta" | "m" | [1 0 1] | "#FF00FF" | |
"yellow" | "y" | [1 1 0] | "#FFFF00" | |
"black" | "k" | [0 0 0] | "#000000" | |
"white" | "w" | [1 1 1] | "#FFFFFF" |
下表列出了浅色和深色主题中绘图的默认调色板。
调色板 | 调色板颜色 |
---|---|
在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。 |
|
|
|
您可以使用 orderedcolors
和 rgb2hex
函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如,获取 "gem"
调色板的 RGB 三元组并将其转换为十六进制颜色代码。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);
在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder")
获取 RGB 三元组。
在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255))
获取十六进制颜色代码。
文本
字体名称,指定为系统支持的一种字体名称。默认字体取决于具体操作系统和区域设置。
如果指定的字体不可用,MATLAB® 将使用运行 App 的系统上的可用字体中的最佳匹配项。
字体粗细,指定为下列值之一:
'normal'
- 特定字体定义的默认粗细'bold'
- 字符轮廓比'normal'
粗
并非所有字体都有加粗字体。对于非加粗字体,指定 'bold'
会得到普通字体。
字体角度,指定为 'normal'
或 'italic'
。并非所有字体都有倾斜字体角度。对于无斜体字体,指定 'italic'
后会使用常规字体角度。
表单元格文本的水平对齐方式,指定为下表中的值之一。
值 | 示例 |
---|---|
'left' | |
'right' | |
'center' | |
如果您将指定水平对齐的 Style
对象添加到表 UI 组件,它将优先于您为 Table
对象上的 ColumnFormat
属性指定的单元格格式值相关联的对齐方式。ColumnFormat
属性仍然像通常一样转换值。
注意
如果向树 UI 组件添加用于指定水平对齐的 Style
对象,HorizontalAlignment
值对组件外观不起作用。
裁剪长文本的一侧,指定为下表中的值之一。
值 | 示例 |
---|---|
'left' | |
'right' | |
注意
如果将指定水平裁剪的 Style
对象添加到树的节点子集或者列表框或下拉 UI 组件的项目子集,则 HorizontalClipping
值对组件外观不起作用。您仍可以将样式添加到整个树、列表框或下拉 UI 组件。
文本解释器,指定为:
'none'
- 显示字面字符。'tex'
- 使用 TeX 标记的子集解释文本。'latex'
- 使用 LaTeX 标记子集解释文本。'html'
- 使用 HTML 标记子集解释文本。
TeX 标记
使用 TeX 标记添加上标和下标,并在文本中包含特殊字符。
修饰符会一直作用到文本结尾,但上标和下标除外,因为它们仅修饰下一个字符或花括号中的字符。当您将解释器设置为 "tex"
时,支持的修饰符如下所示。
修饰符 | 描述 | 示例 |
---|---|---|
^{ } | 上标 | "text^{superscript}" |
_{ } | 下标 | "text_{subscript}" |
\bf | 粗体 | "\bf text" |
\it | 斜体 | "\it text" |
\sl | 伪斜体(通常与斜体相同) | "\sl text" |
\rm | 常规字体 | "\rm text" |
\fontname{ | 字体名称 - 将 替换为字体系列的名称。您可以将此说明符与其他修饰符结合使用。 | "\fontname{Courier} text" |
\fontsize{ | 字体大小 - 将 替换为以磅为单位的数值标量值。 | "\fontsize{15} text" |
\color{ | 字体颜色 - 将 替换为以下颜色之一:red 、green 、yellow 、magenta 、blue 、black 、white 、gray 、darkGreen 、orange 或 lightBlue 。 | "\color{magenta} text" |
\color[rgb]{specifier} | 自定义字体颜色 - 将 替换为三元素 RGB 三元组。 | "\color[rgb]{0,0.5,0.5} text" |
下表列出了 "tex"
解释器所支持的特殊字符。
字符序列 | 符号 | 字符序列 | 符号 | 字符序列 | 符号 |
---|---|---|---|---|---|
| α |
| υ |
| ~ |
| ∠ |
| ϕ |
| ≤ |
|
|
| χ |
| ∞ |
| β |
| ψ |
| ♣ |
| γ |
| ω |
| ♦ |
| δ |
| Γ |
| ♥ |
| ϵ |
| Δ |
| ♠ |
| ζ |
| Θ |
| ↔ |
| η |
| Λ |
| ← |
| θ |
| Ξ |
| ⇐ |
| ϑ |
| Π |
| ↑ |
| ι |
| Σ |
| → |
| κ |
| ϒ |
| ⇒ |
| λ |
| Φ |
| ↓ |
| µ |
| Ψ |
| º |
| ν |
| Ω |
| ± |
| ξ |
| ∀ |
| ≥ |
| π |
| ∃ |
| ∝ |
| ρ |
| ∍ |
| ∂ |
| σ |
| ≅ |
| • |
| ς |
| ≈ |
| ÷ |
| τ |
| ℜ |
| ≠ |
| ≡ |
| ⊕ |
| ℵ |
| ℑ |
| ∪ |
| ℘ |
| ⊗ |
| ⊆ |
| ∅ |
| ∩ |
| ∈ |
| ⊇ |
| ⊃ |
| ⌈ |
| ⊂ |
| ∫ |
| · |
| ο |
| ⌋ |
| ¬ |
| ∇ |
| ⌊ |
| x |
| ... |
| ⊥ |
| √ |
| ´ |
| ∧ |
| ϖ |
| ∅ |
| ⌉ |
| 〉 |
| | |
| ∨ |
| 〈 |
| © |
LaTeX 标记
要使用 LaTeX 标记,请将解释器设置为 'latex'
。使用 LaTeX 标记来格式化和显示数学表达式、方程和特殊字符。使用美元符号将标记的文本括起来。例如,对于行内模式,使用 '$\int_1^{20} x^2 dx$'
,对于显示模式,使用 '$$\int_1^{20} x^2 dx$$'
。
显示的文本将使用默认的 LaTeX 字体样式。FontName
、FontWeight
和 FontAngle
标签属性不起任何作用。要更改字体样式,请使用 LaTeX 标记。
MATLAB 支持大多数标准 LaTeX 数学模式命令。有关详细信息,请参阅支持的 LaTeX 命令。
HTML 标记
要使用 HTML 标记,请将解释器设置为 'html'
。通过 HTML 设置字体样式会覆盖任何等效的 Style
字体属性。例如,以下代码将生成红色文本。
fig = uifigure; s1 = uistyle("Interpreter","html"); s2 = uistyle("FontColor","blue"); t = uitable(fig); t.Data = ["<p style='color: red;'>Cell 1</p>"; "<p style='color: red;'>Cell 2</p>"]; addStyle(t,s1) addStyle(t,s2)
解释器支持部分 HTML 标记。一般情况下,解释器支持与文本相关的标记和样式。不支持的标记和样式将被忽略。
下表列出了支持的元素和元素属性。
HTML 元素 | 属性 | 描述 |
---|---|---|
a | style , target , href , title | 超链接 |
abbr | style , title | 缩写 |
address | style | 联系信息 |
article | style | 自包含的独立内容 |
aside | style | 与主要内容间接相关的内容 |
b | style | 粗体文本 |
bdi | style , dir | 格式与周围文本方向不同的内容 |
bdo | style , dir | 格式与周围文本方向不同的内容 |
big | style | 比周围文本大一个字体大小级别的文本(在 HTML5 中已弃用) |
blockquote | style , cite | 扩展引用 |
br | 不适用 | 换行符 |
caption | style | 表标题 |
center | style | 水平居中的内容 |
cite | style | 创造性工作的标题 |
code | style | 代码片段 |
col | style , align , valign , span , width | 表中的列 |
colgroup | style , align , valign , span , width | 表中的一组列 |
dd | style | 描述列表中的项或值 |
del | style , datetime | 从文档中删除的文本 |
details | style , open | 文本仅在切换到 'open' 状态时才可见的交互式小组件 |
dl | style | 描述列表 |
dt | style | 描述列表中的项或值 |
em | style | 强调的文本(通常以粗体显示) |
font | style , color , size , face | 具有指定字体属性的文本(在 HTML5 中弃用) |
footer | style | 页脚 |
h1 . h2 , h3 , h4 , h5 , h6 | style | 节标题 - <h1> 是最高级别的标题,<h6> 是最低级别的标题 |
header | style | 介绍性内容 |
hr | style | 主题换行 |
i | style | 偏离周围内容的文本 - 默认以粗体方式呈现 |
ins | style , datetime | 插入文档中的文本 |
li | style | 列表中的项 |
mark | style | 标记或突出显示的文本 |
ol | style | 有序列表 |
p | style | 段落 |
pre | style | 预设格式的文本 |
s | style | 带删除线的文本 |
strike | style | 带删除线的文本(在 HTML5 中弃用) |
section | style | 独立节 |
small | style | 比周围文本小一个字体大小级别的文本(在 HTML5 中弃用) |
sub | style | 下标 |
sup | style | 上标 |
strong | style | 非常重要的文本 |
table | style , width , border , align , valign | 表 |
tbody | style , align , valign | 表正文 |
td | style , width , rowspan , colspan , align , valign | 表数据单元格 |
tfoot | style , align , valign | 汇总表列的表行组 |
th | style , width , rowspan , colspan , align , valign | 表数据单元格,指定为一组单元格的标题 |
thead | style , align , valign | 指定列标题的表行组 |
tr | style , rowspan , align , valign | 表单元格行 |
tt | style | 等宽文本(在 HTML5 中弃用) |
u | style | 具有模糊注解的文本 - 默认带下划线显示 |
ul | style | 无序列表 |
有关这些元素的详细信息,请参阅 https://developer.mozilla.org/en-US/docs/Web/HTML/Element。
要使用 HTML 标记创建运行 MATLAB 代码的超链接,请参阅创建运行函数的超链接。
您可以使用 HTML 样式属性来格式化 HTML 内容。样式属性是一串 CSS 属性及其值。
支持下列 CSS 属性:
background-color
border-bottom
border-bottom-color
border-bottom-left-radius
border-bottom-right-radius
border-bottom-style
border-bottom-width
border-left
border-left-color
border-left-style
border-left-width
border-radius
border-right
border-right-color
border-right-style
border-right-width
border-spacing
border-style
border-top
border-top-color
border-top-left-radius
border-top-right-radius
border-top-style
border-top-width
border-width
color
direction
font-family
font-size
font-style
font-weight
height
hidden
line-height
margin
margin-bottom
margin-left
margin-right
margin-top
max-height
max-width
min-height
min-width
overflow
overflow-wrap
overflow-x
overflow-y
padding
padding-bottom
padding-left
padding-right
padding-top
text-align
text-anchor
text-decoration
text-indent
text-overflow
text-shadow
text-transform
title
translate
white-space
width
有关这些属性的详细信息,请参阅 https://developer.mozilla.org/en-US/docs/Web/CSS/Reference。
图标
预定义或自定义图标,指定为字符向量、字符串标量或真彩色图像数组。
预定义图标
下表列出了用于指定预定义图标的值。
值 | 图标 |
---|---|
'question' |
|
'info' |
|
'success' |
|
'warning' |
|
'error' |
|
'none' | 不显示任何图标。 |
自定义图标
可将自定义图标指定为下列值之一:
字符向量或字符串标量,指定 MATLAB 路径中的 SVG、JPEG、GIF 或 PNG 图像的文件名。也可以指定图像文件的完整路径。
真彩色图像数组。有关详细信息,请参阅 在 MATLAB 中使用图像类型。
表单元格图标的对齐方式,指定为下表中的值之一。表中的示例显示为 HorizontalAlignment
样式为 'center'
的表 UI 组件指定每个 IconAlignment
值的结果。
值 | 描述 | 示例 |
---|---|---|
'left' | 图标直接显示在文本的左侧。 | |
'right' | 图标直接显示在文本的右侧。 | |
'center' | 图标显示在单元格的中心,位于文本的后面。 | |
'leftmargin' | 无论文本位置如何,图标都显示在单元格的最左侧。 当 | |
'rightmargin' | 无论文本位置如何,图标都显示在单元格的最右侧。 当 | |
注意
如果向树 UI 组件添加用于指定图标对齐的 Style
对象,该属性对树的外观不起作用。
版本历史记录
在 R2019b 中推出创建样式以添加到列表框或下拉 UI 组件的项目。使用 addStyle
函数向 ListBox
或 DropDown
对象添加样式。
创建样式来为表和树 UI 组件添加图标和格式化文本。
指定样式对象的
Icon
属性以向表单元格和树节点添加图标。指定样式对象的
IconAlignment
属性以修改图标相对于表单元格中文本的显示位置。指定样式对象的
Interpreter
属性,以使用 HTML 标记设置文本格式或添加链接,或为表单元格和树节点添加使用 TeX 或 LaTeX 标记的方程。指定样式对象的
HorizontalClipping
属性,以控制表单元格和树节点中的长文本是在左侧还是在右侧裁剪。
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
选择网站
选择网站以获取翻译的可用内容,以及查看当地活动和优惠。根据您的位置,我们建议您选择:。
您也可以从以下列表中选择网站:
如何获得最佳网站性能
选择中国网站(中文或英文)以获得最佳网站性能。其他 MathWorks 国家/地区网站并未针对您所在位置的访问进行优化。
美洲
- América Latina (Español)
- Canada (English)
- United States (English)
欧洲
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)