主要内容

ColorBar属性

颜色条外观和行为

ColorBar控件的外观和行为ColorBar对象。通过更改属性值,可以修改颜色条的某些方面。使用点表示法来引用特定的对象和属性:

C = colorbar;w = c.LineWidth;c.LineWidth = 1.5;

蜱虫和标签

全部展开

标记位置,指定为单调递增的数值向量。这些值不需要等距。如果您不希望显示标记,则将属性设置为空向量,[]

例子:[1, 0, 1, 2, 3, 4, 5]

数据类型:|

选择模式蜱虫,指定为以下值之一:

  • “汽车”—自动选择勾值。

  • “手动”—手动指定勾值。要指定刻度值,请设置蜱虫财产。

标记标签,指定为字符向量的单元格数组、字符串数组、数字数组、字符向量或分类数组。默认情况下,颜色条用数值标记标记。如果指定了标签,但没有为所有标记指定足够的标签,则MATLAB®循环标签。

如果将此属性指定为分类数组,MATLAB将使用数组中的值,而不是类别。

例子:{“冷”、“热”、“热”}

选择模式TickLabels,指定为以下值之一:

  • “汽车”—自动选择勾号。

  • “手动”—手动指定勾号。要指定勾号标签,请设置TickLabels财产。

标记标签解释器,指定为以下值之一:

  • “泰克斯”-使用TeX标记的子集解释标签。

  • “乳胶”-使用LaTeX标记的子集解释标签。指定标记标签时,在单元格数组中的每个元素周围使用美元符号。

  • “没有”—显示文字字符。

特克斯标记

默认情况下,MATLAB支持TeX标记万博1manbetx的一个子集。使用TeX标记添加上标和下标,修改文本类型和颜色,并在标签中包含特殊字符。

修饰语一直有效到文本结束。上标和下标是个例外,因为它们只修改下一个字符或花括号内的字符。当您将解释器设置为“泰克斯”时,支持的修万博1manbetx饰符如下。

修饰符 描述 例子
^ {} 上标 “文本^{上标}’
_ {} 下标 “text_{下标}’
\男朋友 大胆的字体 “\ bf文本”
它\ 斜体字体 “\它文本”
\ sl 斜体(通常与斜体相同) “\ sl文本”
rm \ 正常的字体 “\ rm文本”
\字体名{说明符 字体名称-替换说明符使用字体族的名称。你可以和其他修饰语一起使用。 “\字体名{快递}文本”
\字形大小{说明符 字体大小-替换说明符以点单位为单位的数值标量值。 ”字形大小{15}文本”
{\颜色说明符 字体颜色-替换说明符用这些颜色中的一种:红色的绿色黄色的品红色的蓝色的黑色的白色灰色的暗绿色橙色,或lightBlue “{品红}\颜色文本”
\颜色(rgb){说明符} 自定义字体颜色-替换说明符三元素RGB三元组。 “\颜色(rgb){0, 0.5, 0.5}文本”

属性中支持的特殊字符万博1manbetx“泰克斯”翻译。

字符序列 象征 字符序列 象征 字符序列 象征

α

\ upsilon

υ

\ sim

\角

\ leq

\ ast

\气

χ

\ infty

β\

β

ψ

\ clubsuit

γ

ω

\ diamondsuit

δ

Γ

\ heartsuit

ϵ

Δ

\ spadesuit

ζ

Θ

\ leftrightarrow

\埃塔

η

Λ

\ leftarrow

θ

Ξ

\ Leftarrow

\ vartheta

ϑ

Π

\向上光标键

\极微小

ι

Σ

\ rightarrow

\卡巴

κ

\ Upsilon

ϒ

\ Rightarrow

λ

Φ

\ downarrow

µ

Ψ

\保监会

º

ν

Ω

下午\

±

ξ

\原则

\组

π

\存在

\ propto

ρ

倪\

\部分

σ

丛\

\子弹

\ varsigma

ς

\约

\ div

÷

τ

\再保险

\ neq

\枚

\ oplus

\ aleph

、即时通讯

\杯

\ wp

\ otimes

\ subseteq

\帕

\帽

中\

\ supseteq

\ supset

\ lceil

\子集

int \

\ cdot

·

阿\

ο

\ rfloor

\底片

¬

\微分算符

\ lfloor

\ *

x

\ ldots

...

\补

\清音

\ '

´

\楔

\ varpi

ϖ

\ 0

\ rceil

\捕杀

中期\

|

\三角

\ langle

\版权

©

乳胶标记

要使用LaTeX标记,请设置TickLabelInterpreter财产“乳胶”.在标签周围使用美元符号,例如,使用'$\int_1^{20} x^2 dx$'对于内联模式或'$$\int_1^{20} x^2 dx$$'用于显示模式。

显示的文本使用默认的LaTeX字体样式。的字体名FontWeight,FontAngle属性没有影响。要更改字体样式,请在文本中使用LaTeX标记。LaTeX解释器可以使用的文本的最大大小是1200个字符。对于多行文本,文本的最大大小每行减少约10个字符。

有关使用TeX和LaTeX的示例,请参见图表文本中的希腊字母与特殊字符.有关LaTeX系统的更多信息,请参见LaTeX项目网站https://www.latex-project.org/

最小和最大标记值,指定为两个元素向量。第二个向量元素必须大于第一个元素。

例子:[0 1]

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64

限制的选择模式,指定为以下值之一:

  • “汽车”-自动选择限制。

  • “手动”-使用手动指定的限制。要指定限制,请设置限制财产。

沿颜色条显示的标签,作为文本对象返回。此文本对象包含控制标签外观和显示文本的属性。使用标签属性来访问文本对象,例如:

C = colorbar;c.Label
ans =带有属性的文本:字符串:" FontSize: 10 FontWeight: 'normal' FontName: 'Helvetica'颜色:[0.1500 0.1500 0.1500]HorizontalAlignment: 'left'位置:[0 00 0]单位:'data'显示所有属性

要添加标签或更改标签,请设置字符串属性,例如:

c.Label.String =“标签文本到这里”

若要更改标签外观,如字体样式或颜色,请设置其他文本属性。例如,这段代码更改字体大小。

c.Label.FontSize = 12;

有关完整的选项列表,请参见文本属性

颜色刻度的方向,指定为以下值之一:

  • “正常”—如果是垂直色条,从下往上显示色图和标签;如果是水平色条,从左往右显示色图和标签。

  • “反向”—垂直色条显示从下到上的色图和标签,水平色条显示从左到右的色图。

标记长度,指定为标量。指定刻度长度为颜色条轴长度的一部分。

例子:0.05

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64

标记方向,指定为以下值之一:

价值 描述 结果
“在” 显示颜色条框内的标记。

“出” 显示颜色栏框外的标记。

字体

全部展开

字体名称,指定为受支持的字体名称或万博1manbetx“FixedWidth”.要正确显示和打印文本,必须选择系统支持的字体。万博1manbetx默认字体取决于您的操作系统和区域设置。

要使用固定宽度的字体,在任何地区都看起来不错,请使用“FixedWidth”.固定宽度的字体依赖于根FixedWidthFontName财产。设置根目录FixedWidthFontName属性导致立即更新显示以使用新字体。

字体大小,指定为大于零的标量值(单位为点)。默认字体大小取决于特定的操作系统和区域设置。

如果您更改轴字体大小,那么MATLAB自动将颜色条的字体大小设置为轴字体大小的90%。如果手动设置颜色条的字体大小,则更改轴字体大小不会影响颜色条字体。

字符倾斜,指定为“正常”“斜体”

并非所有字体都有两种字体样式。因此,斜体可能看起来和正常字体一样。

字符厚度,指定为“正常”“大胆”

MATLAB使用FontWeight属性从系统上可用的字体中选择一种。并非所有字体都有粗体。因此,指定粗体字体粗细仍然可以得到正常字体粗细。

位置

全部展开

相对于坐标轴的位置,指定为本表中列出的值之一。

价值 产生的位置 产生的取向
“北” 轴顶 水平
“南” 轴底 水平
“东” 坐标轴右侧 垂直
“西方” 坐标轴左侧 垂直
“northoutside” 轴的顶部外侧 水平
“southoutside” 轴外侧底部 水平
“eastoutside” 轴的正前方(默认) 垂直
“westoutside” 坐标轴外的左边 垂直
“手动” 位置财产 垂直
“布局” 平铺图表布局中的平铺。若要将颜色条移动到不同的平铺,请设置布局属性。 这取决于瓷砖的形状

要在表中未出现的位置显示颜色条,请使用位置属性指定自定义位置。如果你设置位置属性,然后MATLAB设置位置财产“手动”.属性时,关联轴不会调整大小以适应颜色条位置属性设置为“手动”

轴位置,指定为以下值之一。使用此属性可指定打勾标记、打勾标签和颜色条标签的位置。

  • “出”-将颜色条一侧的勾号和标签向图形外侧显示。这是默认值。

  • “在”-将颜色条一侧的标记和标签向图形内部显示。

选择模式AxisLocation,指定为以下值之一:

  • “汽车”—自动选择位置。

  • “手动”—使用手动指定的位置。要指定位置,请设置AxisLocation财产。

自定义位置和大小,指定为窗体的四元素向量[左,下,宽,高].的而且元素指定从图形的左下角或到颜色条的左下角的距离。的宽度而且高度元素指定颜色条的尺寸。的单位属性决定位置单位。

如果您指定位置属性,然后MATLAB更改位置财产“手动”.属性时,关联轴不会调整大小以适应颜色条位置属性是“手动”

例子:[0.1 0.1 0.3 0.7]

请注意

类的父容器时,设置此属性无效TiledChartLayout

定位单位,指定为此表中的值之一。

单位 描述
“归一化”(默认) 对父容器进行了规范化,通常是图中的父容器。图的左下角映射到(0,0)右上角映射到(1,1)
“英寸” 英寸。
“厘米” 厘米。
“角色”

基于系统默认字体的字符大小。

  • 字符宽度=字母的宽度x

  • 字符高度=两行文本基线之间的距离。

“点” 点。1分等于1/72英寸。
“像素”

像素。

  • 在Windows上®一个像素是1/96英寸。

  • 麦金塔电脑在系统中,一个像素是1/72英寸。

  • 在Linux上®在系统中,像素的大小是由系统分辨率决定的。

所有单位都从父容器的左下角开始测量。

属性会影响其他属性,例如位置财产。如果更改了单位,则在完成计算后将单位返回为默认值,以防止影响采用默认值的其他函数。

如果您指定位置而且单位属性是名称,值对创建对象时,那么规范的顺序很重要。例如,要设置特定单位中的位置,则必须设置单位属性位置财产。

布局选项,指定为TiledChartLayoutOptions对象。当色条处于平铺图表布局中时,此属性非常有用。

要在平铺图表布局的网格中定位颜色条,请设置瓷砖的属性TiledChartLayoutOptions对象。例如,考虑一个3 * 3平铺的图表布局。该布局在中心有一个瓷砖网格,沿外缘有四个瓷砖。实际上,网格是看不见的,外部的瓷砖不会占用空间,直到你用轴或其他对象填充它们。

3 × 3平铺图表布局图。

这段代码放置了颜色条cb在网格的第三个瓦片..

cb.Layout.Tile = 3;

要将颜色条放置在周围的一个磁贴中,请指定瓷砖财产“北”“南”“东”,或“西方”.例如,将值设置为“东”将颜色条放置在网格右侧的贴图中。

cb.Layout.Tile =“东”

如果色条不是平铺图表布局的子元素(例如,如果它是图形的子元素),则此属性为空,没有效果。

颜色和样式

全部展开

标记、文本和框轮廓的颜色,指定为RGB三元组、十六进制颜色代码、颜色名称或短名称。

对于自定义颜色,请指定RGB三元组或十六进制颜色代码。

  • RGB三元组是一个三元素行向量,其元素指定颜色的红、绿和蓝分量的强度。强度必须在这个范围内[0, 1];例如,[0.4 0.6 0.7]

  • 十六进制颜色码是字符向量或以散列符号()后面跟着三个或六个十六进制数字,取值范围为0F.这些值不区分大小写。因此,颜色代码“# FF8800”“# ff8800”“# F80”,“# f80”是等价的。

或者,您可以通过名称指定一些常用颜色。该表列出了已命名的颜色选项、等效的RGB三元组和十六进制颜色代码。

颜色名称 短名称 RGB值 十六进制颜色代码 外观
“红色” “r” [10 0 0] “# FF0000”

样品的颜色为红色

“绿色” ‘g’ [0 10 0] “# 00 ff00”

样品的颜色为绿色

“蓝” “b” [0 0 1] “# 0000 ff”

样品的颜色为蓝色

“青色” “c” [0 1 1] “# 00飞行符”

样品的颜色为青色

“红色” “米” [10 0 1] “#就”

样品的颜色为洋红色

“黄色” “y” [11 10 0] “# FFFF00”

样品的颜色为黄色

“黑” “k” [0 0 0] # 000000的

样品颜色为黑色

“白色” ' w ' [1 1 1] “# FFFFFF”

样品颜色为白色

“没有” 不适用 不适用 不适用 没有颜色

下面是MATLAB在许多类型的图中使用的默认颜色的RGB三组和十六进制颜色代码。

RGB值 十六进制颜色代码 外观
[0 0.4470 0.7410] “# 0072 bd”

RGB三联体[0 0.4470 0.7410]样品,呈深蓝色

[0.8500 0.3250 0.0980] “# D95319”

RGB三联体样品[0.8500 0.3250 0.0980],呈暗橙色

[0.9290 0.6940 0.1250] “# EDB120”

RGB三联体样品[0.9290 0.6940 0.1250],呈暗黄色

[0.4940 0.1840 0.5560] “# 7 e2f8e”

RGB三联体样品[0.4940 0.1840 0.5560],呈深紫色

[0.4660 0.6740 0.1880] “# 77 ac30”

RGB三联体[0.4660 0.6740 0.1880]样本,呈现中绿色

[0.3010 0.7450 0.9330] “# 4 dbeee”

RGB三联体样品[0.3010 0.7450 0.9330],呈浅蓝色

[0.6350 0.0780 0.1840] “# A2142F”

RGB三联体样品[0.6350 0.0780 0.1840],呈暗红色

例子:[0 10 0]

例子:“绿色”

例子:“# 00 ff00”

框轮廓,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).值为“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState

  • “上”-在颜色条周围显示框的轮廓。

  • “关闭”-不要在颜色条周围显示框轮廓。

框轮廓的宽度,指定为以点为单位的正值。1分等于1/72英寸。

例子:1.5

交互性

全部展开

可见状态,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).值为“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState

  • “上”—显示对象。

  • “关闭”—隐藏对象,但不删除对象。你仍然可以访问一个不可见对象的属性。

上下文菜单,指定为快捷菜单对象。使用此属性可在右键单击对象时显示上下文菜单。控件创建上下文菜单uicontextmenu函数。

请注意

如果PickableParts属性设置为“没有”或者如果HitTest属性设置为“关闭”,则上下文菜单不会出现。

选择状态,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).值为“上”等于真,和“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState

  • “上”——选择。如果在绘图编辑模式下单击对象,则MATLAB将其设置为选择财产“上”.如果SelectionHighlight属性也设置为“上”,然后MATLAB显示对象周围的选择句柄。

  • “关闭”—未选中。

选定时显示选定句柄,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).值为“上”等于真,和“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState

  • “上”-显示选择句柄选择属性设置为“上”

  • “关闭”-从不显示选择句柄,即使当选择属性设置为“上”

回调

全部展开

鼠标单击回调,指定为以下值之一:

  • 函数处理

  • 包含函数句柄和附加参数的单元格数组

  • 是有效的MATLAB命令或函数的字符向量,在基本工作空间中计算(不推荐)

使用此属性可在单击对象时执行代码。如果使用函数句柄指定此属性,则MATLAB在执行回调函数时将两个参数传递给回调函数:

  • 点击对象-从回调函数中访问点击对象的属性。

  • 事件数据-空参数。将其替换为波浪字符()在函数定义中,以指示不使用此参数。

有关如何使用函数句柄定义回调函数的详细信息,请参见回调函数定义

请注意

如果PickableParts属性设置为“没有”或者如果HitTest属性设置为“关闭”,则此回调不执行。

对象创建函数,指定为以下值之一:

  • 函数处理。

  • 单元格数组,其中第一个元素是函数句柄。单元格数组中的后续元素是传递给回调函数的参数。

  • 包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见回调函数定义

此属性指定在MATLAB创建对象时执行的回调函数。函数执行之前,MATLAB初始化所有属性值CreateFcn回调。如果没有指定CreateFcn属性,然后MATLAB执行默认的创建函数。

设置CreateFcn属性在现有组件上不起作用。

如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问正在创建的对象。否则,使用gcbo函数来访问对象。

对象删除函数,指定为以下值之一:

  • 函数处理。

  • 单元格数组,其中第一个元素是函数句柄。单元格数组中的后续元素是传递给回调函数的参数。

  • 包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见回调函数定义

此属性指定在MATLAB删除对象时执行的回调函数。MATLAB执行DeleteFcn在销毁对象的属性之前。如果没有指定DeleteFcn属性,然后MATLAB执行默认删除函数。

如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问正在删除的对象。否则,使用gcbo函数来访问对象。

回调执行控制

全部展开

回调中断,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).值为“上”等于真,和“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState

此属性决定是否可以中断正在运行的回调。有两种回调状态需要考虑:

  • 运行Callback是当前正在执行的Callback。

  • 打断回调是试图中断正在运行的回调的回调。

每当MATLAB调用回调时,该回调都会试图中断正在运行的回调。的可中断属性决定是否允许中断。的可中断属性有两个可能的值:

  • 值为“上”允许其他回调中断对象的回调。中断发生在MATLAB处理队列的下一个点,例如当存在drawnow数字uifiguregetframe等待,或暂停命令。

    • 如果正在运行的回调包含这些命令之一,那么MATLAB将在该点停止回调的执行并执行中断回调。当中断回调完成时,MATLAB恢复执行正在运行的回调。

    • 如果正在运行的回调不包含这些命令之一,那么MATLAB将不间断地完成回调的执行。

  • 值为“关闭”阻塞所有的中断尝试。的BusyAction拥有中断回调的对象的属性决定中断回调是被丢弃还是放入队列。

回调队列,指定为“队列”“取消”.的BusyAction属性决定MATLAB如何处理中断回调的执行。有两种回调状态需要考虑:

  • 运行Callback是当前正在执行的Callback。

  • 打断回调是试图中断正在运行的回调的回调。

BusyAction属性仅在满足以下两个条件时确定回调排队行为:

在这些条件下,BusyAction拥有中断回调的对象的属性决定了MATLAB如何处理中断回调。的可能值BusyAction属性:

  • “队列”—将中断的回调放到队列中,待正在运行的回调执行完成后再处理。

  • “取消”—不执行中断回调。

捕捉鼠标点击的能力,指定为以下值之一:

  • “可见”-仅在可见时捕获鼠标单击。的可见属性必须设置为“上”.的HitTest属性确定是否ColorBar对象对单击做出响应,或者如果一个祖先响应。

  • “没有”—无法捕获鼠标点击。单击ColorBar对象将单击传递给图形窗口当前视图中它后面的对象。的HitTest的属性ColorBar对象没有效果。

对捕获的鼠标单击的响应,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).值为“上”等于真,和“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState

  • “上”-触发ButtonDownFcn的回调ColorBar对象。如果你已经定义了快捷菜单属性,然后调用上下文菜单。

  • “关闭”类的最近祖先的回调ColorBar对象,该对象具有以下类型之一:

    • HitTest属性设置为“上”

    • PickableParts属性设置为允许祖先捕获鼠标单击的值

请注意

PickableParts属性确定是否ColorBar对象可以捕获鼠标单击。如果不能,那么HitTest财产没有影响。

此属性是只读的。

删除状态,作为类型的on/off逻辑值返回matlab.lang.OnOffSwitchState

MATLAB设置BeingDeleted财产“上”DeleteFcn回调开始执行。的BeingDeleted属性仍然设置为“上”直到组件对象不再存在。

的值BeingDeleted属性在查询或修改对象之前验证对象是否即将被删除。

父/子

全部展开

父容器,指定为数字对象,面板对象,选项卡对象,或TiledChartLayout对象。

ColorBar对象必须具有与关联轴相同的父对象。如果更改相关轴的父轴,则ColorBar对象自动更新以使用相同的父对象。

对象没有子对象。您不能设置此属性。

对象句柄的可见性孩子们属性,指定为以下值之一:

  • “上”-对象句柄始终可见。

  • “关闭”-对象句柄在任何时候都不可见。此选项用于防止另一个函数的意外更改。设置HandleVisibility“关闭”在函数执行期间暂时隐藏句柄。

  • “回调”对象句柄在回调或回调调用的函数中可见,但在从命令行调用的函数中不可见。此选项阻止在命令行上访问对象,但允许回调函数访问它。

属性中未列出对象孩子们属性,则通过搜索对象层次结构或查询句柄属性获取对象句柄的函数不能返回它。此类函数的示例包括得到findobjgcagcfgconewplotclf,关闭功能。

隐藏对象句柄仍然有效。设置根目录ShowHiddenHandles财产“上”列出所有对象句柄,而不管它们HandleVisibility属性设置。

标识符

全部展开

此属性是只读的。

图形对象的类型,返回为“colorbar”

使用此属性可在层次结构中查找对象。例如,您可以使用findobj函数查找具有特定类型属性值。

对象标识符,指定为字符向量或字符串标量。您可以指定一个惟一的标签值作为对象的标识符。方法在代码中的其他地方需要访问对象时,可以使用findobj方法搜索对象标签价值。

用户数据,指定为任意MATLAB数组。例如,您可以指定标量、向量、矩阵、单元格数组、字符数组、表或结构。使用此属性可在对象上存储任意数据。

如果您在应用程序设计器中工作,请在应用程序中创建公共或私有属性以共享数据,而不是使用用户数据财产。有关更多信息,请参见在应用设计器应用中共享数据

兼容性的考虑

全部展开

不建议从R2020a开始

在R2014b中引入