主要内容

组属性

将对象外观和行为分组

集团对象属性控制的行为集团对象。属性的某些方面可以通过更改属性值来修改集团对象。使用点表示法来查询和设置属性。

g = hggroup;c = g.Children;g.Visible =“关闭”;

传说

全部展开

图例标签,指定为字符向量或字符串标量。方法调用之前,图例不会显示传说命令。如果不指定文本,则传说使用表单设置标签“dataN”

此属性是只读的。

控件,用于从图例中包含或排除对象,该对象作为注释对象。设置底层IconDisplayStyle属性设置为以下值之一:

  • “上”-在图例中包含该对象。

  • “关闭”-图例中不包含该对象。(默认)

  • “孩子”-在图例中包含对象的唯一子对象作为单独的项目。

交互性

全部展开

可见性、指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).的值“上”相当于真正的,“关闭”相当于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

  • “上”—显示所有对象集团对象。

  • “关闭”-隐藏所有对象在集团对象。你仍然可以访问无形的属性集团对象。设置可见财产集团对象不会更改可见属性中的对象集团对象。

上下文菜单,指定为快捷菜单对象。使用此属性可在右键单击对象时显示上下文菜单。方法创建上下文菜单uicontextmenu函数。

请注意

如果PickableParts属性设置为“没有”或者如果HitTest属性设置为“关闭”,则不会出现上下文菜单。

选择状态,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).的值“上”等于true,和“关闭”相当于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

  • “上”——选择。如果在绘图编辑模式下单击对象,则MATLAB®设置它选择财产“上”.如果SelectionHighlight属性也设置为“上”,然后MATLAB在对象周围显示选择句柄。

  • “关闭”——而不是选择。

选中时显示选择句柄,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).的值“上”等于true,和“关闭”相当于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

  • “上”-显示选择处理时选择属性设置为“上”

  • “关闭”-从不显示选择句柄,即使当选择属性设置为“上”

回调

全部展开

鼠标点击回调,指定为以下值之一:

  • 函数处理

  • 包含函数句柄和附加参数的单元格数组

  • 字符向量,是有效的MATLAB命令或函数,在基本工作区中求值(不推荐)

在单击对象时,使用此属性执行代码。如果使用函数句柄指定此属性,那么MATLAB在执行回调函数时将传递两个参数给回调函数:

  • 被点击对象——从回调函数内部访问被点击对象的属性。

  • 事件数据-空参数。用波浪号字符(),以指示此参数未被使用。

有关如何使用函数句柄定义回调函数的更多信息,请参见回调函数定义

请注意

如果PickableParts属性设置为“没有”或者如果HitTest属性设置为“关闭”,则不执行此回调。

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

  • 函数处理。

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

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

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

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

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

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

对象删除函数,指定为以下值之一:

  • 函数处理。

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

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

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

此属性指定在MATLAB删除对象时执行的回调函数。MATLAB执行DeleteFcn在销毁对象的属性之前调用。如果不指定DeleteFcn属性,然后MATLAB执行一个默认删除函数。

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

回调执行控制

全部展开

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

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

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

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

每当MATLAB调用回调时,该回调将试图中断正在运行的回调(如果存在的话)。的可中断属性的属性确定是否允许中断。

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

    • 如果正在运行的回调包含这些命令中的一个,那么MATLAB将在该点停止回调的执行,并执行中断回调。当中断回调完成时,MATLAB继续执行正在运行的回调。

    • 如果正在运行的回调不包含这些命令中的任何一个,那么MATLAB将不中断地完成回调的执行。

  • 的值“关闭”阻塞所有中断尝试。的BusyAction属性的属性确定中断回调是被丢弃还是放入队列中。

请注意

回调中断和执行在以下情况下表现不同:

  • 如果中断回调函数是DeleteFcnCloseRequestFcnSizeChangedFcn回调函数,则中断发生而不管可中断属性值。

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

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

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

回调队列,指定为“队列”“取消”.的BusyAction属性决定了MATLAB如何处理中断回调的执行。有两种回调状态需要考虑:

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

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

每当MATLAB调用回调时,该回调将试图中断正在运行的回调。的可中断属性的属性确定是否允许中断。如果不允许中断,则BusyAction属性的属性确定是丢弃该中断回调还是将其放入队列中。这些是可能的值BusyAction属性:

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

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

可以捕获鼠标点击的子节点,指定为以下值之一:

  • “可见”-任何子对象都可以捕获鼠标单击,这取决于PickableParts子对象的属性值。

  • “没有”-没有子对象可以捕获鼠标单击,无论PickableParts子对象的属性值。

对子节点捕获的鼠标单击的响应,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).的值“上”相当于真正的,“关闭”相当于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

  • “上”——触发ButtonDownFcn回调的集团对象。如果您已经定义了UIContextMenu属性,然后调用上下文菜单。

  • “关闭”的回调函数集团对象。相反,为最近的祖先触发回调HitTest属性设置为“上”和一个PickableParts属性值,该值使祖先能够捕获鼠标单击。

一个集团对象无法捕获鼠标单击。的子元素集团对象,如果子对象具有HitTest属性设置为“关闭”,然后子进程将单击传递给集团对象。

此属性是只读的。

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

MATLAB设置BeingDeleted财产“上”DeleteFcn回调函数开始执行。的BeingDeleted物业仍设为“上”直到组件对象不再存在。

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

父/子

全部展开

父类,指定为集团,或变换对象。

子对象,作为图形对象数组返回。使用此属性可查看子元素列表,或通过将该属性设置为自身的排列来对子元素进行重新排序。

方法无法添加或删除子节点孩子们财产。若要向此列表添加子对象,请设置属性的子图形对象的集团对象。

对象句柄的可见性孩子们属性,指定为以下值之一:

  • “上”-对象句柄始终可见。

  • “关闭”对象句柄在任何时候都是不可见的。此选项用于防止另一个函数的意外更改。设置HandleVisibility“关闭”在函数执行期间临时隐藏句柄。

  • “回调”对象句柄在回调函数或回调函数调用的函数中可见,但在从命令行调用的函数中不可见。该选项阻止在命令行访问对象,但允许回调函数访问它。

中未列出的对象孩子们属性,则通过搜索对象层次结构或查询句柄属性获得对象句柄的函数不能返回该属性。此类函数的示例包括得到findobjgcagcfgconewplotclf,关闭功能。

隐藏对象句柄仍然有效。设置根ShowHiddenHandles财产“上”列出所有对象句柄,而不管它们HandleVisibility属性设置。

标识符

全部展开

此属性是只读的。

图形对象的类型,返回为“hggroup”.使用此属性可在绘图层次结构中查找给定类型的所有对象,例如,搜索使用的类型findobj

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

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

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

兼容性的考虑

全部展开

不建议从R2020a开始

之前介绍过的R2006a