---

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 专用于二维绘图。对于三维绘图，请参阅当前坐标轴的 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"})

可选的属性/值对将直接传递给底层的文本对象。

文本对象属性的完整列表请参阅 Text Properties。

可选返回值 h 保存已创建文本对象的图形句柄。

另请参阅: ginput, text。

使用 ui* 系列函数可以获得更复杂的用户交互机制，请参阅 UI Elements。