このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

clf

Figure のクリア

構文

clf

clf(fig)

clf('reset')

clf(fig,'reset')

f = clf(___)

説明

clf は、現在の Figure に属する子のうち、ハンドルが表示されているすべての子を削除します。

clf(fig) は、指定した Figure に属する子のうち、ハンドルが表示されているすべての子を削除します。

clf('reset') は、ハンドルが表示されているかどうかに関係なく、現在の Figure の子をすべて削除します。また、一部のリセットの影響を受けない Figure プロパティを除き、Figure プロパティを既定値にリセットします。あるいは、かっこなしで clf reset コマンドを使用して Figure をリセットできます。

clf(fig,'reset') は、指定した Figure のすべての子を削除し、プロパティをリセットします。

f = clf(___) は、前述のいずれの構文についても Figure を返します。

例

現在の Figure のクリア

ライン プロットを作成します。次に、現在の Figure の背景色を設定します。

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

f = gcf;
f.Color = [0 0.5 0.5];

clf への呼び出し使用して、Figure をクリアします。関数呼び出しによりプロットが削除されます。しかし、Figure の背景色には影響しません。

clf

ここで、Figure のプロパティをリセットし、Figure の子を返します。clf('reset') で背景色を既定値にリセットします。

f = clf('reset');
f.Children

ans = 
  0×0 empty GraphicsPlaceholder array.

特定の Figure のクリア

それぞれがライン プロットをもつ 2 つの Figure を作成します。1 つ目の Figure の背景色を設定します。

f1 = figure('Color','b');
plot(1:10)

f2 = figure;
plot((1:10).^2)

1 つ目の Figure の背景色をリセットすることなく、この Figure からライン プロットをクリアします。

clf(f1)

ここで、1 つ目の Figure のプロパティをすべてリセットします。

clf(f1,'reset')

Figure のクリアおよび Figure のプロパティのリセット

白の背景色をもつ Figure を作成します。次に、表面のプロットを作成します。

figure('Color','w')
peaks

 
z =  3*(1-x).^2.*exp(-(x.^2) - (y+1).^2) ... 
   - 10*(x/5 - x.^3 - y.^5).*exp(-x.^2-y.^2) ... 
   - 1/3*exp(-(x+1).^2 - y.^2) 
 

Figure の表面プロットをクリアし、Figure のすべてのプロパティを既定値にリセットします。clf reset は、Position プロパティ、Units プロパティ、PaperPosition プロパティと PaperUnits プロパティを除く現在の Figure のプロパティをすべてリセットします。

clf reset

入力引数

fig — ターゲット Figure

Figure オブジェクト | Figure 番号 | Figure オブジェクトまたは番号の配列

ターゲット Figure。Figure オブジェクト、Figure 番号、または Figure オブジェクトまたは番号の配列として指定します。

fig に Figure 番号が含まれている場合、MATLAB^® は Number プロパティがその番号に設定されている既存の Figure を検索します。既定で Number プロパティは、Figure のタイトルに表示されます。

例: clf(f) は Figure オブジェクト f をクリアします。

例: clf(1) は Figure 番号 1 をクリアします。

例: clf([1 f]) は Figure 番号 1 と Figure オブジェクト f をクリアします。

詳細

認識できるハンドル

ハンドルは、オブジェクトの HandleVisibility プロパティが 'on' に設定されている場合、clf に認識されます。コマンド ウィンドウまたはコールバック ルーチン内で clf を呼び出すと、HandleVisibility プロパティが 'on' に設定されているオブジェクトのみを削除します。HandleVisibility プロパティが 'callback' または 'off' に設定されているオブジェクトを削除しません。

リセットの影響を受けない Figure プロパティ

clf が Figure のプロパティをリセットするとき、一部のプロパティはリセットされません。これらのプロパティには、以下が含まれます。

• Number など、既定値をもたないプロパティ

• CurrentObject や SelectionType など、ユーザー操作に依存する値をもつプロパティ

• Position や Units など、Figure のサイズを制御するプロパティ

• WindowStyle、MenuBar、ToolBar など、Figure ウィンドウの動作とツールを制御するプロパティ

ヒント

• Figure の内容をクリアするには、Figure ウィンドウの [エディット] メニューから [Figure のクリア] も使用できます。[Figure のクリア] を使用して、Figure に属する子のうち、ハンドルが表示されているすべての子を削除します。

バージョン履歴

R2006a より前に導入

R2024b: Figure のメニュー バーとツール バーはリセットの影響を受けない

clf('reset') を呼び出して Figure プロパティをリセットしても、MenuBar および ToolBar プロパティは影響を受けません。

R2024a: 複数の Figure を一度にクリア

fig 引数を Figure オブジェクトまたは Figure 番号の配列として指定することで、複数の Figure を一度にクリアします。

参考

関数

• cla | clc | hold | reset

オブジェクト

• Figure