uispinner
スピナー コンポーネントの作成
説明
spn = uispinnerSpinner オブジェクトを返します。MATLAB® は関数 uifigure を呼び出してこの Figure を作成します。
spn = uispinner(___,Name,Value)Name,Value のペアの引数を使用して、Spinner のプロパティを指定します。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。
例
fig = uifigure; spn = uispinner(fig);
パネル内にスピナーを作成します。
fig = uifigure; pnl = uipanel(fig); spn = uispinner(pnl);
アプリ ユーザーが入力できる値を 0 から 100 (上下限値を含む) に制限するスピナーを作成します。
スピナーを作成します。
fig = uifigure; spn = uispinner(fig);
範囲を調べます。戻り値は、上下限値が制限されていないことを示します。
limits = spn.Limits
limits = -Inf Inf
範囲を 0 から 100 に設定します。
spn.Limits = [0 100];
-5 より大きく 10 以下の値をアプリ ユーザーが入力できるスピナーを作成します。
fig = uifigure; spn = uispinner(fig,'Limits', [-5 10],... 'LowerLimitInclusive','off',... 'UpperLimitInclusive','on',... 'Value', 5);
コードを実行します。範囲外の値をスピナーに入力した場合、MATLAB は問題を示すメッセージを自動的に表示します。次に MATLAB は値を直前の有効な値に戻します。
アプリ ユーザーが任意の値を入力でき、ただし、必ず厳密に 2 桁の小数部を使用して値が表示されるスピナーを作成します。MATLAB はアプリ ユーザーが入力したそのままの値を格納することに注意してください。
fig = uifigure; spn = uispinner(fig,'ValueDisplayFormat', '%.2f');
コードを実行してから、スピナーに 5.555 と入力します。スピナーの外側をクリックします。スピナーには 5.55 が表示されます。
MATLAB は元の値 5.555 を格納します。
スピナーをクリックすると、当初入力した値が表示されます。
スピナーとスライダーを作成します。アプリ ユーザーがスピナーの値を変更すると、その値に一致するようにスライダーが更新されます。
MATLAB パス上の spinnerValue.m に次のコードを保存します。このコードは、スライダーとスピナーを含む Figure ウィンドウを作成します。アプリ ユーザーがスピナーの値を変更すると、ValueChangedFcn はスピナーの値を反映するようにスライダーを更新します。
function spinnervalue fig = uifigure('Position',[100 100 370 280]); sld = uislider(fig,... 'Position',[90 220 120 3]); spn = uispinner(fig,... 'Position',[100 140 100 22],... 'Limits',sld.Limits,... 'ValueChangedFcn',@(spn,event) updateSlider(spn,sld)); end % Create ValueChangedFcn callback function updateSlider(spn,sld) sld.Value = spn.Value; end
spinnerValue を実行します。
スピナーの上矢印をクリックして押したままにし、値が 24 に達したら上矢印を離します。スライダーのつまみが移動してスピナーの値を示します。
スピナーとスライダーを作成します。アプリ ユーザーがスピナーの値を変更しているとき、その値に一致するようにスライダーが繰り返し更新されます。
MATLAB パス上の showChangingValue.m に次のコードを保存します。このコードは、スライダーとスピナーを含む Figure ウィンドウを作成します。アプリ ユーザーがスピナーの値を変更しているとき、ValueChangingFcn はスピナーの値の変化に合わせて繰り返しスライダーを更新します。
function showChangingValue fig = uifigure('Position',[100 100 370 280]); sld = uislider(fig,... 'Position',[90 220 120 3]); spn = uispinner(fig,... 'Position',[100 140 100 22],... 'Limits',sld.Limits,... 'ValueChangingFcn',@(spn,event) spinnerChanging(event,sld)); end % Create ValueChangingFcn callback function spinnerChanging(event,sld) sld.Value = event.Value; end
showChangingValue を実行します。
スピナーの上矢印をクリックして押したままにし、値が 24 に達したら上矢印を離します。スピナーの値の変化に従ってスライダーが移動します。
直前のスピナーの値と比較して値が増加しているか減少しているかを調べる ValueChangedFcn コールバックのコードを記述します。ランプの色を、値が増加しているときには緑、値が減少しているときには赤に設定します。
MATLAB パス上の upOrDown.m に次のコードを保存します。
function upOrDown fig = uifigure(... 'Position',[100 100 190 170]); lmp = uilamp(fig,... 'Position',[90 50 20 20],... 'Color','green'); spn = uispinner(fig,... 'Position',[50 100 100 22],... 'ValueChangedFcn',@(spn,event) spinnerValueChanged(event,lmp)); end % Create ValueChangedFcn that uses event data function spinnerValueChanged(event,lmp) newValue = event.Value; previousValue = event.PreviousValue; difference = newValue-previousValue; if difference > 0 lmp.Color = 'green'; else lmp.Color = 'red'; end end
upOrDown を実行します。
スピナーの値を変更するたびに、ValueChangedFcn は値が増加しているか減少しているかを判別し、それに応じてランプの色を設定します。
入力引数
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。
例: 'Value',150 はスピナーに表示する数値 50 を指定します。
以下にリストするプロパティは、利用できるプロパティの一部です。完全なリストについては、Spinner を参照してください。
値の表示形式。文字ベクトルまたは string スカラーとして指定します。
MATLAB は sprintf を使用して、指定された形式を使用して値を表示します。
テキストと書式演算子を混在させることができます。以下に例を示します。
spin = uispinner('ValueDisplayFormat','%.0f MS/s');
結果としてスピナー コンポーネントは次のようになります。
アプリ ユーザーがスピナーのフィールドをクリックすると、フィールドにはテキストを除いた値が表示されます。
サポートされている書式演算子の詳細なリストについては、sprintf を参照してください。
バージョン履歴
R2016a で導入
