addDialogControl

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

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

Описание

пример

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

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

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

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

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

  • 'panel'

  • 'group'

  • 'tabcontainer'

  • 'tab'

  • 'collapsiblepanel'

  • 'text'

  • 'image'

  • 'hyperlink'

  • 'pushbutton'

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

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

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

'Type'

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

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

'Name'

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

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

'Prompt'

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

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

'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