Main Content

Setting

表示单个设置

全页展开

说明

一个 Setting 对象表示设置层次结构树中的单个设置。

创建对象

使用由 settings 函数返回的根 SettingsGroup 对象访问各个 Setting 对象。例如，以下代码访问 MaxWidth 设置。

s = settings
s.matlab.editor.language.matlab.comments.MaxWidth

属性

全部展开

当前或活动设置值，指定为除句柄类型外的任何类型的 MATLAB 数据。也不支持包含句柄的数据容器，如元胞数组、结构体和对象。

活动值按如下方法确定：

  • 如果该设置具有临时值，则活动值是临时值。

  • 如果设置没有临时值，但具有个人值，则活动值是个人值。

  • 如果设置没有临时值或个人值，但有安装值，则活动值为安装值。

  • 如果设置没有临时值、个人值或安装值，则活动值为出厂值。

例如，假设您的一个 MySetting 设置具有以下值：

  • 临时值：12

  • 个人值：无值

  • 安装值：无值

  • 出厂值：10

在这种情况下，MySetting 的活动值是临时值 12。

临时设置值，指定为除句柄类型外的任何类型的 MATLAB 数据。也不支持包含句柄的数据容器，如元胞数组、结构体和对象。

临时值仅适用于当前 MATLAB 会话，并在会话结束时清除。

某些设置会链接到一个预设项。如果某项设置链接到了预设项，则更改该设置的临时值会临时更改对应的预设项。在 MATLAB 会话结束时，预设项会恢复为其原始值。有关预设项的详细信息，请参阅预设项。

个人设置值，指定为除句柄类型外的任何类型的 MATLAB 数据。也不支持包含句柄的数据容器，如元胞数组、结构体和对象。

个人用户的个人值在多个 MATLAB 会话之间保持一致。该值在修改后将保存到预设文件夹。

某些设置会链接到一个预设项。如果某项设置与预设项相关联，则更改该设置的个人值也会更改对应的预设项。有关预设项的详细信息，请参阅预设项。

安装设置值，指定为除句柄类型外的任何类型的 MATLAB 数据。也不支持包含句柄的数据容器，如元胞数组、结构体和对象。

安装值可从给定的 MATLAB 安装中获得。该值在修改后将保存到 MATLAB 根目录。该值在所有会话中保持不变，但在升级到新版本的 MATLAB 时不会迁移。

某些设置会链接到一个预设项。如果设置与预设项相关联，并且更改安装值会更改活动值，则该设置会同时更改对应的预设项。有关预设项的详细信息，请参阅预设项。

此 属性 为只读。

出厂设置值，指定为除句柄类型外的任何类型的 MATLAB 数据。也不支持包含句柄的数据容器，如元胞数组、结构体和对象。

出厂值是默认的产品设置。它不可修改。此外，您不能指定自定义设置的出厂值。

对象函数

clearTemporaryValue清除设置的临时值
clearPersonalValue清除设置的个人值
clearInstallationValueClear installation value for setting
hasTemporaryValue确定设置是否设置了临时值
hasPersonalValue确定设置是否设置了个人值
hasInstallationValue Determine whether setting has installation value set
hasFactoryValue确定设置是否设置了出厂值

示例

全部折叠

在编辑器中查看注释的最大列宽的当前值。

s = settings;
s.matlab.editor.language.matlab.comments.MaxWidth
ans = 
 Setting 'matlab.editor.language.matlab.comments.MaxWidth' with properties.

       ActiveValue: 80
    TemporaryValue: 80
     PersonalValue: <no value>
 InstallationValue: <no value>
      FactoryValue: 75

获取并设置 MATLAB 中注释的最大列宽值。

获取根 SettingsGroup 对象，并查看 MATLAB 中注释的最大列宽的活动值。

s = settings;
s.matlab.editor.language.matlab.comments.MaxWidth.ActiveValue
ans =
  int32
   75

设置 MATLAB 中注释的最大列宽的临时值。

s.matlab.editor.language.matlab.comments.MaxWidth.TemporaryValue = 80;
s.matlab.editor.language.matlab.comments.MaxWidth.ActiveValue
ans =
  int32
   80

版本历史记录

在 R2018a 中推出

另请参阅

|

主题