uigauge

ゲージ コンポーネントの作成

構文

g = uigauge

g = uigauge(parent)

g = uigauge(style)

g = uigauge(parent,style)

g = uigauge(___,Name,Value)

説明

g = uigauge は、円形ゲージを新しい Figure 内に作成し、Gauge オブジェクトを返します。MATLAB^® は uifigure 関数を呼び出してこの Figure を作成します。

g = uigauge(parent) は、指定された親コンテナー内にゲージを作成します。親には、Figure オブジェクト、またはそのいずれかの子コンテナーを指定できます。

g = uigauge(style) は、指定されたスタイルのゲージを作成します。ゲージ スタイルは "circular"、"linear"、"ninetydegree"、または "semicircular" にすることができます。

g = uigauge(parent,style) は、指定された親コンテナー内に指定されたスタイルのゲージを作成します。

g = uigauge(___,Name,Value) は、前述の構文の任意の入力引数の組み合わせに加え、1 つ以上の名前と値の引数を使用してゲージのプロパティを指定します。たとえば、uigauge("Value",10) は値 10 を指定してゲージを作成します。

例

円形ゲージの作成

UI Figure 内に円形ゲージを作成します。

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

グリッド レイアウト マネージャーでのゲージの作成

2 行 3 列のグリッド レイアウト マネージャーで UI Figure を作成します。異なるスタイルのゲージを 4 つ作成し、各ゲージの親コンテナーとしてグリッド レイアウト マネージャーを指定します。グリッドの一番下の行全体にわたって直線ゲージをレイアウトします。

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

ゲージのプロパティの設定とアクセス

UI Figure 内に円形ゲージを作成します。

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

ゲージの範囲と値を指定します。

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

ゲージの大目盛りの値にアクセスします。

mt = cg.MajorTicks

mt = 1×6

   -50   -30   -10    10    30    50

直線ゲージの向きの指定

UI Figure 内に垂直方向の直線ゲージを作成します。

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

目盛りと目盛りラベルの指定

UI Figure 内に 90 度ゲージを作成します。

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

大目盛りの数を変更し、大目盛りに対応する目盛りラベルを指定し、小目盛りを削除することでゲージの外観をカスタマイズします。

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

スケール カラーと色の範囲を指定

UI Figure 内に半円ゲージを作成します。

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

ScaleColors プロパティと ScaleColorLimits プロパティを設定して、高いゲージ値の色を変更します。

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

入力引数

parent — 親コンテナー

Figure オブジェクト (既定値) | Tab オブジェクト | Panel オブジェクト | ButtonGroup オブジェクト | GridLayout オブジェクト

親コンテナー。Figure オブジェクトまたはその子コンテナー (Tab、Panel、ButtonGroup、GridLayout) のいずれかとして指定します。親コンテナーを指定しない場合、MATLAB は関数 uifigure を呼び出し、親コンテナーとして機能する新しい Figure オブジェクトを作成します。

style — ゲージのスタイル

"circular" (既定値) | "linear" | "ninetydegree" | "semicircular"

ゲージのスタイル。次の値のいずれかとして指定します。

スタイル	外観
"circular"
"linear"
"ninetydegree"
"semicircular"

名前と値の引数

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

例: uigauge(Value=10) はゲージの値を 10 として指定します。

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: uigauge("Value",10) はゲージの値を 10 として指定します。

ゲージのスタイルごとに異なる一連のプロパティがサポートされています。プロパティの完全なリストと各スタイルの説明については、対応するゲージ コンポーネントのページを参照してください。

• Gauge

• LinearGauge

• NinetyDegreeGauge

• SemicircularGauge

バージョン履歴

R2016a で導入

参考

関数

• uifigure

オブジェクト

• Gauge | LinearGauge | NinetyDegreeGauge | SemicircularGauge

ツール

• App Designer