clf

Borrar una figura

Sintaxis

clf

clf(fig)

clf('reset')

clf(fig,'reset')

f = clf(___)

Descripción

clf elimina todos los elementos secundarios de la figura actual que tengan identificadores visibles.

clf(fig) elimina todos los elementos secundarios de la figura especificada que tengan identificadores visibles.

clf('reset') elimina todos los elementos secundarios de la figura actual independientemente de la visibilidad de su identificador. También restablece las propiedades de la figura en sus valores predeterminados, salvo algunas propiedades de figura que no se ven afectadas por el restablecimiento. De manera alternativa, puede restablecer la figura utilizando el comando clf reset sin paréntesis.

clf(fig,'reset') elimina todos los elementos secundarios de la figura especificada y restablece sus propiedades.

f = clf(___) devuelve la figura para cualquiera de las sintaxis anteriores.

Ejemplos

Borrar la figura actual

Cree una gráfica de líneas. A continuación, establezca el color de fondo de la figura actual.

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

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

Borre la figura utilizando una llamada a clf. La llamada a la función elimina la gráfica. Sin embargo, no afecta al color de fondo de la figura.

clf

Ahora, restablezca las propiedades de la figura y devuelva los elementos secundarios de la figura. clf('reset') restablece el color de fondo a su valor predeterminado.

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

ans = 
  0×0 empty GraphicsPlaceholder array.

Borrar una figura especificada

Cree dos figuras, cada una de ellas con una gráfica de líneas. A continuación, establezca el color de fondo de la primera figura.

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

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

Borre la gráfica de líneas de la primera figura sin restablecer el color de fondo de la primera figura.

clf(f1)

Ahora, restablezca todas las propiedades de la primera figura.

clf(f1,'reset')

Borrar una figura y restablecer las propiedades de una figura

Cree una figura con un fondo blanco. Luego, cree una gráfica de superficie.

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) 
 

Borre la gráfica de superficie de la figura y restablezca todas las propiedades de la figura en sus valores predeterminados. clf reset restablece todas las propiedades de la figura actual, salvo las propiedades Position, Units, PaperPosition y PaperUnits.

clf reset

Argumentos de entrada

fig — Figura objetivo

objeto Figure | número de figura | arreglo de objetos Figure o números

Figura objetivo, especificada como objeto Figure, número de figura o arreglo de objetos Figure o números.

Si fig contiene un número de figura, MATLAB^® busca una figura existente que tenga la propiedad Number establecida en ese número. De forma predeterminada, la propiedad Number se muestra en el título de la figura.

Ejemplo: clf(f) borra el objeto Figure f.

Ejemplo: clf(1) borra el número de figura 1.

Ejemplo: clf([1 f]) borra el número de figura 1 y el objeto Figure f.

Más acerca de

Identificadores visibles

Un identificador es visible para clf si la propiedad HandleVisibility del objeto está establecida en 'on'. Cuando llama a clf en la ventana de comandos o dentro de una rutina de callback, la función solo elimina aquellos objetos cuya propiedad HandleVisibility está establecida en 'on'. No elimina objetos cuya propiedad HandleVisibility está establecida en 'callback' o 'off'.

Propiedades de figura no afectadas por el restablecimiento

Cuando clf restablece las propiedades de una figura, algunas propiedades no se restablecen. Estas propiedades incluyen:

• Las propiedades que no tienen un valor predeterminado, como Number.

• Las propiedades que tienen un valor que depende de la interacción del usuario, como CurrentObject y SelectionType.

• Las propiedades que controlan el tamaño de la figura, como Position y Units.

• Las propiedades que controlan el comportamiento y las herramientas de la ventana de la figura, como WindowStyle, MenuBar y ToolBar.

Sugerencias

• Para borrar el contenido de una figura, puede utilizar de manera alternativa Clear Figure en el menú Edit de la ventana de la figura. Con Clear Figure se eliminan todos los elementos secundarios de la figura que tenga identificadores visibles.

Historial de versiones

Introducido antes de R2006a

R2024b: La barra de menú de la figura y la barra de herramientas no se ven afectadas por el restablecimiento

Cuando llama a clf('reset') para restablecer las propiedades de la figura, las propiedades MenuBar y ToolBar no se ven afectadas.

R2024a: Borrar varias figuras a la vez

Borrar varias figuras a la vez especificando el argumento fig como un arreglo de objetos Figure o números de figura.

Consulte también

Funciones

• cla | clc | hold | reset

Objetos

• Figure