主要内容

uislider

创建滑块组件

描述

道防线= uislider在新图形窗口中创建滑块并返回滑块对象。MATLAB®调用uifigure函数创建图形。

例子

道防线= uislider (在指定的父容器中创建滑块。父结点可以是数字创建使用uifigure函数或其子容器之一。

例子

道防线= uislider (___名称,值指定滑块属性使用一个或多个名称,值对参数。将此选项与前面语法中的任何输入参数组合一起使用。

例子

全部折叠

无花果= uifigure;sld = uislider(图);

图形中的默认滑块。滑块范围从0到100,每20个单位有标记的滴答声,每4个单位有小滴答声。

创建包含面板的图形窗口。创建一个滑块并指定它在面板中的位置。

无花果= uifigure;pnl = uipanel(图);sld = uislider (pnl,“位置”,[50 50 150 3]);

面板容器中的默认滑块。

创建一个滑块。设置价值属性到50。

无花果= uifigure;sld = uislider(图,“价值”, 50);

确定当前滑块限制。

= sld的限制。限制
限制= 0 100

改变滑块限制并设置值为35。

道防线。limit = [- 5050];道防线。值= 35;

滑块在一个数字。滑块的范围从-50到50,滑块拇指在35。

创建一个滑块和一个量规。当应用程序用户移动滑块拇指并释放鼠标按钮时,量规的指针反映滑块的值。

保存以下代码sliderValue.m在MATLAB路径上。

这段代码创建了一个包含滑块和量规的窗口。当应用程序用户移动滑动拇指时,ValueChangedFcn回调函数更新测量以反映滑块的值。

函数sliderValue%创建图形窗口和组件无花果= uifigure (“位置”,[100 100 350 275]);cg = uigauge(图,“位置”,[100 100 120 120]);sld = uislider(图,...“位置”,[100 75 120 3],...“ValueChangedFcn”@ (sld,事件)updateGauge (sld, cg));结束%创建ValueChangedFcn回调函数updateGauge cg (sld, cg)。值= sld.Value;结束

运行sliderValue,然后移动滑动拇指。松开鼠标按钮时,圆形量规指针移动到量规上的匹配值。

带有测量和滑动条的应用程序。这两个分量具有相同的量程和值。

创建一个滑块和一个量规。当应用程序用户移动滑块拇指时,量规的指针反映了滑块值的变化。

这段代码创建了一个包含滑块和量规的窗口。当应用程序用户移动滑动拇指时,ValueChangingFcn回调函数更新测量以反映滑块的值。

保存以下代码sliderChanging.m在MATLAB路径上。

函数sliderChanging%创建图形窗口和组件无花果= uifigure (“位置”,[100 100 350 275]);cg = uigauge(图,“位置”,[100 100 120 120]);sld = uislider(图,...“位置”,[100 75 120 3],...“ValueChangingFcn”@ (sld,事件)sliderMoving(事件,cg));结束%创建ValueChangingFcn回调函数sliderMoving cg(事件,cg)。值= event.Value;结束

运行sliderChanging,然后移动滑块。当您移动滑块时,圆形轨距针也会移动,反映滑块的值。

输入参数

全部折叠

父容器,指定为数字使用uifigure函数或其子容器之一:选项卡面板ButtonGroup,或GridLayout.如果没有指定父容器,则MATLAB调用uifigure函数创建一个新的数字作为父容器的对象。

名称-值参数

指定可选的逗号分隔的对名称,值参数。的名字参数名和价值为对应值。的名字必须出现在引号内。可以以任意顺序指定多个名称和值对参数Name1, Value1,…,的家

例子:“限制”,[0 50]指定最小滑块值为0最大滑块值为50

这里列出的属性是可用属性的子集。有关完整列表,请参见滑块的属性

滑块值,指定为数值。属性指定的范围内的数值限制属性值。

数据类型:

最小和最大滑块值,指定为一个双元素数字数组。第一个值必须小于第二个值。

如果你改变限制这样价值属性小于新的下限时,MATLAB设置价值属性设置为新的下限。例如,假设限制属性是100年[0]价值是20。如果限制更改[100],然后用MATLAB设置价值属性到50。

同样的,如果你改变限制这样价值属性大于新的上限时,MATLAB设置价值属性设置为新的上限。

数据类型:

主要标记位置,指定为数值向量或空向量。如果不想显示主要的标记,请将此属性指定为空向量。

标记超出范围的位置限制属性不显示。

MATLAB删除重复的刻度值。但是,如果主刻度落在与小刻度相同的值上,则只显示主刻度。

设置MajorTicks属性集MajorTicksMode财产“手动”

主要标记标签,指定为字符向量、字符串数组或1-D分类数组的单元格数组。如果不想显示标记标签,请将此属性指定为空单元格数组。属性中的对应元素指定空字符向量或空字符串标量MajorTickLabels数组中。如果将此属性指定为类别数组,MATLAB将使用数组中的值,而不是全部类别集合。

如果MajorTickLabels数组的长度不同MajorTicks向量,MATLAB忽略较长数组的额外项。如果有额外的标签,它们将被忽略。如果有额外的勾号,则不显示标签。

设置MajorTickLabels改变了MajorTickLabelsMode价值“手动”

请注意

设置MajorTickLabelsMajorTicksMode“汽车”可能会导致意想不到的结果。要避免这种行为,请设置MajorTicksMode“手动”并手动指定的值MajorTicks之前的设置MajorTickLabels

Value changed callback,指定为以下值之一:

  • 一个处理函数。

  • 单元格数组,其中第一个元素是函数句柄。cell数组中的后续元素是要传递给回调函数的参数。

  • 包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。

当用户将拇指移动到滑块上的不同位置时,执行此回调。如果滑块值以编程方式更改,则回调不会执行。

这个回调函数可以访问关于用户与滑块交互的特定信息。MATLAB将这个信息传递到ValueChangedData对象作为回调函数的第二个参数。在App Designer中,参数被调用事件.可以使用点表示法查询对象属性。例如,事件。PreviousValue返回滑块的前一个值。的ValueChangedData对象不可用于指定为字符向量的回调函数。

控件的属性如下表所示ValueChangedData对象。

财产 价值
价值 滑动条的值在应用程序用户最近与它的交互之后
PreviousValue 滑动条在应用程序用户最近与它交互之前的值
执行回调的组件
EventName “ValueChanged”

有关编写回调的更多信息,请参见在应用程序设计器中编写回调

值改变回调,指定为以下值之一:

  • 一个处理函数。

  • 单元格数组,其中第一个元素是函数句柄。cell数组中的后续元素是要传递给回调函数的参数。

  • 包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。

当用户沿着应用程序中的滑块移动拇指时,这个回调函数会执行价值通过编程方式属性更改。

这个回调可以访问关于用户与滑块交互的特定信息。MATLAB将这个信息传递到ValueChangingData对象作为回调函数的第二个参数。在App Designer中,参数被调用事件.可以使用点表示法查询对象属性。例如,事件。价值返回滑块的当前值。的ValueChangingData对象不可用于指定为字符向量的回调函数。

控件的属性如下表所示ValueChangingData对象。

财产 价值
价值 当应用程序用户与滑块交互时,滑块的当前值
执行回调的组件
EventName “ValueChanging”

价值财产的滑块对象只有在用户释放滑块拇指时才会更新。因此,要在拇指移动时获取值,您的代码必须获取价值财产的ValueChangingData对象。

ValueChangingFcnCallback执行如下:

  • 如果应用程序用户单击滑块值一次。然后回调函数执行一次。例如,如果滑块在1.0,而应用程序用户在1.1处单击,则回调执行一次。

  • 如果应用程序用户点击并拖动滑块到一个新的位置,回调将重复执行。例如,如果滑块的值是1.0,而应用程序用户单击、保持并拖动这个捶打值为10.0,那么回调将执行多次,直到应用程序用户释放拇指。

有关编写回调的更多信息,请参见在应用程序设计器中编写回调

指定为矢量的滑块的位置和大小,不包括标记和标签[左下角宽度高度].该表描述了向量中的每个元素。

元素 描述
从父容器的左内边缘到滑块的左外边缘的距离
父容器的内底边到滑块的外底边的距离
宽度 滑块左右外缘之间的距离
高度 滑块上下外缘之间的距离

所有的测量都以像素为单位。

时,不能更改滑块的高度取向属性值是“水平”.类似地,当滑块的宽度取向属性值是“垂直”

位置值是相对于可拉的区域父容器的。绘制区域是容器边界内的区域,不包括菜单栏或标题等装饰占据的区域。

例子:[100 200 60 60]

另请参阅

功能

属性

介绍了R2016a