Main Content

newplot

确定图形对象的绘制位置

语法

newplot
h = newplot
h = newplot(target)

说明

newplot 为后续图形命令准备好图窗和坐标区。

h = newplot 为后续图形命令准备图窗和坐标区并返回当前坐标区。

h = newplot(target) 为绘图准备由 target 指定的对象,而不是当前图窗的当前坐标区。目标对象可以是笛卡尔坐标区、极坐标区或地理坐标区对象。如果 target 为空,newplot 的行为如同不带任何输入项。

提示

要创建二维图,请改用 plot 函数。

在高级图形代码的开头处使用 newplot 以确定使用哪个图窗和坐标区作为图形输出目标。调用 newplot 可以改变当前图窗和当前坐标区。在现有的图窗和坐标区中绘制图形时,一般有三个选项:

  • 添加新图形而不更改属性或删除任何对象。

  • 删除所有句柄未隐藏的对象,然后绘制新对象。

  • 删除所有对象,无论其句柄是否隐藏,并将大部分属性重置为默认值,然后绘制新对象(有关具体信息,请参见下表)。

图窗和坐标区的 NextPlot 属性确定了 newplot 的行为。以下两个表介绍了采用不同属性值时的行为。

首先,newplot 读取当前图窗的 NextPlot 属性并做出相应的行为。

NextPlot

发生的情况

new

创建一个新图窗并将其用作当前图窗。

add

绘制到当前图窗上,而且不清除已有的任何对象。

replacechildren

删除所有 HandleVisibility 属性设置为 on 的对象并将图窗 NextPlot 属性重置为 add

这会清空当前图窗,相当于发出 clf 命令。

replace

删除所有子对象(不管其 HandleVisibility 属性设置为何值)并将图窗属性设置为默认值,除了

NextPlot 重置为 add,无论用户定义的默认值为何值。

这会清除并重置当前图窗,相当于发出 clf reset 命令。

newplot 建立要在其中绘制的图窗后,它会读取当前坐标区的 NextPlot 属性做出相应的行为。

NextPlot

描述

add

在现有坐标区上添加新绘图。在显示新绘图之前,不删除现有绘图或重置坐标区属性。

replacechildren

在显示新绘图之前删除现有绘图。可将 ColorOrderIndexLineStyleOrderIndex 坐标区属性重置为 1,但不要重置其他坐标区属性。添加到坐标区的下一个绘图基于坐标区的 ColorOrderLineStyleOrder 属性使用第一个颜色和线型。此值类似于在每个新绘图之前使用 cla

replace

显示新绘图之前删除现有绘图,并将除 PositionUnits 之外的所有坐标区属性重置为默认值。

replaceall

显示新绘图之前删除现有绘图,并将除 PositionUnits 之外的所有坐标区属性重置为默认值。此值类似于在每个新绘图之前使用 cla reset

对于只有一个 y 轴的坐标区,replacereplaceall 值是等效的。对于有两个 y 轴的坐标区,replace 值只影响活动侧,而 replaceall 值同时影响两侧。

版本历史记录

在 R2006a 之前推出

另请参阅

| | | | | | |