uigauge

Create gauge component

Syntax

g = uigauge

g = uigauge(parent)

g = uigauge(style)

g = uigauge(parent,style)

g = uigauge(___,Name,Value)

Description

g = uigauge creates a circular gauge in a new figure and returns the Gauge object. MATLAB^® calls the uifigure function to create the figure.

g = uigauge(parent) creates a gauge in the specified parent container. The parent can be a Figure object or one of its child containers.

g = uigauge(style) creates a gauge of the specified style. The gauge style can be "circular", "linear", "ninetydegree", or "semicircular".

g = uigauge(parent,style) creates a gauge of the specified style in the specified parent container.

g = uigauge(___,Name,Value) specifies gauge properties using one or more name-value arguments in addition to any of the input argument combinations in the previous syntaxes. For example, uigauge("Value",10) creates a gauge with a value of 10.

Examples

Create Circular Gauge

Create a circular gauge in a UI figure.

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

Create Gauges in Grid Layout Manager

Create a UI figure with a 2-by-3 grid layout manager. Create four gauges with different styles and specify the grid layout manager as the parent container for each of the gauges. Lay out the linear gauge to span the entire bottom row of the grid.

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];

Set and Access Gauge Properties

Create a circular gauge in a UI figure.

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

Specify the gauge limits and value.

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

Access the values of the major tick marks of the gauge.

mt = cg.MajorTicks

mt = 1×6

   -50   -30   -10    10    30    50

Specify Linear Gauge Orientation

Create a vertical linear gauge in a UI figure.

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

Specify Ticks and Tick Labels

Create a ninety-degree gauge in a UI figure.

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

Customize the gauge appearance by changing the number of major ticks, specifying tick labels that correspond to the major ticks, and removing minor ticks.

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

Specify Scale Colors and Color Limits

Create a semicircular gauge in a UI figure.

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

Change the colors of the high gauge values by setting the ScaleColors and ScaleColorLimits properties.

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

Input Arguments

parent — Parent container

Figure object (default) | Tab object | Panel object | ButtonGroup object | GridLayout object

Parent container, specified as a Figure object or one of its child containers: Tab, Panel, ButtonGroup, or GridLayout. If you do not specify a parent container, MATLAB calls the uifigure function to create a new Figure object that serves as the parent container.

style — Style of gauge

"circular" (default) | "linear" | "ninetydegree" | "semicircular"

Style of gauge, specified as one of these values:

Style	Appearance
"circular"
"linear"
"ninetydegree"
"semicircular"

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: uigauge(Value=10) specifies the gauge value as 10.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: uigauge("Value",10) specifies the gauge value as 10.

Each style of gauge supports a different set of properties. For a full list of properties and descriptions for each style, see the associated gauge component page.

• Gauge

• LinearGauge

• NinetyDegreeGauge

• SemicircularGauge

Version History

Introduced in R2016a