主要内容

uigauge

创建仪表组件

说明

g = uigauge 在新图窗中创建一个圆形仪表,并返回 Gauge 对象。MATLAB® 调用 uifigure 函数来创建该图窗。

g = uigauge(parent) 在指定的父容器中创建一个仪表。父容器可以是 Figure 对象或其子容器之一。

示例

g = uigauge(style) 创建一个指定样式的仪表。仪表样式可以是 "circular""linear""ninetydegree""semicircular"

g = uigauge(parent,style) 在指定的父容器中创建指定样式的仪表。

示例

g = uigauge(___,Name,Value) 支持上述语法中的任何输入参量组合,且可使用一个或多个名称-值参量指定仪表属性。例如,uigauge("Value",10) 创建一个值为 10 的仪表。

示例

示例

全部折叠

在 UI 图窗中创建一个圆形仪表。

fig = uifigure("Position",[100 100 300 300]);
cg = uigauge(fig);

Figure contains an object of type uigauge.

用 2×3 网格布局管理器创建一个 UI 图窗。创建四个具有不同样式的仪表,并将网格布局管理器指定为每个仪表的父容器。将线性仪表的布局设置为横跨网格的整个底部行。

fig = uifigure("Position",[100 100 470 220]);
g = uigridlayout(fig,[2 3]);
g.RowHeight = {'1x','fit'};
cg = uigauge(g);
ng = uigauge(g,"ninetydegree");
sg = uigauge(g,"semicircular");
lg = uigauge(g,"linear");
lg.Layout.Column = [1 3];

Figure contains an object of type uigridlayout.

在 UI 图窗中创建一个圆形仪表。

fig = uifigure("Position",[100 100 300 300]);
cg = uigauge(fig);

Figure contains an object of type uigauge.

指定仪表范围和值。

cg.Limits = [-50 50];
cg.Value = 20;

Figure contains an object of type uigauge.

访问仪表的主刻度线的值。

mt = cg.MajorTicks
mt = 1×6

   -50   -30   -10    10    30    50

在 UI 图窗中创建一个垂直线性仪表。

fig = uifigure("Position",[100 100 300 300]);
lg = uigauge(fig,"linear","Orientation","vertical");

Figure contains an object of type uilineargauge.

在 UI 图窗中创建一个 90 度仪表。

fig = uifigure("Position",[100 100 300 300]);
ng = uigauge(fig,"ninetydegree");

Figure contains an object of type uininetydegreegauge.

通过更改主刻度的数量、指定与主刻度对应的刻度标签以及删除次刻度来自定义仪表外观。

ng.MajorTicks = 0:50:100;
ng.MajorTickLabels = ["Low","Med","High"];
ng.MinorTicks = [];

Figure contains an object of type uininetydegreegauge.

在 UI 图窗中创建一个半圆形仪表。

fig = uifigure("Position",[100 100 300 300]);
sg = uigauge(fig,"semicircular");

通过设置 ScaleColorsScaleColorLimits 属性来更改高仪表值的颜色。

sg.ScaleColors = ["yellow","red"];
sg.ScaleColorLimits = [60 80; 80 100];

Figure contains an object of type uisemicirculargauge.

输入参数

全部折叠

父容器,指定为 Figure 对象或其子容器之一:TabPanelButtonGroupGridLayout。如果不指定父容器,MATLAB 会调用 uifigure 函数创建新 Figure 对象充当父容器。

仪表的样式,指定为以下值之一:

样式外观
"circular"Circular gauge. The gauge has values from 0 to 100 laid out clockwise in a circle.
"linear"Linear gauge. The gauge has values from 0 to 100 laid out in a horizontal line.
"ninetydegree"Ninety-degree gauge. The gauge has values from 0 to 100 laid out clockwise in a quarter circle.
"semicircular"Semicircular gauge. The gauge has values from 0 to 100 laid out clockwise in a semicircle.

名称-值参数

Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组,其中 Name 是参量名称,Value 是对应的值。名称-值参量必须出现在其他参量之后,但参量对组的顺序无关紧要。

示例: uigauge(Value=10) 将仪表值指定为 10。

在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name 引起来。

示例: uigauge("Value",10) 将仪表值指定为 10。

每种仪表样式都支持一组不同属性。有关每种样式的属性和描述的完整列表,请参阅相关联的仪表组件页。

版本历史记录

在 R2016a 中推出