Примечание
Среда GUIDE будет удалена в будущем релизе. После того, как GUIDE удален, существующие приложения GUIDE продолжат запускаться в MATLAB® но они не будут доступны для редактирования в GUIDE.
Чтобы продолжить редактировать существующее приложение GUIDE, см. Стратегии Миграции GUIDE информации о том, как помочь обеспечить совместимость приложения с будущими релизами MATLAB. Чтобы создать новые приложения в интерактивном режиме, Разработайте Приложения Используя App Designer вместо этого.
Пользовательский интерфейс и графические компоненты имеют определенные свойства, которые можно сопоставить с определенными функциями обратного вызова. Каждое из этих свойств соответствует определенному пользовательскому действию. Например, uicontrol имеет свойство под названием Callback
. Можно установить значение этого свойства быть указателем на функцию обратного вызова, анонимную функцию или вектор символов, содержащий выражение MATLAB. Установка этого свойства заставляет ваше приложение ответить, когда пользователь взаимодействует с uicontrol. Если Callback
свойство не имеет никакого заданного значения, затем ничего не происходит, когда пользователь взаимодействует с uicontrol.
Эта таблица приводит свойства коллбэка, которые доступны, пользовательские действия, которые инициировали функцию обратного вызова, и наиболее распространенный пользовательский интерфейс и графические компоненты, которые используют их.
Свойство коллбэка | Пользовательское действие | Компоненты, которые используют это свойство |
---|---|---|
ButtonDownFcn | Конечный пользователь нажимает кнопку мыши, в то время как указатель находится на компоненте или фигуре. | |
Callback | Конечный пользователь инициировал компонент. Например: выбор пункта меню, перемещение ползунка или нажатие кнопки. | |
CellEditCallback | Конечный пользователь редактирует значение в таблице, ячейки которой доступны для редактирования. | |
CellSelectionCallback | Конечный пользователь выбирает ячейки в таблице. | |
ClickedCallback | Конечный пользователь кликает по инструменту инструмента или переключателя нажатия с левой кнопкой мыши. | |
CloseRequestFcn | Завершения фигуры. | |
CreateFcn | Коллбэк выполняется, когда MATLAB создает объект, но прежде чем это будет отображено. |
|
DeleteFcn | Коллбэк выполняется непосредственно перед тем, как MATLAB удаляет фигуру. |
|
KeyPressFcn | Конечный пользователь нажимает клавишу на клавиатуре, в то время как указатель находится на объекте. | |
| Конечный пользователь выпускает клавишу на клавиатуре, в то время как указатель находится на объекте. | |
OffCallback | Выполняется когда | |
OnCallback | Выполняется когда | |
| Конечный пользователь изменяет размер группы кнопок, фигуры или панели чей | |
SelectionChangedFcn | Конечный пользователь устанавливает различный переключатель или кнопку-переключатель в группе кнопок. | |
WindowButtonDownFcn | Конечный пользователь нажимает кнопку мыши, в то время как указатель находится в окне рисунка. | |
WindowButtonMotionFcn | Конечный пользователь перемещает указатель в рамках окна рисунка. | |
WindowButtonUpFcn | Конечный пользователь отпускает кнопку мыши. | |
WindowKeyPressFcn | Конечный пользователь нажимает клавишу, в то время как указатель находится на фигуре или любом из его дочерних объектов. | |
WindowKeyReleaseFcn | Конечный пользователь отпускает клавишу, в то время как указатель находится на фигуре или любом из его дочерних объектов. | |
| Конечный пользователь крутит колесо мыши, в то время как указатель находится на фигуре. |
После того, как вы добавляете a uicontrol
, uimenu
, или uicontextmenu
компонент к вашему пользовательскому интерфейсу, но прежде чем вы сохраните его, GUIDE, заполняет Callback
свойство со значением, %automatic
. Это значение указывает, что GUIDE сгенерирует имя для функции обратного вызова.
Когда вы сохраняете свой пользовательский интерфейс, GUIDE добавляет пустое определение функции обратного вызова вашему файлу кода, и это устанавливает Callback
управления свойство быть анонимной функцией. Этим функциональным определением является пример сгенерированной GUIDE функции обратного вызова для кнопки.
function pushbutton1_Callback(hObject,eventdata,handles) % hObject handle to pushbutton1 (see GCBO) % eventdata reserved - to be defined in a future version of MATLAB % handles structure with handles and user data (see GUIDATA) end
myui
, затем GUIDE устанавливает Callback
кнопки
свойство к следующему значению:@(hObject,eventdata)myui('pushbutton1_Callback',hObject,eventdata,guidata(hObject))
pushbutton1_Callback
. Эта анонимная функция имеет четыре входных параметра. Первый аргумент является именем функции обратного вызова. Последние три аргумента обеспечиваются MATLAB и обсуждены в разделе, Синтаксисе Коллбэка GUIDE.Примечание
GUIDE автоматически не генерирует функции обратного вызова для других компонентов пользовательского интерфейса, таких как таблицы, панели или группы кнопок. Если вы хотите, чтобы какой-либо из этих компонентов выполнил функцию обратного вызова, то необходимо создать коллбэк путем щелчка правой кнопкой по компоненту в размещении и выбора элемента под View Callbacks в контекстном меню.
Все коллбэки должны принять по крайней мере три входных параметра:
hObject
— Компонент пользовательского интерфейса, который инициировал коллбэк.
eventdata
— Переменная, которая содержит подробную информацию об определенной мыши или действиях клавиатуры.
handles
— struct
это содержит все объекты в пользовательском интерфейсе. GUIDE использует guidata
функционируйте, чтобы сохранить и обеспечить эту структуру.
Для функции обратного вызова, чтобы принять дополнительные аргументы, необходимо поместить дополнительные аргументы в конце списка аргументов в функциональном определении.
eventdata
аргумент предоставляет подробную информацию определенным функциям обратного вызова. Например, если конечный пользователь инициировал KeyPressFcn
, затем MATLAB предоставляет информацию относительно определенного ключа (или комбинация ключей) что нажатый конечный пользователь. Если eventdata
не доступно для функции обратного вызова, затем MATLAB передает ее как пустой массив. В следующей таблице перечислены коллбэки и компоненты то использование eventdata
.
Имя свойства коллбэка | Компонент |
---|---|
WindowKeyPressFcn WindowKeyReleaseFcn WindowScrollWheel | figure |
KeyPressFcn | figure , uicontrol , uitable |
KeyReleaseFcn | figure , uicontrol , uitable |
SelectionChangedFcn | uibuttongroup |
CellEditCallback CellSelectionCallback | uitable |
Чтобы создать средства управления, меню и графические объекты в вашем приложении, которые являются взаимозависимыми, необходимо явным образом осуществлять обмен данными с частями приложения, которое должно получить доступ к компоненту.
Метод | Описание | Требования и компромиссы |
---|---|---|
Совместно используйте UserData | Получите или установите значения свойств непосредственно через объект компонента. Все компоненты пользовательского интерфейса имеют |
|
Совместно используйте данные приложения | Объединенные данные с определенным компонентом с помощью |
|
Используйте guidata | Осуществляйте обмен данными с окном рисунка с помощью |
|
Компоненты пользовательского интерфейса содержат полезную информацию в своих свойствах. Например, можно найти текущее положение ползунка путем запроса его Value
свойство. Кроме того, все компоненты имеют UserData
свойство, которое может сохранить любую переменную MATLAB. Все функции обратного вызова могут получить доступ к значению, сохраненному в UserData
свойство пока те функции может получить доступ к компоненту.
Настраивать приложение GUIDE для совместного использования данных о ползунке с UserData
свойство, выполните эти шаги:
В Командном окне ввести guide
открыть новый пустой графический интерфейс пользователя.
Отобразите имена компонентов пользовательского интерфейса в палитре элементов:
Выберите File> Preferences> GUIDE.
Выберите Show names in component palette.
Нажмите OK.
Выберите инструмент кнопки из палитры элементов в левой стороне Редактора макетов и перетащите его в область размещения.
Выберите инструмент ползунка из палитры элементов в левой стороне Редактора макетов и перетащите его в область размещения.
Выберите File> Save. Сохраните пользовательский интерфейс как myslider.fig
. MATLAB открывает файл кода в Редакторе.
Установите начальное значение UserData
свойство во вводной функции, myslider_OpeningFcn
. Эта функция выполняется непосредственно перед тем, как пользовательский интерфейс отображается пользователям.
В myslider_OpeningFcn
, вставьте эти команды сразу после команды, handles.output = hObject
.
data = struct('val',0,'diffMax',1); set(handles.slider1,'UserData',data);
myslider_OpeningFcn
выглядит так. function myslider_OpeningFcn(hObject, eventdata, handles, varargin) % This function has no output args, see OutputFcn. % hObject handle to figure % eventdata reserved - to be defined in a future version of MATLAB % handles structure with handles and user data (see GUIDATA) % varargin command line arguments to junk (see VARARGIN) % Choose default command line output for myslider handles.output = hObject; data = struct('val',0,'diffMax',1); set(handles.slider1,'UserData',data); % Update handles structure guidata(hObject, handles); % UIWAIT makes myslider wait for user response % uiwait(handles.figure1);
handles
входной параметр к myslider_OpeningFcn
. handles
переменная является структурой, которая содержит все компоненты в пользовательском интерфейсе. Каждое поле в этой структуре соответствует отдельному компоненту. Каждое имя поля совпадает с Tag
свойство соответствующего компонента. Таким образом, handles.slider1
компонент ползунка в этом пользовательском интерфейсе. Команда, set(handles.slider1,'UserData',data)
хранит переменную, data
, в UserData
свойство ползунка.Добавьте код в коллбэк ползунка для изменения данных. Добавьте эти команды в конец функции, slider1_Callback
.
maxval = get(hObject,'Max'); sval = get(hObject,'Value'); diffMax = maxval - sval; data = get(hObject,'UserData'); data.val = sval; data.diffMax = diffMax; % Store data in UserData of slider set(hObject,'UserData',data);
slider1_Callback
выглядит так.% --- Executes on slider movement. function slider1_Callback(hObject, eventdata, handles) % hObject handle to slider1 (see GCBO) % eventdata reserved - to be defined in a future version of MATLAB % handles structure with handles and user data (see GUIDATA) % Hints: get(hObject,'Value') returns position of slider % get(hObject,'Min') and get(hObject,'Max') to determine range of slider maxval = get(hObject,'Max'); sval = get(hObject,'Value'); diffMax = maxval - sval; data = get(hObject,'UserData'); data.val = sval; data.diffMax = diffMax; % Store data in UserData of slider set(hObject,'UserData',data);
hObject
входной параметр к slider1_Callback
функция. hObject
всегда компонент, который инициировал коллбэк (ползунок, в этом случае). Таким образом, set(hObject,'UserData',data)
, хранит data
переменная в UserData
свойство ползунка.Добавьте код в коллбэк кнопки для того, чтобы получить данные. Добавьте эти команды в конец функции, pushbutton1_Callback
.
% Get UserData from the slider data = get(handles.slider1,'UserData'); currentval = data.val; diffval = data.diffMax; display([currentval diffval]);
pushbutton1_Callback
выглядит так.% --- Executes on button press in pushbutton1. function pushbutton1_Callback(hObject, eventdata, handles) % hObject handle to pushbutton1 (see GCBO) % eventdata reserved - to be defined in a future version of MATLAB % handles structure with handles and user data (see GUIDATA) % Get UserData from the slider data = get(handles.slider1,'UserData'); currentval = data.val; diffval = data.diffMax; display([currentval diffval]);
Этот код использует структуру handles, чтобы получить доступ к ползунку. Команда, data = get(handles.slider1,'UserData')
, получает UserData
ползунка свойство. Затем
display
функционируйте отображает сохраненные значения.
Сохраните свой код путем нажатия Save в редакторе Тулстрипе.
Чтобы сохранить данные приложения, вызовите setappdata
функция:
setappdata(obj,name,value);
obj
, объект компонента, в котором можно хранить данные. Второй вход, name
, дружественное имя, которое описывает значение. Третий вход, value
, значение, которое вы хотите сохранить.Чтобы получить данные приложения, используйте getappdata
функция:
data = getappdata(obj,name);
obj
, должен быть объект компонента, содержащий данные. Второй вход, name
, должен совпадать с именем, вы раньше хранили данные. В отличие от UserData
свойство, которое только содержит только одну переменную, можно использовать setappdata
сохранить несколько переменных.Чтобы настроить приложение GUIDE для совместного использования данных приложения, выполните эти шаги:
В Командном окне ввести guide
открыть новый пустой графический интерфейс пользователя.
Отобразите имена компонентов пользовательского интерфейса в палитре элементов:
Выберите File> Preferences> GUIDE.
Выберите Show names in component palette.
Нажмите OK.
Выберите инструмент кнопки из палитры элементов в левой стороне Редактора макетов и перетащите его в область размещения.
Выберите инструмент ползунка из палитры элементов в левой стороне Редактора макетов и перетащите его в область размещения.
Выберите File> Save. Сохраните пользовательский интерфейс как myslider.fig
. MATLAB открывает файл кода в Редакторе.
Установите начальное значение данных приложения во вводной функции, myslider_OpeningFcn
. Эта функция выполняется непосредственно перед тем, как пользовательский интерфейс отображается пользователям. В myslider_OpeningFcn
, вставьте эти команды сразу после команды, handles.output = hObject
.
setappdata(handles.figure1,'slidervalue',0); setappdata(handles.figure1,'difference',1);
myslider_OpeningFcn
выглядит так. function myslider_OpeningFcn(hObject,eventdata,handles,varargin) % This function has no output args, see OutputFcn. % hObject handle to figure % eventdata reserved - to be defined in a future version of MATLAB % handles structure with handles and user data (see GUIDATA) % varargin command line arguments to junk (see VARARGIN) % Choose default command line output for junk handles.output = hObject; setappdata(handles.figure1,'slidervalue',0); setappdata(handles.figure1,'difference',1); % Update handles structure guidata(hObject, handles); % UIWAIT makes junk wait for user response (see UIRESUME) % uiwait(handles.figure1);
handles
входной параметр к myslider_OpeningFcn
. handles
переменная является структурой, которая содержит все компоненты в пользовательском интерфейсе. Каждое поле в этой структуре соответствует отдельному компоненту. Каждое имя поля совпадает с Tag
свойство соответствующего компонента. В этом случае, handles.figure1
объект фигуры. Таким образом, setappdata
может использовать объект этого рисунка хранить данные.Добавьте код в коллбэк ползунка для изменения данных. Добавьте эти команды в конец функции, slider1_Callback
.
maxval = get(hObject,'Max'); currval = get(hObject,'Value'); diffMax = maxval - currval; % Store application data setappdata(handles.figure1,'slidervalue',currval); setappdata(handles.figure1,'difference',diffMax);
slider1_Callback
выглядит так.function slider1_Callback(hObject, eventdata, handles) % hObject handle to slider1 (see GCBO) % eventdata reserved - to be defined in a future version of MATLAB % handles structure with handles and user data (see GUIDATA) % Hints: get(hObject,'Value') returns position of slider % get(hObject,'Min') and get(hObject,'Max') to determine range of slider maxval = get(hObject,'Max'); currval = get(hObject,'Value'); diffMax = maxval - currval; % Store application data setappdata(handles.figure1,'slidervalue',currval); setappdata(handles.figure1,'difference',diffMax);
handles
структура, таким образом, setappdata
команды хранят данные в handles.figure1
.Добавьте код в коллбэк кнопки для того, чтобы получить данные. Добавьте эти команды в конец функции, pushbutton1_Callback
.
% Retrieve application data currentval = getappdata(handles.figure1,'slidervalue'); diffval = getappdata(handles.figure1,'difference'); display([currentval diffval]);
pushbutton1_Callback
выглядит так.% --- Executes on button press in pushbutton1. function pushbutton1_Callback(hObject, eventdata, handles) % hObject handle to pushbutton1 (see GCBO) % eventdata reserved - to be defined in a future version of MATLAB % handles structure with handles and user data (see GUIDATA) % Retrieve application data currentval = getappdata(handles.figure1,'slidervalue'); diffval = getappdata(handles.figure1,'difference'); display([currentval diffval]);
handles
структура, таким образом, getappdata
команды получают данные от handles.figure1
.Сохраните свой код путем нажатия Save в редакторе Тулстрипе.
guidata
сохранить и осуществлять обмен данными в приложениях GUIDEGUIDE использует guidata
функционируйте, чтобы сохранить структуру под названием handles
, который содержит все компоненты пользовательского интерфейса. MATLAB передает handles
массив к каждой функции обратного вызова. Если вы хотите использовать guidata
чтобы совместно использовать дополнительные данные, затем добавьте поля в handles
структура во вводной функции. Вводная функция является функцией, определяемой около верхней части вашего файла кода, который имеет _OpeningFcn
на имя.
Чтобы изменить ваши данные в функции обратного вызова, измените handles
структура, и затем хранит его с помощью guidata
функция. Эта функция обратного вызова ползунка показывает, как изменить и сохранить handles
структура в функции обратного вызова GUIDE.
function slider1_Callback(hObject, eventdata,handles) % hObject handle to slider1 (see GCBO) % eventdata reserved - to be defined in a future version of MATLAB % handles structure with handles and user data (see GUIDATA) % Hints: get(hObject,'Value') returns position of slider % get(hObject,'Min') and get(hObject,'Max') to determine range handles.myvalue = 2; guidata(hObject,handles); end
Вот предварительно созданное приложение GUIDE, которое использует guidata
функция, чтобы осуществлять обмен данными между ползунком и текстовым полем. Когда вы перемещаете ползунок, номер, отображенный в текстовом поле, изменяется, чтобы показать новое положение ползунка.
Вот предварительно созданное приложение GUIDE, которое использует данные приложения и guidata
функция, чтобы осуществлять обмен данными между двумя диалоговыми окнами. При вводе текст во втором диалоговом окне и нажимаете ОК, изменения названия кнопки в первом диалоговом окне.
В changeme_main.m
, buttonChangeMe_Callback
функция выполняет эту команду, чтобы отобразить второе диалоговое окно:
changeme_dialog('changeme_main', handles.figure)
handles.figure
входным параметром является Figure
объект для changeme_main диалогового окна.
changeme_dialog
функция получает handles
структура от Figure
объект. Таким образом целый набор компонентов в changeme_main диалоговом окне доступен для второго диалогового окна.
Вот предварительно созданное приложение GUIDE, которое использует guidata
и UserData
осуществлять обмен данными среди трех окон приложения. Большое окно является редактором иконок, который принимает информацию из окон палитры инструментов и цветовой палитры.
В guide_inconeditor.m
, функциональный guide_iconeditor_OpeningFcn
содержит эту команду:
colorPalette = guide_colorpalette('iconEditor', hObject)
Аргументы:
'iconEditor'
указывает, что коллбэк в guide_iconEditor окне инициировал выполнение функции.
hObject
Figure
объект для guide_iconEditor окна.
colorPalette
Figure
объект для guide_colorPalette окна.
Точно так же guide_iconeditor_OpeningFcn
вызывает guide_toolpalette
функция с подобными аргументами ввода и вывода.
Передача Figure
объект между этими функциями позволяет guide_iconEditor окну получать доступ к handles
структура других двух окон. Аналогично, другие два окна могут получить доступ к handles
структура для guide_iconEditor окна.
GUIDE создает имя функции обратного вызова путем объединения Tag
компонента свойство и имя свойства коллбэка. Если вы изменяете
Tag
компонента значение, затем GUIDE изменяет название коллбэка в следующий раз, когда вы сохраняете пользовательский интерфейс.
Если вы решаете изменить Tag
значение после сохранения пользовательского интерфейса, затем GUIDE обновляет следующие элементы (принимающий, что все компоненты имеют уникальный Tag
значения.
Определение функции обратного вызова компонента
Значение свойства коллбэка компонента
Ссылки в файле кода к соответствующему полю в handles
структура
Переименовать функцию обратного вызова, не изменяя Tag
компонента свойство:
Поменяйте имя в определении функции обратного вызова.
Обновитесь свойство коллбэка компонента путем изменения первого аргумента передало анонимной функции. Например, исходное свойство коллбэка для кнопки может выглядеть так:
@(hObject,eventdata)myui('pushbutton1_Callback',... hObject,eventdata,guidata(hObject))
В этом примере необходимо измениться, 'pushbutton1_Callback'
к новому имени функции.
Измените все другие ссылки на старое имя функции к новому имени функции в файле кода.
Можно удалить функцию обратного вызова, когда это необходимо, чтобы удалить или изменить функцию, которая выполняется, когда конечный пользователь выполняет определенное действие. Удалить функцию обратного вызова:
Ищите и замените все экземпляры, которые относятся к функции обратного вызова в вашем коде.
Откройте пользовательский интерфейс в GUIDE и замените все экземпляры, которые относятся к функции обратного вызова в Property Inspector.
Удалите функцию обратного вызова.