Запись обратных вызовов в App Designer

Примечание

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

Коллбэк является функцией, которая выполняется, когда пользователь взаимодействует с компонентом пользовательского интерфейса в вашем приложении. Большинство компонентов может иметь по крайней мере один коллбэк. Однако некоторые компоненты, такие как метки и лампы, не имеют коллбэков, потому что те компоненты только отображают информацию.

Чтобы видеть список коллбэков, которые поддерживает компонент, выберите компонент и кликните по вкладке Callbacks в Component Browser.

Создание функции обратного вызова

Существует несколько способов создать коллбэк для компонента пользовательского интерфейса. Вы можете использовать разные подходы в зависимости от того, в какой части App Designer вы работаете. Выберите самый удобный подход из следующего списка.

Щелкните правой кнопкой по компоненту по холсту, Component Browser или панели App Layout, и выберите Callbacks> Add (callback property) callback.
Выберите вкладку Callbacks в Component Browser. Левая сторона вкладки Callbacks показывает список поддерживаемых свойств коллбэка. Текстовое поле рядом с каждым свойством коллбэка позволяет вам задавать имя для функции обратного вызова. Стрелка вниз рядом с текстовым полем позволяет вам выбирать имя по умолчанию в угловых скобках <>. Если ваше приложение имеет существующие коллбэки, выпадающее включает те коллбэки. Выберите существующий коллбэк когда это необходимо несколько компонентов пользовательского интерфейса, чтобы выполнить тот же код.
В коде Code View, во вкладке Editor, нажимают Callbacks . Или в Code Browser на вкладке Callbacks, нажмите кнопку.

Задайте следующие опции в диалоговом окне Add Callback Function:
- Component — Задайте компонент пользовательского интерфейса, который выполняет коллбэк.
- 'callback' Задайте свойство коллбэка. Свойство коллбэка сопоставляет функцию обратного вызова с определенным взаимодействием. Некоторые компоненты имеют больше чем одно свойство коллбэка в наличии. Например, ползунки имеют два свойства коллбэка: ValueChangedFcn и ValueChangingFcn. Свойство ValueChangedFcn выполняется после того, как пользователь перемещает ползунок и выпускает мышь. Свойство ValueChangingFcn для того же компонента выполняется неоднократно, в то время как пользователь перемещает ползунок.
- Имя Задайте имя для функции обратного вызова. App Designer обеспечивает имя по умолчанию, но можно изменить его в текстовом поле. Если ваше приложение имеет существующие коллбэки, поле Name имеет стрелку вниз рядом с ним, указывая, что можно выбрать существующий коллбэк из списка.

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

Все коллбэки в App Designer имеют следующие входные параметры в функциональной подписи:

Объект app — The app. Используйте этот объект получить доступ к компонентам пользовательского интерфейса в приложении, а также других переменных, сохраненных как свойства.
событие Объект, который содержит определенную информацию о взаимодействии пользователя с компонентом пользовательского интерфейса.

Аргумент app предоставляет объект app вашему коллбэку. Можно получить доступ к любому компоненту (и все свойства, зависящие от компонента) в любом коллбэке при помощи этого синтаксиса:

app.Component.Property

Например, это наборы команд свойство Value прибора к 50. В этом случае именем прибора является PressureGauge.

app.PressureGauge.Value = 50;

Аргумент event обеспечивает объект, который имеет различные свойства, в зависимости от определенного коллбэка, который выполняется. Свойства объектов содержат информацию, которая относится к типу взаимодействия, на которое отвечает коллбэк. Например, аргумент event в коллбэке ValueChangingFcn ползунка содержит свойство под названием Value. То свойство хранит значение ползунка, когда пользователь перемещает ползунок (прежде чем они выпустят мышь). Вот функция обратного вызова ползунка, которая использует аргумент event, чтобы заставить прибор отследить значение ползунка.

function SliderValueChanged(app, event)
      latestvalue = event.Value; % Current slider value
      app.PressureGauge.Value = latestvalue;  % Update gauge   
end

Чтобы узнать больше об аргументе event для функции обратного вызова определенного компонента, смотрите страницу свойств для того компонента. Щелкните правой кнопкой по компоненту и выберите Help on Selection, чтобы открыть страницу свойств. Для списка страниц свойств для всех компонентов пользовательского интерфейса см. Приложения Разработки в App Designer.

Поиск обратных вызовов в коде

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

Кликните по результату поиска прокрутить коллбэк в представление. Щелчок правой кнопкой по результату поиска и выбор Go To устанавливают ваш курсор в функцию обратного вызова.

Удаление обратных вызовов

Удалите коллбэк путем щелчка правой кнопкой по коллбэку по вкладке Callbacks Code Browser и выбора Delete из контекстного меню.

Пример: Приложение с обратным вызовом ползунка

Открытое приложение

Это приложение содержит прибор, который отслеживает значение ползунка, когда пользователь перемещает ползунок. Коллбэк ValueChangingFcn для ползунка получает текущее значение ползунка от аргумента event. Затем это перемещает стрелку указателя в то значение.

Документация