15.2.10 Взаимодействие с графиками

Пользователь может выбрать точки на графике с помощью функции ginput или выбрать положение, в котором необходимо разместить текст на графике, с помощью функции gtext с помощью мыши.

: [x, y, buttons] = ginput (n)

: [x, y, buttons] = ginput ()

Возвращает положение и тип щелчков мыши и/или нажатий клавиш в текущем окне фигуры.

Если n определено, то захватываются n событий перед возвратом. Когда n не определено ginput будет циклически ожидать нажатия клавиши возврата RET.

Возвращаемые значения x, y — координаты, где была нажата кнопка мыши, в единицах текущей оси. Возвращаемое значение button — 1, 2 или 3 для левой, средней или правой кнопки. Если нажата клавиша, в button возвращается её ASCII-код.

Примечание по реализации: ginput предназначена для 2-D графиков. Для 3-D графиков см. свойство currentpoint текущей оси, которое может быть преобразовано в единицы данных с использованием текущей информации view.

См. также: gtext, waitforbuttonpress.

: waitforbuttonpress ()

: b = waitforbuttonpress ()

Ожидает нажатия кнопки мыши или клавиши в текущем окне фигуры.

Возвращаемое значение b равно 0, если была нажата кнопка мыши, или 1, если была нажата клавиша.

См. также: waitfor, ginput, kbhit.

: gtext (s)

: gtext ({s1, s2, …})

: gtext ({s1; s2; …})

: gtext (…, prop, val, …)

: h = gtext (…)

Размещает текст на текущей фигуре с помощью мыши.

Строковый аргумент s может быть символьной строкой или ячейкой строк. Если s имеет более одной строки, каждая строка используется для создания отдельного объекта текста после щелчка мыши. Например:

Размещение одной строки после одного щелчка мыши

gtext ("I clicked here")

Размещение двух строк после двух щелчков мыши

gtext ({"I clicked here"; "and there"})

Размещение двух строк, каждая из которых состоит из двух строк, после двух щелчков мыши

gtext ({"I clicked", "here"; "and", "there"})

Необязательные пары property/value передаются непосредственно в основополагающие объекты текста.

Полный список свойств объектов текста описан в разделе Свойства текста.

Необязательное возвращаемое значение h содержит графический дескриптор(ы) созданного(ых) объекта(ов) текста.

См. также: ginput, text.

Более сложные механизмы пользовательского взаимодействия можно получить, используя функции семейства ui*, см. UI-элементы.