主要内容

ToggleSwitch属性

控制拨动开关外观和行为

切换开关是指示逻辑状态的UI组件。属性控制切换开关的外观和行为。使用点符号来引用特定的对象和属性。

图= Uifigure;s = UISWitch(图,'切换');s.Items = {'冷','Hot'};

开关

全部展开

值的一个元素项目ItemsData数组。默认情况下,价值是第一个元素项目

指定价值作为一个元素项目将切换移动到与该元素匹配的位置。如果ItemsData难道不是空的吗价值必须设置为元素ItemsData,开关将移动到相关位置。

切换选项,指定为字符向量单元格数组、字符串数组或1——- - - - - -2分类数组。如果你指定一个数组,它必须有两个元素。允许重复元素。如果你指定这个属性为分类数组,MATLAB®使用数组中的值,而不是全部类别。

与每个元素相关的数据项目属性值,指定为1乘2数字数组或1乘2单元格数组。允许重复元素。

例如,如果您设置项目价值{“冻结”、“沸腾”},那么你可以设置ItemsData值对应的温度(摄氏度)[0100].这ItemsData应用程序用户不可见值。

例子:{“一”“两个”}

例子:[10 20]

开关的方向,指定为“垂直”“水平”

字体

全部展开

字体名称,指定为系统支持的字体名称。金宝app默认字体取决于特定的操作系统和语言环境。

如果指定的字体不可用,那么MATLAB将使用运行应用程序的系统中可用的字体之间的最佳匹配。

例子:“天线”

字体大小,指定为正数。测量单位是像素。默认字体大小取决于特定的操作系统和语言环境。

例子:14

字体大小,指定为以下值之一:

  • '普通的'- 由特定字体定义的默认重量

  • “大胆”-较厚的字符轮廓比'普通的'

并非所有字体都有粗体的字体重量。因此,指定粗体的重量可以导致正常的字体重量。

字体角度,指定为'普通的''斜体'.将此属性设置为斜体如果App用户的系统上可用,请选择字体的倾斜版本。

字体颜色,指定为RGB三联网,十六进制颜色代码或表中列出的选项之一。

RGB三联体和十六进制颜色代码在指定自定义颜色时很有用。

  • RGB三联网是一个三元素行向量,其元素指定了红色,绿色和蓝色组件的强度。强度必须在范围内[0,1];例如,[0.4 0.6 0.7]

  • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量(),然后是3个或6个十六进制数字,其范围可以是0.F.这些值不区分大小写。因此,颜色是代码“# FF8800”'#ff8800''#f80', 和'#f80'是等同的。

或者,您可以按名称指定一些常见颜色。此表列出了名为Color选项,等效RGB三元组和十六进制颜色代码。

颜色名称 短名称 RGB三重态 十六进制颜色代码 外貌
'红色的' 'r' [1 0 0] '#ff0000'

'绿色' ‘g’ (0 1 0) '#00ff00'

“蓝” “b” (0 0 1) '#0000ff'

'青色' “c” (0 1 1) “# 00飞行符”

“红色” “米” [1 0 1] “#就”

“黄色” '是' [1 1 0] '#ffff00'

“黑” “k” (0 0 0) # 000000的

'白色的' 'W' [1 1] '#ffffff'

以下是MATLAB在许多类型的绘图中使用的默认颜色的RGB三联体和十六进制颜色代码。

RGB三重态 十六进制颜色代码 外貌
[0 0.4470 0.7410] “# 0072 bd”

[0.8500 0.3250 0.0980] '#d95319'

[0.9290 0.6940 0.1250] '#edb120'

(0.4940 0.1840 0.5560) '#7e2f8e'

[0.4660 0.6740 0.1880] “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

(0.6350 0.0780 0.1840) '#a2142f'

交互性

全部展开

可见性状态,指定为'在'“关闭”,或数字或逻辑1真正的) 要么0.错误的)。价值'在'相当于真正的, 和“关闭”相当于错误的.因此,您可以使用此属性的值作为逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

  • '在'—显示对象。

  • “关闭”- 隐藏对象而不删除它。您仍然可以访问不可见UI组件的属性。

让您的应用程序开始更快,设置可见财产“关闭”对于不需要在启动时显示的所有UI组件。

运营状态,指定为'在'“关闭”,或数字或逻辑1真正的) 要么0.错误的)。价值'在'相当于真正的, 和“关闭”相当于错误的.因此,您可以使用此属性的值作为逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

  • 如果您将此属性设置为'在',应用程序用户可以与组件进行交互。

  • 如果您将此属性设置为“关闭”,该组件显示为暗淡,指示应用程序用户无法与之交互,并且它不会触发回调。

工具提示,指定为字符向量,字符向量单元阵列,字符串数组或1-D分类阵列。使用此属性在运行时筛选组件上的指针时显示一条消息。即使禁用组件,工具提示也会显示。要显示多行文本,请指定字符向量或字符串数​​组的单元格数组。阵列中的每个元素都成为单独的文本行。如果将此属性指定为分类数组,则Matlab使用数组中的值,而不是完整的类别。

上下文菜单,指定为a快捷菜单使用uicontextmenu函数。在组件上单击右键时,使用此属性显示上下文菜单。

位置

全部展开

指定为矢量的开关(不包括状态标记和标签)的位置和大小,[左下角宽度高度].此表描述了向量中的每个元素。

元素 描述
剩下 父容器内部左边缘到开关的外左边缘的距离
从父容器的内底边到开关的外底边的距离
宽度 交换机左右外边缘之间的距离,不包括标签
高度 交换机上、下外缘之间的距离,不包括标签

所有测量均以像素为单位。

位置值是相对于可拉伸区域父容器。可拉伸区域是容器边界内的区域,并且不包括装饰品(例如菜单栏或标题)所占用的区域。

例子:[100 200 40 90

指定为矢量的开关的内部位置和大小(不包括状态标记和标签),[左下角宽度高度].位置值相对于父容器。所有的测量都以像素为单位。该属性值与位置财产。

此属性是只读的。

开关的外部位置和大小,包括状态标记和标签,指定为矢量,[左下角宽度高度].位置值相对于父容器。所有的测量都以像素为单位。

布局选项,指定为gridlayoutoptions.目的。此属性指定网格布局容器的子组件的选项。如果组件不是网格布局容器的子节点(例如,它是图形或面板的子项),则此属性为空,没有效果。但是,如果组件是网格布局容器的子节点,则可以通过设置该组件将组件放置在所需的行和网格列中物业在gridlayoutoptions.目的。

例如,此代码将切换开关放在其父网格的第三行和第二列中。

G = uigridlayout([4 3]);s = uiswitch (g,“切换”);s.layout.row = 3;s.layout.column = 2;

要使切换跨多行或多列,请指定属性作为双元素矢量。例如,此开关跨度列2通过3.

s.Layout.Column = [2 3];

回调

全部展开

值更改回调,指定为其中一个值:

  • 一个处理函数。

  • 其中第一元素是函数手柄的单元阵列。单元格数组中的后续元素是传递给回调函数的参数。

  • 包含有效MATLAB表达式(不推荐)的字符向量。MATLAB在基础工作区中评估此表达式。

当switch的状态在app中改变时,这个回调函数就会执行。当用户做了以下任何一件事时,switch的状态就会改变:

  • 点击并释放开关上任何位置的鼠标按钮(包括状态标签)

  • 单击交换机,拖动,然后在交换机上释放鼠标按钮。

回调不执行价值通过编程方式属性更改。

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

下表列出了该属性ValueChangedData目的。

财产 价值
价值 应用程序用户最近一次与之交互后的开关值
PreviousValue 交换机的价值在应用程序用户最近的与它交互之前
执行回调的组件
eventname. “ValueChanged”

有关写回调的更多信息,请参阅在App Designer中写回调

对象创建函数,指定为以下值之一:

  • 功能手柄。

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

  • 字符向量包含有效的MATLAB表达式(不推荐)。MATLAB在基础工作区中评估此表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见在App Designer中写回调

此属性指定MATLAB创建对象时要执行的回调函数。MATLAB在执行之前初始化所有属性值CreateFcn回调。如果您没有指定CreateFcn属性,然后MATLAB执行一个默认创建函数。

设置CreateFcn属性对现有组件没有影响。

如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问正在创建的对象。否则,使用gcbo函数访问对象。

对象删除函数,指定为其中一个值:

  • 功能手柄。

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

  • 字符向量包含有效的MATLAB表达式(不推荐)。MATLAB在基础工作区中评估此表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见在App Designer中写回调

此属性指定MATLAB删除对象时要执行的回调函数。Matlab执行了DeleteFcn销毁对象属性之前的回调。如果您没有指定DeleteFcn属性,然后MATLAB执行一个默认删除函数。

如果将此属性指定为函数句柄或单元格数组,则可以访问使用回调函数的第一个参数删除的对象。否则,使用gcbo函数访问对象。

回调执行控制

全部展开

回调中断,指定为'在'“关闭”,或数字或逻辑1真正的) 要么0.错误的)。价值'在'相当于真正的, 和“关闭”相当于错误的.因此,您可以使用此属性的值作为逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

此属性确定是否可以中断运行回调。有两个回调状态需要考虑:

  • 运行Callback是当前正在执行的回调。

  • 打断Callback是一个试图中断正在运行的回调的回调。

每当MATLAB调用回调时,该回调尝试中断正在运行的回调(如果存在的话)。这中断拥有运行回调的对象的属性确定是否允许中断。

  • 价值'在'允许其他回调来中断对象的回调。中断发生在MATLAB处理队列的下一个点,例如当有drawn数字uifiguregetframe等待,或暂停命令。

    • 如果运行回调包含其中一个命令,则Matlab在该点处停止执行回调并执行中断回调。MATLAB在中断回调完成时执行运行回调。

    • 如果运行回调不包含其中一个命令,则matlab完成在不中断的情况下执行回调。

  • 价值“关闭”阻止所有中断尝试。这忙碌拥有中断回调的对象的属性确定中断呼叫是否被丢弃或放入队列中。

笔记

在这些情况下,回调中断和执行的行为是不同的:

  • 如果中断回调为DeleteFcnCloseRequestFcnSizechangedFCN.回调,那么无论的内容都会发生中断中断属性值。

  • 如果正在运行的回调函数正在执行等待函数,则不管中断属性值。

  • 计时器对象根据调度执行,而不管中断属性值。

当中断发生时,MATLAB不保存属性或显示的状态。方法返回的对象gcagcf当另一个回调执行时,命令可能会更改。

标准队列,指定为“队列”“取消”.这忙碌属性确定MATLAB如何处理中断回调的执行。有两个回调状态需要考虑:

  • 运行Callback是当前正在执行的回调。

  • 打断Callback是一个试图中断正在运行的回调的回调。

每当MATLAB调用回调时,回调尝试中断运行的回调。这中断属性决定是否允许中断。如果不允许中断,那么忙碌拥有中断回调的对象的属性确定是否丢弃或放入队列中。这些是可能的值忙碌属性:

  • “队列”—将中断回调放入正在运行的回调执行完成后待处理的队列中。

  • “取消”- 不执行中断回调。

此属性是只读的。

删除状态,返回类型类型的开/关逻辑值matlab.lang.OnOffSwitchState

Matlab设置了BeingDeleted财产'在'DeleteFcn回调函数开始执行。这BeingDeleted财产仍然存在'在'直到组件对象不再存在。

检查该值BeingDeleted属性验证在查询或修改之前未删除对象是否即将删除。

父/子

全部展开

父容器,指定为a数字使用uifigure函数或其子容器之一:选项卡控制板ButtonGroup,或网格布局.如果没有指定容器,Matlab会调用uifigure创建新的功能数字作为父容器的对象。

指定的对象句柄的可见性'在''打回来',或“关闭”

此属性控制其父母的子项列表中对象的可见性。当对象在其父子节目列表中不可见时,它不会通过搜索对象层次结构或查询属性来获取对象的函数返回。这些功能包括得到findobjCLF., 和.对象即使不可见也是有效的。如果你可以访问一个对象,你可以设置和获取它的属性,并将它传递给任何操作对象的函数。

HandleVisibility价值 描述
'在' 物体总是可见的。
'打回来' 从回调或通过回调调用的函数中可以看到该对象,但不是从命令行调用的函数中。此选项会阻止在命令行处访问对象,但允许回调函数访问它。
“关闭” 物体在任何时候都是看不见的。这个选项对于防止其他函数对UI的意外更改非常有用。设置HandleVisibility“关闭”在执行该函数期间临时隐藏对象。

身份标识

全部展开

此属性是只读的。

图形对象类型,返回为“uitoggleswitch”

对象标识符,指定为字符向量或字符串标量。你可以指定一个唯一的标签值作为对象的标识符。当您需要访问代码中的其他地方的对象时,可以使用findobj基于的功能搜索对象标签价值。

用户数据,指定为任何MATLAB数组。例如,可以指定标量、向量、矩阵、单元格数组、字符数组、表或结构。使用此属性可在对象上存储任意数据。

如果你在应用程序设计器中工作,在应用程序中创建公共或私有属性来共享数据,而不是使用用户数据财产。有关更多信息,请参见在应用程序设计器应用程序中共享数据

也可以看看

功能

在R2016A介绍