addDialogControl

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

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

Описание

пример

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

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

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

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

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

  • 'panel'

  • 'group'

  • 'tabcontainer'

  • 'tab'

  • 'collapsiblepanel'

  • 'text'

  • 'image'

  • 'hyperlink'

  • 'pushbutton'

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

Аргументы name-value

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

Type

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

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

Name

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

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

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