addDialogControl

Класс: Simulink. Маска
Пакет: Simulink

Добавьте диалоговые элементы управления, чтобы замаскировать диалоговое окно

Синтаксис

successIndicator = maskObj.addDialogControl(controlType,controlIdentifier)
successIndicator = maskObj.addDialogControl(Name,Value)

Описание

пример

successIndicator = maskObj.addDialogControl(controlType,controlIdentifier) добавляет диалоговые элементы управления как текст, гиперссылки, или переходит в диалоговое окно маски. Сначала получите маскирующий объект и присвойте его переменному maskObj

successIndicator = maskObj.addDialogControl(Name,Value) задает аргументы Name и Value для элемента на диалоговом окне маски. Можно задать несколько Пар "имя-значение".

Входные параметры

развернуть все

Тип диалогового элемента управления, заданного

  • Панель

  • 'group'

  • 'tabcontainer'

  • 'tab'

  • 'collapsiblepanel'

  • Текст

  • изображение

  • 'hyperlink'

  • Кнопка

Задает программируемый идентификатор для элемента диалогового окна маски. Используйте имя, которое уникально и не имеет пробела между словами. Для получения дополнительной информации смотрите Имена переменных (MATLAB).

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Имя должно появиться в одинарных кавычках ('') и является чувствительным к регистру. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Ввод

Тип управления, которое используется, чтобы задать значение этого диалогового элемента управления. Тип является обязательным аргументом. Разрешенными значениями является 'panel', 'group', 'tabcontainer', 'tab', 'collapsiblepanel', 'text', 'image', 'hyperlink' и 'pushbutton'.

Значение по умолчанию: пустой

Имя

Идентификатор диалогового элемента управления. Имя является обязательным аргументом. Это поле доступно для всех диалоговых типов управления.

Значение по умолчанию: пустой

'Prompt'

Текст, который отображен в диалоговом элементе управления на диалоговом окне Mask. Это поле доступно для всех за исключением панели и диалоговых типов управления изображений.

Значение по умолчанию: пустой

'Tooltip'

Подсказка для диалогового элемента управления.

Значение по умолчанию: пустой

'Enabled'

Опция, чтобы задать, можно ли установить значение для диалогового элемента управления. Это поле доступно для всех диалоговых типов управления.

Значение по умолчанию: 'on'

'Visible'

Опция, чтобы установить, скрыт ли диалоговый элемент управления или видим пользователю. Это поле доступно для всех диалоговых типов управления.

Значение по умолчанию: 'on'

'callback'

Контейнер для кода MATLAB®, который выполняется, когда вы редактируете диалоговый элемент управления и нажимаете Apply. Это поле доступно только для гиперссылки и диалоговых типов управления кнопкой.

Значение по умолчанию: пустой

'Row'

Опция, чтобы установить, помещается ли диалоговое управление в новую строку или ту же строку. Это поле доступно для всех диалоговых типов управления.

Значение по умолчанию: пустой

filepath

Содержит путь к файлу изображения. Это поле доступно для изображения и диалоговых типов управления кнопкой.

Значение по умолчанию: пустой

'Container'

Опция к задает контейнер для дочернего диалогового управления. Разрешенные значения являются именами 'panel', 'group' и диалоговых средств управления 'tab'.

Примеры

развернуть все

Получите маскирующий объект и добавьте диалоговый элемент управления к нему.

% Get mask object on model Engine

maskObj = Simulink.Mask.get('Engine/Gain');

% Add hyperlink to mask dialog box

maskLink = maskObj.addDialogControl('hyperlink','link'); 
maskLink.Prompt = 'Mathworks Home Page';
maskLink.Callback = 'web(''www.mathworks.com'')'

% Alternative method to add hyperlink

maskLink = maskObj.addDialogControl('hyperlink','link'); 
maskLink.Prompt = 'www.mathworks.com';

% Add text to mask dialog box

maskText = maskObj.addDialogControl('text','text_tag'); 
maskText.Prompt = 'Enable range checking';

% Add button to mask dialog box

maskButton = maskObj.addDialogControl('pushbutton','button_tag'); 
maskButton.Prompt = 'Compute';

Создайте вкладки на диалоговом окне маски и добавьте элементы к этим вкладкам.

% Get mask object on a block named 'GainBlock'

maskObj = Simulink.Mask.get('GainBlock/Gain');

% Create a tab container

maskObj.addDialogControl('tabcontainer','allTabs');
tabs = maskObj.getDialogControl('allTabs');

% Create tabs and name them

maskTab1 = tabs.addDialogControl('tab','First');
maskTab1.Prompt = 'First tab';

maskTab2 = tabs.addDialogControl('tab','Second');
maskTab2.Prompt = 'Second tab';

% Add elements to one of the tabs

firstTab = tabs.getDialogControl('First');
firstTab.addDialogControl('text','textOnFirst');
firstTab.getDialogControl('textOnFirst').Prompt = 'Tab one';

Добавьте диалоговый элемент управления и задайте значения для него

% Get mask object on model Engine

maskObj = Simulink.Mask.get('Engine/Gain');

% Add a dialog box and specify values for it

maskDialog = maskObj.addDialogControl('Type','text',...
'Prompt','hello','Visible','off');

Введенный в R2014a

Была ли эта тема полезной?