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'. Если родительским диалоговым типом управления является 'tabcontainer', дочерним диалоговым управлением должен быть 'tab'.

Имя

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

'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

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