uigauge

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

構文

g = uigauge

g = uigauge(style)

g = uigauge(parent)

g = uigauge(parent,style)

g = uigauge(___,Name,Value)

説明

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

g = uigauge(style) はゲージのスタイルを指定します。

g = uigauge(parent) は、指定された親コンテナー内にゲージを作成します。親には、関数 uifigure を使用して作成された Figure か、またはその子コンテナーのいずれかを指定できます。

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

g = uigauge(___,Name,Value) は、1 つ以上の Name,Value のペアの引数を使用して、オブジェクトのプロパティを指定します。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。

例

円形ゲージの作成

fig = uifigure;
cg = uigauge(fig);

直線ゲージの作成

fig = uifigure;
lg  = uigauge(fig,'linear');

パネルに直線ゲージを作成

線形ゲージの親コンテナーとしてパネルを指定します。

fig = uifigure;
pnl = uipanel(fig);
lg = uigauge(pnl,'linear');

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

円形ゲージを作成し、ScaleDirection プロパティを設定して針の移動方向を反時計回りに指定します。

fig = uifigure;
cg = uigauge(fig,'ScaleDirection','counterclockwise');

大目盛りの数を変更し、対応する目盛りラベルを指定して、小目盛りを削除します。

cg.MajorTicks = [0:10:100];
cg.MajorTickLabels = {'0','10','20','30','40','50','60','70','80','90','100'};
cg.MinorTicks = [];

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

fig = uifigure;
cg = uigauge(fig,'ScaleColors',{'yellow','red'},...
                 'ScaleColorLimits', [60 80; 80 100]);

入力引数

style — ゲージのスタイル

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

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

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

parent — 親コンテナー

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

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

名前と値の引数

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

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

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

• Gauge のプロパティ

• SemicircularGauge のプロパティ

• NinetyDegreeGauge のプロパティ

• LinearGauge のプロパティ

バージョン履歴

R2016a で導入

参考

関数

• uifigure

プロパティ

• Gauge のプロパティ | SemicircularGauge のプロパティ | NinetyDegreeGauge のプロパティ | LinearGauge のプロパティ

ツール

• App Designer