Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

uiswitch

创建滑块开关、拨动开关或拨动开关组件

说明

sw = uiswitch 在新图窗窗口中创建一个滑块开关,并返回 Switch 对象。MATLAB® 调用 uifigure 函数来创建该图窗。

sw = uiswitch(style) 创建指定样式的开关。

示例

sw = uiswitch(parent) 在指定的父容器中创建开关。父容器可以是使用 uifigure 函数创建的 Figure 或其子容器之一。

示例

sw = uiswitch(parent,style) 在指定的父容器中创建指定样式的开关。

示例

sw = uiswitch(___,Name,Value) 使用一个或多个 Name,Value 对组参数指定对象属性。可以将此选项与前面语法中的任何输入参数组合一起使用。

示例

全部折叠

fig = uifigure;
sliderswitch = uiswitch(fig);

fig = uifigure;
toggleswitch = uiswitch(fig,'toggle');

在面板中创建跷板开关。

fig = uifigure;
pnl = uipanel(fig);
rockerswitch = uiswitch(pnl,'rocker');

创建一个跷板开关。

fig = uifigure;
rockerswitch = uiswitch(fig,'rocker');

更改开关文本。

rockerswitch.Items = {'Stop','Start'};

确定当前开关值。

val = rockerswitch.Value
val =

    'Stop'

将以下代码以 lampswitch.m 文件保存到 MATLAB 路径中。以下代码将创建一个 App,其中包含一个信号灯和一个跷板开关。当用户跷板开关时,ValueChangedFcn 回调将改变信号灯的颜色。

function lampswitch
fig = uifigure('Position',[100 100 370 280]);


lmp = uilamp(fig,...
    'Position',[165 75 20 20],...
    'Color','green');


sw = uiswitch(fig,'toggle',...
    'Items',{'Go','Stop'},...    
    'Position',[165 160 20 45],...
    'ValueChangedFcn',@switchMoved); 

% ValueChangedFcn callback
function switchMoved(src,event)  
    switch src.Value
        case 'Go'
            lmp.Color = 'green';
        case 'Stop'
            lmp.Color = 'red';
        end
    end
end

运行 lampswitch,然后点击开关以查看颜色变化。

输入参数

全部折叠

开关的样式,指定为下表中的值之一:

样式外观
'slider'
'rocker'
'toggle'

父容器,指定为使用 uifigure 函数创建的 Figure 对象或其子容器之一:TabPanelButtonGroupGridLayout。如果不指定父容器,MATLAB 会调用 uifigure 函数创建新 Figure 对象充当父容器。

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数,如 Name1,Value1,...,NameN,ValueN 所示。

示例: 'Text',{'0','1'} 指定两个开关状态“0”和“1”。

每种类型的开关支持一组不同的属性。有关每种类型的属性和说明的完整列表,请参阅相关联的属性页。

在 R2016a 中推出