Exponenta Banner
exponenta event banner

addDialogControl

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

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

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

Синтаксис

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'.

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

'Name'

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

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

'Prompt'

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

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

'Tooltip'

Подсказка для элемента управления диалоговым окном.

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

'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'); 
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

Поддержка