addDialogControl

Класс: Simulink.dialog. Контейнер
Пакет: Simulink.dialog

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

расширьте все на странице

Синтаксис

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

Описание

пример

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

пример

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

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

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

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

  • 'panel'

  • 'group'

  • 'tabcontainer'

  • 'tab'

  • 'collapsiblepanel'

  • 'text'

  • 'image'

  • 'hyperlink'

  • 'pushbutton'

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

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

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

'Type'

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

'Name'

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

'Prompt'

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

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

'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

Документация Simulink
Поддержка
Для просмотра документации необходимо авторизоваться на сайте