addDialogControl

Класс: Simulink.dialog.Container
Пакет: 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'

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

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

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

Type

Тип управления, которое используется, чтобы задать значение этого диалогового элемента управления. Тип является обязательным аргументом. Разрешенными значениями является 'panel', 'group', 'tabcontainer', 'tab', 'collapsiblepanel'Текстизображение, '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_1'); 
maskLink.Prompt = 'Mathworks Home Page';
maskLink.Callback = 'web(''www.mathworks.com'')'

% Alternative method to add hyperlink

maskLink = maskObj.addDialogControl('hyperlink','link_2'); 
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

Поддержка

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