cla

座標軸のクリア

構文

cla

cla(ax)

cla reset

cla(ax,'reset')

説明

cla は、現在の座標軸から、ハンドルが表示されているすべてのグラフィックス オブジェクトを削除します。ハンドルはオブジェクトの HandleVisibility プロパティが 'on' に設定されている場合に表示されます。座標軸に次のプロットを追加すると、座標軸の ColorOrder プロパティと LineStyleOrder プロパティに基づいて最初の色とライン スタイルが使用されます。座標軸が存在しない場合、このコマンドは座標軸を作成します。

cla(ax) は、現在の座標軸ではなく、ax で指定された座標軸、極座標軸、または地理座標軸からグラフィックス オブジェクトを削除します。

cla reset は、ハンドルが表示されているかどうかに関係なく、現在の座標軸からグラフィックス オブジェクトを削除します。さらに、Position プロパティと Units プロパティを除く座標軸のプロパティを既定値にリセットします。

cla(ax,'reset') は、指定された座標軸のプロパティをリセットします。

例

現在の座標軸をクリア

2 つの正弦波をプロットします。その後、座標軸のライン プロットをクリアします。

x = linspace(0,2*pi);
y1 = sin(x);
plot(x,y1)

hold on
y2 = sin(2*x);
plot(x,y2)

cla

cla は、ライン プロットをクリアし、座標軸の ColorIndex プロパティと LineStyleIndex プロパティを 1 にリセットします。次のプロットは、色とライン スタイルの順序の最初から始まります。たとえば、正弦波をもう 1 つプロットしてみます。

y3 = sin(3*x);
plot(x,y3)
hold off

特定の座標軸のクリア

関数 tiledlayout および関数 nexttile を使用して、プロットをタイル表示できます。関数 tiledlayout を呼び出して、2 行 1 列のタイル表示チャート レイアウトを作成します。関数 nexttile を呼び出して、axes オブジェクト ax1 および ax2 を作成します。両方の座標軸にプロットを追加します。

tiledlayout(2,1)
ax1 = nexttile;
surf(ax1,peaks)

ax2 = nexttile;
contour(ax2,peaks)

ax1 を cla の入力引数として指定して、上の座標軸から表面プロットをクリアします。

cla(ax1)

次に、オプションの入力引数 'reset' を使用して、座標軸のプロパティ (表示を制御するカメラのプロパティも含む) をすべてリセットします。

cla(ax1,'reset')

座標軸をクリアして座標軸のすべてのプロパティをリセット

ライン プロットを作成し、軸の範囲を設定します。

x = linspace(0,2*pi);
y = sin(x);
plot(x,y)
axis([0 5 -2 2])

座標軸のライン プロットをクリアし、座標軸のすべてのプロパティを既定値にリセットします。cla reset は、Position プロパティと Units プロパティを除く現在の座標軸のプロパティをすべてリセットします。

cla reset

入力引数

ax — ターゲット座標軸

任意のタイプの axes オブジェクト | axes オブジェクトの配列

ターゲット座標軸。次のいずれかの項目として指定します。

• Axes、PolarAxes、GeographicAxes オブジェクトなど、任意のタイプの axes オブジェクト

• axes オブジェクトの配列

ターゲット座標軸を指定しない場合、cla は現在の座標軸 (gca) をクリアします。

アルゴリズム

cla コマンドは、現在の座標軸の ColorOrderIndex プロパティと LineStyleOrderIndex プロパティを 1 にリセットします。

バージョン履歴

R2006a より前に導入

R2024a: 複数の座標軸を一度にクリア

ax 引数を axes オブジェクトの配列として指定することで、複数の座標軸を一度にクリアします。

参考

関数

• clf | hold | reset | newplot

プロパティ

• Axes のプロパティ