uispinner
创建微调器组件
说明
spn = uispinnerSpinner 对象。MATLAB® 调用 uifigure 函数来创建该图窗。
spn = uispinner(___,Name,Value)Name,Value 对组参量指定 Spinner 属性。可将此选项与上述语法中的任何输入参量组合一起使用。
示例
fig = uifigure; spn = uispinner(fig);
在面板中创建微调器。
fig = uifigure; pnl = uipanel(fig); spn = uispinner(pnl);
创建一个微调器，限制 App 用户只能输入 0 到 100（含 0 和 100）之间的值。
创建一个微调器。
fig = uifigure; spn = uispinner(fig);
确定范围。返回的值表明上限和下限不受限制。
limits = spn.Limits
limits = -Inf Inf
将范围设置为 0 到 100。
spn.Limits = [0 100];
创建一个微调器，允许 App 用户输入大于 -5 且小于或等于 10 的值。
fig = uifigure; spn = uispinner(fig,'Limits', [-5 10],... 'LowerLimitInclusive','off',... 'UpperLimitInclusive','on',... 'Value', 5);
运行代码。如果您在微调器中输入的值超出该范围，MATLAB 将自动显示一条消息，指出存在的问题。MATLAB 然后会将值还原为上一个有效值。
创建一个微调器，允许 App 用户输入任意值，但始终只显示两位小数。请注意，MATLAB 会存储 App 用户输入的确切值。
fig = uifigure; spn = uispinner(fig,'ValueDisplayFormat', '%.2f');
运行代码，然后在微调器中输入 5.555。在微调器外点击。微调器显示 5.55。
MATLAB 存储的原始值为 5.555。
在微调器中点击，将显示最初键入的值。
创建一个微调器和一个滑块控件。当 App 用户更改微调器值时，滑块将更新以匹配该值。
请将以下代码保存到 MATLAB 路径中的 spinnerValue.m 中。以下代码将创建一个图窗窗口，其中包含一个滑块控件和一个微调器。当 App 用户更改微调器值时，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 时释放鼠标按键。滑块将移动，以指示微调器值。
创建一个微调器和一个滑块控件。当 App 用户更改微调器值时，滑块将不断更新以匹配该值。
请将以下代码保存到 MATLAB 路径中的 showChangingValue.m 中。以下代码将创建一个图窗窗口，其中包含一个滑块控件和一个微调器。当 App 用户更改微调器值时，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。
值的显示格式，指定为字符向量或字符串标量。
MATLAB 使用 sprintf 以指定的格式显示值。
您可以混合使用文本和格式化操作符。例如：
spin = uispinner('ValueDisplayFormat','%.0f MS/s');
生成的微调器组件如下所示：
当 App 用户点击微调器字段时，字段将显示不带文本的值。
有关支持的格式化操作符的完整列表，请参阅 sprintf。
版本历史记录
在 R2016a 中推出
