主要内容

このページの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。

newplot

グラフィックスオブジェクトの描画位置の決定

構文

newplot
h = newplot
h = newplot(目标)

説明

関数newplotは,次に入力するグラフィックスコマンドの图や座標軸を用意します。

h = newplotは,次に入力するグラフィックスコマンドの图や座標軸を用意し,現在の座標軸を返します。

h = newplot(目标)は,現在の图の現在の座標軸の代わりに,目标で指定されるオブジェクトをプロットのために用意します。ターゲットオブジェクトは,直交座標軸,極座標軸,または地理座標軸のいずれかのオブジェクトにできます。目标が空の場合,関数newplotは,入力なしで呼び出されたように動作します。

ヒント

単純な2次元プロットを作成するには,代わりに関数情节を使用します。

高水準のグラフィックスのコードの先頭に関数newplotを使用することで,グラフィックスの出力のターゲットとなる图や轴が決められます。関数newplotを実行することで,現在の图と現在の轴を変更できます。基本的には,既存の图や轴内にグラフィックスを描画するには,3種類のオプションがあります。

  • プロパティを変更したり,オブジェクトを消去せずに,新規のグラフィックスを追加

  • 新規のオブジェクトを描画する前に,ハンドルが隠されていない既存のすべてのオブジェクトを消去

  • ハンドルが隠されているかどうかにかかわらず,すべての既存のオブジェクトを消去し,新規のオブジェクトを描画する前に,ほとんどのプロパティを既定の設定にリセット(詳細は,次の表を参照)

图と座標軸のNextPlotプロパティが,newplotの動作を決定します。2次のつの表に,プロパティ値と共にそれらの動作を説明します。

最初に,newplot图のは現在のNextPlotプロパティを読み取り,それに従って動作します。

NextPlot

動作

新規图を作成し,現在の图として利用します。

添加

既存のグラフィックスオブジェクトを消去せずに,現在の图に描画します。

replacechildren

HandleVisibilityプロパティがに設定されているすべての子オブジェクトを削除し,图のNextPlotプロパティを添加にリセットします。

コマンドclfの実行と同じように,現在の图オブジェクトを消去します。

取代

すべての子オブジェクトを(HandleVisibilityプロパティの設定にかかわらず)削除し,次の例外を除いて,图のプロパティを既定の設定にリセットします。

関数NextPlotは,ユーザー定義の既定の設定にかかわらず,添加にリセットされます。

これは,現在の图を消去してリセットし,コマンドclf重置を実行することと等価です。

newplotは,どの图に描画するかを決めてから,現在のの轴NextPlotプロパティを読み込み,次のように実行します。

NextPlot

説明

添加

既存の座標軸に新しいプロットを追加します。新しいプロットを表示する前に,既存のプロットの削除や,座標軸のプロパティのリセットは行いません。

replacechildren

既存のプロットを削除してから,新しいプロットを表示します。ColorOrderIndexおよびLineStyleOrderIndex1座標軸プロパティをにリセットしますが,座標軸のその他のプロパティはリセットしません。座標軸に次のプロットを追加すると,座標軸のColorOrderプロパティとLineStyleOrderプロパティに基づいて最初の色とラインスタイルが使用されます。この値は,個々の新しいプロットの前にを使用する場合と似ています。

取代

既存のプロットを削除し,位置单位を除くすべての座標軸のプロパティを既定値にリセットしてから新しいプロットを表示します。

replaceall

既存のプロットを削除し,位置单位を除くすべての座標軸のプロパティを既定値にリセットしてから新しいプロットを表示します。この値は,個々の新しいプロットの前にcla重置を使用する場合と似ています。

y軸を1本のみもつ座標軸の場合,取代replaceallの値は等しくなります。y軸を2本もつ座標軸の場合,取代の値はアクティブな側にのみ影響しますが,replaceallの値は両側に影響します。

R2006aより前に導入