Добавьте новую установку
s = addSetting(
добавляет новая установка на заданную родительскую группу настроек и возвращает parentgroup
,name
)Setting
объект, содержащий новую установку. По умолчанию настройки не скрыты, что означает, что они отображаются в родительской группе настроек.
s = addSetting(___,
задает свойства установки с помощью одного или нескольких аргументов пары "имя-значение". Например, Name,Value
)'PersonalValue',10
добавляет новая установка с личностной ценностью 10
. Задайте пары "имя-значение" после всех других входных параметров.
Создайте группу настроек и добавьте новую установку на группу. Затем используйте значение установки в вашем коде.
Создайте группу настроек mysettings
.
s = settings;
addGroup(s,'mysettings');
Добавьте установку MyWorkAddress
к mysettings
и дайте ему значение.
addSetting(s.mysettings,'MyWorkAddress'); s.mysettings.MyWorkAddress.PersonalValue = '3 Apple Hill Drive'; s.mysettings.MyWorkAddress
ans = Setting 'mysettings.MyWorkAddress' with properties: ActiveValue: '3 Apple Hill Drive' TemporaryValue: <no value> PersonalValue: '3 Apple Hill Drive' FactoryValue: <no value>
Отобразите значение установки.
fprintf("I work at %s.\n", s.mysettings.MyWorkAddress.ActiveValue)
I work at 3 Apple Hill Drive.
Используйте settings
функционируйте, чтобы получить доступ к корню дерева настроек. Затем создайте группу настроек, добавьте новую скрытую установку на группу и используйте значение установки в вашем коде.
Создайте скрытую группу настроек myhiddensettings
.
s = settings; newHiddenGroup = addGroup(s,'myhiddensettings','Hidden',true);
Добавьте установку MyHiddenWorkAddress
к myhiddensettings
и дайте ему значение. Заметьте, что новая установка не появляется, когда вы отображаете родительскую группу настроек.
addSetting(newHiddenGroup,'MyHiddenWorkAddress','Hidden',true, ... 'PersonalValue','1 Lakeside Campus Drive'); s.myhiddensettings
ans = SettingsGroup 'myhiddensettings' with no properties.
Отобразите значение скрытой установки.
fprintf("I work at %s.\n", newHiddenGroup.MyHiddenWorkAddress.ActiveValue)
I work at 1 Lakeside Campus Drive.
Создайте установку и задайте функцию, чтобы подтвердить ее значение.
Во-первых, создайте функцию валидации numericValidationFcn
это выдает ошибку, когда вход не является числовым.
function numericValidationFcn(x) errorMsg = 'Value must be numeric.'; assert(isnumeric(x),errorMsg); end
Создайте группу настроек mysettings
.
s = settings;
addGroup(s,'mysettings');
Добавьте установку MyNumericSetting
к mysettings
и задайте функцию валидации numericValidationFcn
.
addSetting(s.mysettings,'MyNumericSetting','ValidationFcn',@numericValidationFcn);
Теперь протестируйте, работает ли функция валидации. Установите значение MyNumericSetting
к нечисловому значению. Как ожидалось MATLAB® выдает ошибку.
s.mysettings.MyNumericSetting.PersonalValue = 'Hello';
Unable to validate settings data. Error using numericValidationFcn (line 3) Value must be numeric.
parentgroup
— Родительская группа настроекSettingsGroup
объектРодительская группа настроек, чтобы добавить установку на, заданный как SettingsGroup
объект. Используйте settings
функционируйте, чтобы получить доступ к корневому групповому объекту настроек и всем доступным группам настроек.
name
— Имя установки, чтобы добавитьИмя установки, чтобы добавить, заданный как вектор символов или представить скаляр в виде строки. Если name
уже существует в заданной группе настроек, MATLAB выдает ошибку.
Задайте дополнительные разделенные запятой пары Name,Value
аргументы. Name
имя аргумента и Value
соответствующее значение. Name
должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN
.
addSetting(a,'mySetting','PersonalValue',10,'Hidden',true)
добавляет новая скрытая установка с личностной ценностью 10
заданной родительской группе настроек.'PersonalValue'
— Личностная ценность установкиЛичностная ценность установки, заданной как данные MATLAB любого типа за исключением типов указателя. Контейнеры данных, такие как массивы ячеек, структуры и объекты, которые включают указатели, также не поддержаны. Этот аргумент требуется при создании настроек только для чтения.
'Hidden'
— Скрытое состояниеfalse
(значение по умолчанию) | true
Скрытое состояние, заданное как true
или false
.
Когда установлено в true
, группы настроек и настройки в группе не отображаются, несмотря на то, что они остаются доступными.
'ReadOnly'
— Состояние только для чтенияfalse
(значение по умолчанию) | true
Состояние только для чтения, заданное как true
или false
. Когда true
, личностная или временная ценность установки не может быть изменена. PersonalValue
аргумент требуется при создании настроек только для чтения.
'ValidationFcn'
— Функция, чтобы подтвердить установкуФункция, чтобы подтвердить установку, определенный функцией указатель. Когда задано, функция используется, чтобы подтвердить значение установки.
Указатель на функцию должен быть сопоставлен с функцией, которая принимает потенциальное устанавливающее значение как входной параметр, не имеет никаких выходных аргументов и выдает ошибку, если валидация перестала работать.
Указатель на функцию должен указать на функцию на пути MATLAB. Указатели анонимной или вложенной функции не поддержаны.
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.