Exponenta Banner
exponenta event banner

addDialogControl

Класс: Simulink.dialog.Container
Пакет: Simulink.dialog

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

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

Синтаксис

successIndicator = maskObj.addDialogControl (controlType, controlIdentifier)
successIndicator = maskObj.addDialogControl (имя, значение)

Описание

пример

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

пример

successIndicator = maskObj.addDialogControl(Name,Value) задает аргументы Name и Value для элемента в диалоговом окне маски. Можно указать несколько пар Имя (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'. Если родительский тип элемента управления диалогового окна 'tabcontainer', элемент управления дочерним диалоговым окном должен быть 'tab'.

'Name'

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

'Prompt'

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

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

'Enabled'

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

По умолчанию: 'on'

'Visible'

Параметр, определяющий, является ли элемент управления диалоговым окном скрытым или видимым для пользователя. Это поле доступно для всех типов диалоговых элементов управления.

По умолчанию: 'on'

'Callback'

Контейнер для кода MATLAB ®, который выполняется при редактировании элемента управления диалоговым окном и нажатии кнопки «Применить». Это поле доступно только для типов управления гиперссылками и кнопками.

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

'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

Поддержка