brush

刷亮标记颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。要创建特定颜色的刷亮标记，请在刷亮数据值之前设置颜色属性。设置刷亮颜色不会影响当前标记，除非您刷亮数据、更改刷亮颜色，然后使用 Shift 键添加或删除标记。在这种情况下，所有标记都会更新为新颜色。

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

此外，还可以按名称指定一些常见的颜色。下表列出了一些命名颜色选项、其等效 RGB 三元组及十六进制颜色代码。

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 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)) 获取十六进制颜色代码。

刷亮模式状态，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 OnOffSwitchState 类型的 on/off 逻辑值。

刷亮前要执行的函数，指定为下列值之一：

使用此属性在开始刷亮图时执行代码。如果使用函数句柄指定此属性，则 MATLAB 在执行回调时将向回调函数传递两个参量：

有关如何使用函数句柄定义回调定义的详细信息，请参阅Create Callbacks for Graphics Objects。

刷亮后执行的函数，指定为下列值之一：

使用此属性在完成图的刷亮后执行代码。如果使用函数句柄指定此属性，则 MATLAB 在执行回调时将向回调函数传递两个参量：

有关如何使用函数句柄定义回调定义的详细信息，请参阅Create Callbacks for Graphics Objects。

刷亮隐藏回调，指定为下列值之一：

使用此属性可隐藏在您定义的条件下的刷亮。数值或逻辑值输出 1 (true) 表示隐藏刷亮操作，数值或逻辑值输出 0 (false) 表示允许刷亮操作继续。如果使用函数句柄指定此属性，则 MATLAB 在执行回调时将向回调函数传递两个参量：

如果使用函数句柄指定此属性，则必须将此函数的输出赋给变量。

有关如何使用函数句柄定义回调定义的详细信息，请参阅Create Callbacks for Graphics Objects。

其中出现刷亮标记的 Figure 对象。

旧模式，指定为 "on" 或 "off"，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 "on" 等效于 true，"off" 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。有关详细信息，请参阅Legacy Exploration Modes。

一旦此属性设置为 "on"，您就无法将其更改回 "off"。

在 R2025a 之前的版本中: 此属性仅适用于使用 uifigure 函数或在 MATLAB Online™ 中创建的图窗的 brush 对象。将此属性设置为 "on" 会更改 UI 图窗中交互模式的行为，使其与传统图窗中模式的行为相匹配。有关详细信息，请参阅 enableLegacyExplorationModes。