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 для левой, средней или правой кнопки соответственно. Если нажата клавиша, то её ASCII-код возвращается в button.

Примечание по реализации: ginput предназначена для 2D-графиков. Для 3D-графиков см. свойство 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"})

Дополнительные пары свойство/значение передаются непосредственно в базовые текстовые объекты.

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

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

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

Более сложные механизмы взаимодействия с пользователем могут быть получены с помощью функций семейства ui*, см. Элементы пользовательского интерфейса.