配置自定义UI组件应用程序设计师
从R2021a开始,当你创建一个定制的UI组件,您可以配置您的组件为应用程序的开发者在应用程序中使用交互设计师。在您配置您的UI组件之后,应用程序的开发者可以将组件添加到组件库可以在应用程序与组件交互设计师帆布在属性检查器。
按照以下配置步骤如果您已经创建了一个自定义UI组件,交互的应用程序设计或编程的一个子类matlab.ui.componentcontainer.ComponentContainer基类,你想用这两种方式:
访问您的UI组件的应用程序设计师组件库和交互地使用它来创建一个应用程序设计应用程序。
分享你的UI组件供其他人使用交互式地创建应用程序设计师。
有关创建一个自定义UI组件的更多的信息,见:
创建一个简单的自定义UI组件在应用程序设计师创建一个组件交互
开发自定义UI组件编程以编程方式创建一个组件
自定义UI组件的先决条件
允许您定制的UI组件交互地使用在应用程序设计师,有一些UI组件类必须满足要求。
成功地配置您的UI组件,设置UI组件类的方法不需要输入参数。同时,组件类不能动态添加额外的UI组件的父容器。唯一的例外是,类可以动态地添加一个快捷菜单组件在父图。
公共财产的组件类出现在属性检查器,您必须指定其类型或指定一个默认值。如果房地产是一个枚举,你必须这两个指定其类型并为其分配一个默认值。另外,属性类型必须属于类型的列表支持应用程序设计师。金宝app此表显示了允许属性在属性检查器类型和外表。
| 属性分类 | 金宝app支持的数据类型 | 属性检查器输入 |
|---|---|---|
| 数值 | 标量、数组的类型单,双,int8,int16,int32,int64,uint8,uint16,uint32,或uint64 |
编辑字段 |
| 逻辑 | 逻辑 |
复选框 |
| 文本 | 标量类型的字符串、标量或行向量类型字符和标量或矢量的类型细胞 |
文本区域 |
| 枚举 | 枚举 |
可编辑下拉列表 |
更多信息在指定属性类型和指定默认值,见:
创建公共属性自定义UI组件在应用程序设计师为组件创建交互式地
通过编程方式管理属性的自定义UI组件以编程方式创建的组件
配置自定义UI组件
您配置您的自定义UI组件的方式用于应用程序设计师取决于您创建应用程序的组件交互设计师或编程方式的一个子类ComponentContainer基类。
组件中创建应用程序设计师——打开组件在应用程序设计师。在文件部分的设计师选项卡上,单击
配置。另外,所谓的
appdesigner.customcomponent.configureMetadata从MATLAB函数®命令窗口并将其传递给组件MLAPP文件路径。以编程方式创建的组件调用
appdesigner.customcomponent.configureMetadata从MATLAB函数命令窗口并将其传递给您的组件类文件的路径。例如,配置保存为自定义UI组件
ColorSelector.m在文件夹C: \ MyComponents使用此命令:appdesigner.customcomponent.configureMetadata (“C: \ MyComponents \ ColorSelector.m”);
以下步骤打开应用程序设计师自定义UI组件的元数据对话框。这个对话框允许您指定关于组件的元数据。程序设计师使用这种元数据来显示的组件组件库。
对话框预填充所有必需的组件类的元数据的定义。您可以编辑元数据使用填充表单。选择好吧配置UI组件。
在您选择好吧函数创建一个文件夹命名资源为您的自定义组件文件在同一文件夹。在资源文件夹,命名函数生成一个文件appDesigner.json。这个文件包含的元数据提供的对话框中,除了其他元数据MATLAB需要提供您的组件在应用程序设计师。
请注意
不修改appDesigner.json文件用手。改变任何自定义UI组件的元数据,重新配置组件。
视图配置的UI组件在应用程序设计师
在配置您的自定义UI组件之后,您可以查看和使用它的应用程序设计师。对于UI组件出现在应用程序设计师组件库,您必须添加包含组件的文件夹文件并生成资源文件夹到MATLAB路径。
例如,如果您创建一个ColorSelector自定义组件,将其保存到一个文件夹命名MyComponents,配置应用程序设计师的元数据,按照以下步骤使用的组件应用程序设计师:
添加
MyComponents文件夹到MATLAB路径遵循的步骤改变文件夹搜索路径。打开应用程序设计师和选择空白应用程序。
从拖动组件组件库到应用程序设计师画布。
组件的属性检查器列表组件的公共属性和回调。
请注意
避免更改自定义组件文件同时使用一个应用程序中的组件设计应用程序,这样做可能会导致错误或意想不到的行为。
配置自定义UI组件
重新配置一个先前配置的UI组件时:
你想改变现有的UI组件的元数据和更新的组件是如何显示在应用程序设计师组件库。
你已经更改UI组件位置或在你的类定义布局。
重新配置您的UI组件,在遵循相同的步骤配置自定义UI组件部分。应用程序设计师自定义UI组件的元数据与现有元数据填充对话框打开。
更新元数据,然后选择好吧。
回到应用程序设计师。组件出现在组件库与更新的配置选项。
将UI组件从应用程序设计师
删除自定义UI组件的应用程序设计师组件库,可以使用appdesigner.customcomponent.removeMetadata函数。
调用这个函数通过您的组件文件的路径。该函数删除的UI组件的元数据appDesigner.json文件里面的资源文件夹,删除的组件应用程序设计师组件库。
appdesigner.customcomponent.removeMetadata (“C: \ MyComponents \ ColorSelector.m”);
后删除应用程序设计师自定义UI组件的元数据,任何应用程序设计师应用程序使用它不正确加载。继续编辑应用程序,它使用UI组件,重新配置组件在你打开应用程序。
分享UI组件配置
配置一个UI组件之后,可以分享他人使用的组件应用程序设计师。你可以直接分享相关的文件或包组件作为一个工具箱。在这两种情况下,你必须分享生成的资源文件夹中。
直接分享UI组件文件
直接与用户共享一个UI组件配置,创建并共享一个文件夹与这些内容:
UI组件类文件
生成的
资源文件夹
指导用户与你共享UI组件共享文件夹添加到MATLAB路径。
包UI组件工具箱
包你的UI组件工具箱遵循的步骤创建和共享工具箱。确保你的文件夹在包工具箱有这些内容:
UI组件类文件
生成的
资源文件夹
你可以分享由此产生.mltbx直接与您的用户文件。要安装它,他们必须双击.mltbx在MATLAB文件当前文件夹浏览器。
或者,你可以分享你的UI组件作为一个附加的上传.mltbx文件以MATLAB中央文件交换。您的用户可以找到并安装您的附加组件从MATLAB将来发布执行这些步骤:
在MATLAB将来发布,家选项卡,环境部分中,选择附加组件
。找到的插件浏览可用的类别扩展浏览器窗口的左边。另外,使用搜索栏搜索使用关键字一个插件。
单击附加开放的详细信息页面。
在信息页面,点击添加安装插件。
解决缺少定制的UI组件
打开一个应用程序,其中包含一个定制的UI组件,该组件文件并生成资源文件夹必须在MATLAB的道路。如果应用程序设计师不能加载自定义UI组件,它将显示一个警告对话框,当应用程序被打开。如果你遇到这个对话框打开一个应用程序时,按照以下步骤负载丢失的组件:
确保文件和生成的UI组件
资源文件夹与组件的元数据都在一个文件夹中。添加文件和文件夹包含组件
资源文件夹到MATLAB路径遵循的步骤改变文件夹搜索路径。重启应用程序,其中包含定制的UI组件。现在应当装入应用程序和组件。
