锅

开启平移模式

描述

您可以使用平移模式通过交互地平移轴的视图来探索数据。控件启用或禁用平移模式，并设置其他基本选项锅函数。要进一步控制平移模式行为，返回并使用锅对象。

大多数图表支持平移模式，包括折线图、柱状图、直方图和曲面图。支持平移模式的图表通常显示平移坐标轴工具栏中的图标。

您还可以使用默认启用的内置轴交互以交互方式探索数据。例如，您可以通过拖动2-D轴的轴来平移视图。内置交互不需要启用交互模式，也不需要比交互模式更快地响应。但是，您可以启用平移模式来自定义平移行为。有关内置交互的更多信息，请参见控制图交互性．

创建

语法

潘选项

锅

锅(无花果、选项)

P = pan

P = pan(图)

描述

例子

锅选项为当前图中的所有轴设置平移模式。例如,锅上启用平移模式，潘发送朴通对象的平移模式x维度,锅你对象的平移模式y-仅维，和锅了禁用平移模式。

启用平移模式时，使用光标或键盘平移轴的视图。

游标——在坐标轴上单击并拖动游标。
键盘-垂直平移，按向上箭头(↑)或者是向下箭头(↓)关键。要水平平移，按左箭头(←)或者是右箭头(→)关键。

一些内置交互在默认情况下保持启用状态，而不管当前交互模式如何。若要禁用独立于平移模式的内置平移交互，请使用disableDefaultInteractivity函数。

锅切换平移模式。如果平移模式被禁用，则调用锅的最近使用的平移选项在，发送朴通,或你．

锅(无花果，选项）为指定图中的所有轴设置平移模式。例如，为图中的所有轴启用平移模式无花果,使用锅(图,“上”)．

例子

P = pan创建一个锅对象获取当前图。这个语法对于自定义平移模式和运动非常有用。

例子

P = pan(无花果）创建一个锅对象的值。

输入参数

全部展开

`选项`- - - - - -平移模式选项
`“上”`|`“关闭”`|`发送朴通的`|`“你”`|`“切换”`

平移模式选项，指定为以下值之一:

“上”—开启pan模式。
“关闭”—关闭pan模式。一些内置交互在默认情况下保持启用状态，而不管当前交互模式如何。若要禁用独立于平移模式的内置平移交互，请使用disableDefaultInteractivity函数。
发送朴通的—启用pan模式x维度。
“你”—启用pan模式y维度。
“切换”—切换平移模式。如果pan模式被禁用，那么“切换”的最近使用的平移选项“上”，发送朴通的,或“你”．使用此选项与调用相同锅没有任何争论。

`无花果`- - - - - -目标图
`数字`对象

目标数字，指定为数字对象。

属性

全部展开

`运动`- - - - - -维
`“两个”`(默认)|`“水平”`|`“垂直”`

允许平移的维度，指定为以下值之一:

“两个”-允许平移x-维和y维度。
“水平”-允许平移x维度。
“垂直”-允许平移y维度。

此属性仅影响二维视图中的轴，例如在调用时视图(90 [0])．若要在3-D视图中控制平底锅的尺寸，请使用panInteraction对象。

`快捷菜单`- - - - - -上下文菜单
空`GraphicsPlaceholder`数组(默认)|`快捷菜单`对象

上下文菜单，指定为快捷菜单对象。当在启用平移模式的轴上单击右键时，使用此属性可显示上下文菜单。方法创建上下文菜单uicontextmenu函数。

`ButtonDownFilter`- - - - - -泛抑制回调
[](默认)|函数处理|单元阵列|特征向量

Pan抑制回调，指定为以下值之一:

函数处理
包含函数句柄和附加参数的单元格数组
字符向量包含一个有效的MATLAB^®命令或函数，在基本工作区中计算(不推荐)

使用此属性可在您定义的条件下抑制平移。数字或逻辑输出1 (真正的)抑制平移，数值或逻辑输出为0 (假)允许平移。如果使用函数句柄指定此属性，则MATLAB将传递两个参数给回调函数:

轴-你正在平移的轴线对象。
eventData-空谈。用波浪号字符(～)，以指示此参数未被使用。

如果使用函数句柄指定此属性，则必须将函数输出赋值给变量。

有关回调的更多信息，请参见为图形对象创建回调函数．

`ActionPreCallback`- - - - - -函数在平移之前执行
[](默认)|函数处理|单元阵列|特征向量

函数在平移之前执行，指定为以下值之一:

函数处理
包含函数句柄和附加参数的单元格数组
字符向量包含有效的MATLAB命令或函数，在基本工作区中计算(不推荐)

在开始平移时使用此属性执行代码。如果使用函数句柄指定此属性，则MATLAB将传递两个参数给回调函数:

数字- - - - - -数字对象，在其中进行平移。
axesStruct包含一个字段的结构，轴，你要平移的坐标轴对象。如果在回调函数中不使用此参数，则用波浪号字符(～)．

有关回调的更多信息，请参见为图形对象创建回调函数．

`ActionPostCallback`- - - - - -函数在平移后执行
[](默认)|函数处理|单元阵列|特征向量

函数在平移后执行，指定为以下值之一:

函数处理
包含函数句柄和附加参数的单元格数组
字符向量包含有效的MATLAB命令或函数，在基本工作区中计算(不推荐)

使用此属性在完成平移后执行代码。如果使用函数句柄指定此属性，则MATLAB将传递两个参数给回调函数:

数字- - - - - -数字对象，在其中进行平移。
axesStruct包含一个字段的结构，轴，你要平移的坐标轴对象。如果在回调函数中不使用此参数，则用波浪号字符(～)．

有关回调的更多信息，请参见为图形对象创建回调函数．

`启用`- - - - - -泛模状态
`“关闭”`(默认)|`“上”`

Pan模式状态，指定为“关闭”或“上”．

`FigureHandle`- - - - - -图对象
`数字`对象

此属性是只读的。

数字对象时指定的锅对象。如果你没有指定一个数字，那么FigureHandle创建时的数字是当前的吗锅对象。

`UseLegacyExplorationModes`- - - - - -传统模式
`“关闭”`(默认)|`“上”`|开/关逻辑值

遗留模式，指定为“上”或“关闭”，或作为数字或逻辑1（真正的)或0（假)．的值“上”等于真正的,“关闭”等于假．因此，您可以将此属性的值用作逻辑值。该值存储为类型的开/关逻辑值OnOffSwitchState．

此属性仅适用于锅方法创建的图形的对象uifigure功能或功能MATLAB在线™．将此属性设置为“上”改变UI图形中交互模式的行为，使它们与传统图形中的模式行为相匹配。有关更多信息，请参见enableLegacyExplorationModes．

一旦将此属性设置为“上”，它不能变回“关闭”．

对象的功能

使用锅对象函数，以自定义图中轴对象的平移行为。对于所有这些函数，坐标轴和平移模式对象必须与相同的图形相关联。

`setAllowAxesPan`	的`setAllowAxesPan`函数设置对平移轴的权限。调用`setAllowAxesPan (p轴tf)`在平移对象上`p`，用一个坐标轴对象的向量`轴`一个逻辑标量`特遣部队`作为输入，允许或禁止在坐标轴对象上进行平移操作。为使用轴启用平移模式`setAllowAxesPan`不为图启用平移模式。为此，设置`启用`的属性`锅`对象。
`isAllowAxesPan`	的`isAllowAxesPan`函数用于查询对平移轴的权限。调用`tf = isAllowAxesPan(p,axes)`在平移对象上`p`，用一个坐标轴对象的向量`轴`作为输入，返回逻辑数组`特遣部队`大小一样的`轴`．`特遣部队`指示是否允许在坐标轴对象上进行平移操作。返回使用轴的平移模式`isAllowAxesPan`不返回图的平移模式。要做到这一点，请访问`启用`的属性`锅`对象。
`setAxesPanConstraint`	的`setAxesPanConstraint`函数设置轴的平移尺寸。调用`setAxesPanConstraint (p轴,d)`在平移对象上`p`，用一个坐标轴对象的向量`轴`和一个维值标量`d`作为输入，将坐标轴对象的泛维设置为以下维度值之一:`“x”`，`“y”`，`“z”`，`“xy”`，`“xz”`，`“yz”`,或`无约束的`．设置使用轴的盘面尺寸`setAxesPanConstraint`不为图形设置平底锅尺寸。为此，设置`运动`属性。
`getAxesPanConstraint`	的`getAxesPanConstraint`函数返回轴的泛维。调用`d = getAxesPanConstraint(p,axes)`在平移对象上`p`，用一个坐标轴对象的向量`轴`作为输入，返回单元格数组`d`指示每个轴对象的泛尺寸。返回轴的泛尺寸`getAxesPanConstraint`不返回图的泛尺寸。要做到这一点，请访问`运动`属性。
`setAxes3DPanAndZoomStyle`	的`setAxes3DPanAndZoomStyle`函数设置轴的平移样式。调用`setAxes3DPanAndZoomStyle (p轴,s)`在平移对象上`p`，用一个坐标轴对象的向量`轴`和一个泛样式字符数组`年代`作为输入，设置轴对象的泛样式。默认情况下，泛样式为`“限制”`，通过修改坐标轴的极限进行平移。指定泛样式为`“相机”`通过修改相机视角进行平移。有关相机视角的更多信息，请参见相机图形术语．
`getAxes3DPanAndZoomStyle`	的`getAxes3DPanAndZoomStyle`函数返回轴的泛样式。调用`s = getAxes3DPanAndZoomStyle(p,axes)`在平移对象上`p`，用一个坐标轴对象的向量`轴`作为输入，返回单元格数组`年代`指示每个轴对象的泛样式。
`setAxesPanMotion`(不推荐)	不推荐使用。使用`setAxesPanConstraint`代替。调用`setAxesPanMotion (p轴,d)`在平移对象上`p`，用一个坐标轴对象的向量`轴`和泛维字符数组`d`作为输入，将坐标轴对象的泛维设置为以下维度值之一:`“水平”`，`“垂直”`,或`“两个”`．设置的轴盘尺寸`setAxesPanMotion`是否与使用`运动`财产。
`getAxesPanMotion`(不推荐)	不推荐使用。使用`getAxesPanConstraint`代替。调用`d = getAxesPanMotion(p,axes)`在平移对象上`p`，用一个坐标轴对象的向量`轴`作为输入，返回单元格数组`d`指示每个轴对象的泛尺寸。返回的轴平移尺寸`getAxesPanMotion`是否与使用?返回的图形盘尺寸不相同`运动`财产。

例子

全部折叠

启用Pan模式

绘制图形并启用平移模式。然后，交互平移坐标轴。

情节(魔法(10))平底锅在

在平铺图表布局中约束平移

在平铺图表布局中创建四个轴，并为每个轴分配不同的平移行为。然后，交互平移坐标轴。

Tiledlayout (2,2) ax1 = nexttile;情节(1:10);P = pan;Ax2 = nexttile;情节(兰德(3));setAllowAxesPan (p, ax2假);Ax3 = nexttile;情节(峰);setAxesPanConstraint (p ax3“x”）;Ax4 = nexttile;轮廓(峰);setAxesPanMotion (p,大举裁员,“水平”）;

创建Button Down回调

为要触发的平移模式对象创建一个按下按钮回调。将以下代码复制到一个新文件并执行它，并观察平移行为。

函数演示允许一行有自己的'ButtonDownFcn'回调hLine = plot(rand(1,10));线。ButtonDownFcn =“disp(“这执行”)”；线。标签=“DoNotIgnore”；H =锅;h.ButtonDownFilter = @mycallback;h.Enable =“上”；鼠标单击该行结束函数[flag] = mycallback(obj,event_obj)如果对象标签是'DoNotIgnore'，则返回true说明目标是什么disp ([“点击”obj。类型“对象”]) objTag = obj.Tag;如果strcmpi (objTag“DoNotIgnore”) flag = true;其他的Flag = false;结束结束

定义前回调和后回调行为

为按下按钮前和按下按钮后的事件创建回调，以便触发平移模式对象。将以下代码复制到一个新文件中，执行它，并观察平移行为。

函数演示倾听事件情节(1:10);P = pan;p.ActionPreCallback = @myprecallback;p.ActionPostCallback = @mypostcallback;p.Enable =“上”；结束函数myprecallback (obj, evd) disp (“大爆炸即将发生。”）;结束函数mypostcallback(obj,evd) newLim = evd. ax . xlim;对话框(sprintf (“新的x极限是[%.2f，%.2f]。”newLim));结束

创建模式上下文菜单

创建一个上下文菜单，让用户通过右键单击切换到缩放模式。

图绘制(魔法(10));pCM = uicontextmenu;pMenu = uimenu(“父”pCM,“标签”，“切换到缩放”，.．.“回调”，“变焦(gcbf,“上”)）;pPan = pan(gcf);pPan。ContextMenu = pCM;锅(“上”）

选择功能

轴工具栏

对于某些图表，可以通过单击平移来启用平移模式坐标轴工具栏中的图标。

版本历史

R2006a之前介绍过

全部展开

R2020a:`UIContextMenu`属性不推荐使用

从R2020a开始，使用UIContextMenu属性将上下文菜单分配给图形对象或UI组件是不建议的。使用快捷菜单财产。属性值是相同的。

目前还没有取消支持的计划UIContextMenu此时的财产。然而,UIContextMenu属性返回的列表中不再出现得到函数在图形对象或UI组件上。

R2018b:浏览默认启用平移的数据

使用默认启用的内置轴交互交互式地探索数据。例如，您可以在不启用平移模式的情况下单击并拖动坐标轴(2-D视图)。有关更多信息，请参见控制图交互性．

以前，默认情况下没有启用任何轴交互。

另请参阅

变焦|rotate3d|linkaxes

锅

描述

创建

语法

描述

输入参数

`选项`- - - - - -平移模式选项
`“上”`|`“关闭”`|`发送朴通的`|`“你”`|`“切换”`

`无花果`- - - - - -目标图
`数字`对象

属性

`运动`- - - - - -维
`“两个”`(默认)|`“水平”`|`“垂直”`

`快捷菜单`- - - - - -上下文菜单
空`GraphicsPlaceholder`数组(默认)|`快捷菜单`对象

`ButtonDownFilter`- - - - - -泛抑制回调
[](默认)|函数处理|单元阵列|特征向量

`ActionPreCallback`- - - - - -函数在平移之前执行
[](默认)|函数处理|单元阵列|特征向量

`ActionPostCallback`- - - - - -函数在平移后执行
[](默认)|函数处理|单元阵列|特征向量

`启用`- - - - - -泛模状态
`“关闭”`(默认)|`“上”`

`FigureHandle`- - - - - -图对象
`数字`对象

`UseLegacyExplorationModes`- - - - - -传统模式
`“关闭”`(默认)|`“上”`|开/关逻辑值

对象的功能

例子

启用Pan模式

在平铺图表布局中约束平移

创建Button Down回调

定义前回调和后回调行为

创建模式上下文菜单

更多关于

更改回调函数

选择功能

轴工具栏

版本历史

R2020a:`UIContextMenu`属性不推荐使用

R2018b:浏览默认启用平移的数据

另请参阅

主题

锅

描述

创建

语法

描述

输入参数

选项- - - - - -平移模式选项“上”|“关闭”|发送朴通的|“你”|“切换”

无花果- - - - - -目标图数字对象

属性

运动- - - - - -维“两个”(默认)|“水平”|“垂直”

快捷菜单- - - - - -上下文菜单空GraphicsPlaceholder数组(默认)|快捷菜单对象

ButtonDownFilter- - - - - -泛抑制回调[](默认)|函数处理|单元阵列|特征向量

ActionPreCallback- - - - - -函数在平移之前执行[](默认)|函数处理|单元阵列|特征向量

ActionPostCallback- - - - - -函数在平移后执行[](默认)|函数处理|单元阵列|特征向量

启用- - - - - -泛模状态“关闭”(默认)|“上”

FigureHandle- - - - - -图对象数字对象

UseLegacyExplorationModes- - - - - -传统模式“关闭”(默认)|“上”|开/关逻辑值

对象的功能

例子

启用Pan模式

在平铺图表布局中约束平移

创建Button Down回调

定义前回调和后回调行为

创建模式上下文菜单

更多关于

更改回调函数

选择功能

轴工具栏

版本历史

R2020a:UIContextMenu属性不推荐使用

R2018b:浏览默认启用平移的数据

另请参阅

主题

`选项`- - - - - -平移模式选项
`“上”`|`“关闭”`|`发送朴通的`|`“你”`|`“切换”`

`无花果`- - - - - -目标图
`数字`对象

`运动`- - - - - -维
`“两个”`(默认)|`“水平”`|`“垂直”`

`快捷菜单`- - - - - -上下文菜单
空`GraphicsPlaceholder`数组(默认)|`快捷菜单`对象

`ButtonDownFilter`- - - - - -泛抑制回调
[](默认)|函数处理|单元阵列|特征向量

`ActionPreCallback`- - - - - -函数在平移之前执行
[](默认)|函数处理|单元阵列|特征向量

`ActionPostCallback`- - - - - -函数在平移后执行
[](默认)|函数处理|单元阵列|特征向量

`启用`- - - - - -泛模状态
`“关闭”`(默认)|`“上”`

`FigureHandle`- - - - - -图对象
`数字`对象

`UseLegacyExplorationModes`- - - - - -传统模式
`“关闭”`(默认)|`“上”`|开/关逻辑值

R2020a:`UIContextMenu`属性不推荐使用