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 предназначена для двумерных графиков. Для трёхмерных графиков см. свойство currentpoint текущих осей, которое можно преобразовать в единицы данных, зная текущую view.

См. также: gtext, 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*; см. раздел Элементы пользовательского интерфейса.