Valores predeterminados de las propiedades

Valores predefinidos para las propiedades

Prácticamente todas las propiedades de los objetos de gráficas tienen valores predefinidos. Los valores predefinidos se originan a partir de dos posibles fuentes:

Los valores predeterminados definidos en un antecesor del objeto
Los valores de fábrica definidos en la raíz de la jerarquía de objetos de gráficas

Los usuarios pueden crear valores predeterminados para una propiedad de objeto, que tienen prioridad sobre los valores definidos de fábrica. Los objetos utilizan los valores predeterminados cuando:

Se crean en una jerarquía en la que un antecesor define un valor predeterminado
Se asignan a una jerarquía en la que un antecesor define un valor predeterminado

Especificar valores predeterminados

Defina un valor predeterminado de propiedad como cadena con estas tres partes:

"default" ObjectType PropertyName

La palabra default
El tipo de objeto (por ejemplo, Line)
El nombre de la propiedad (por ejemplo, LineWidth)

Una cadena que especificase el LineWidth de la línea predeterminada sería:

"defaultLineLineWidth"

Utilice esta cadena para especificar el valor predeterminado. Por ejemplo, para especificar un valor predeterminado de dos puntos en la propiedad LineWidth de la línea, utilice la instrucción:

set(groot,"defaultLineLineWidth",2)

También puede utilizar la sintaxis Name=Value y omitir las comillas.

set(groot,defaultLineLineWidth=2)

La cadena defaultLineLineWidth identifica la propiedad como una propiedad de línea. Para especificar el color de la figura, utilice defaultFigureColor.

set(groot,defaultFigureColor="blue")

Lugar en la jerarquía para definir el valor predeterminado

En general, debe definir un valor predeterminado en el nivel de raíz para que todas las funciones de representación posteriores utilicen dichos valores predeterminados. Especifique la raíz en las instrucciones set y get mediante la función groot, que devuelve el identificador a la raíz.

Puede definir valores predeterminados de las propiedades en tres niveles:

Raíz: los valores se aplican a los objetos creados en la sesión de MATLAB^® actual
Figura: se utiliza para los valores predeterminados aplicados en el elemento secundario de la figura que define los valores predeterminados.
Ejes: se utiliza para los valores predeterminados aplicados únicamente en el elemento secundario de los ejes que define los valores predeterminados y solo cuando se utilizan las funciones de bajo nivel (light, line, patch, rectangle, surface, text y la forma de bajo nivel de image).

Por ejemplo, especifique un color de figura predeterminado únicamente en el nivel de raíz.

set(groot,defaultFigureColor="blue")

Mostrar los valores predeterminados

Utilice get para determinar los valores predeterminados establecidos actualmente en cualquier nivel de objeto determinado. Este comando devuelve todos los valores predeterminados establecidos en la sesión de MATLAB actual.

get(groot,"default")

Establecer propiedades al valor predeterminado actual

Al especificar un valor de propiedad de "default", la propiedad se establece al primer valor predeterminado que se encuentre definido para dicha propiedad. Por ejemplo, estas instrucciones dan como resultado el EdgeColor de superficie verde:

set(groot,defaultSurfaceEdgeColor="black")
h = surface(peaks);
set(gcf,defaultSurfaceEdgeColor="g")
set(h,EdgeColor="default")

Puesto que hay disponible un valor predeterminado para el EdgeColor de superficie en el nivel de la figura, MATLAB encuentra este valor en primer lugar y lo utiliza en lugar del EdgeColor predeterminado definido en la raíz.

Eliminar valores predeterminados

Al especificar un valor de propiedad de "remove", se eliminan los valores predeterminados definidos por el usuario. Este comando elimina la definición del EdgeColor de superficie predeterminado de la raíz.

set(groot,defaultSurfaceEdgeColor="remove")

Establecer propiedades a los valores definidos de fábrica

Al especificar un valor de propiedad de "factory", la propiedad se establece a su valor definido de fábrica. Por ejemplo, estas instrucciones establecen el EdgeColor de superficie h a negro (su ajuste de fábrica), independientemente de los valores predeterminados que se hayan definido:

set(gcf,defaultSurfaceEdgeColor="green")
h = surface(peaks);
set(h,EdgeColor="factory")

Mostrar los valores de propiedad definidos de fábrica

Puede mostrar los valores de fábrica:

get(groot,"factory"): enumere todos los valores de propiedad definidos de fábrica para todos los objetos de gráficas
get(groot,"factoryObjectType"): enumere todos los valores de propiedad definidos de fábrica para un objeto específico
get(groot,"factoryObjectTypePropertyName"): enumere el valor definido de fábrica para la propiedad especificada.

Palabras reservadas

Al establecer un valor de propiedad en default, remove o factory, se producen los efectos descritos en las secciones anteriores. Para establecer una propiedad en una de estas palabras (por ejemplo, una propiedad String de texto establecida en la palabra default), anteceda la palabra con el carácter de barra diagonal inversa:

h = text(String="\default");

Efecto de los temas de figura en los valores predeterminados

Desde R2025a

Muchos valores predeterminados de propiedades de color y algunos valores predeterminados de propiedades de transparencia cambian según el tema. Por ejemplo, el color predeterminado de los objetos Text en el tema claro es un tono oscuro de gris.

f = figure(Theme="light");
get(f,"DefaultTextColor")

ans =

    0.1294    0.1294    0.1294

Si cambia el tema de la figura, el color predeterminado es un tono de gris mucho más claro.

f.Theme = "dark";
get(f,"DefaultTextColor")

ans =

    0.8510    0.8510    0.8510

Sin embargo, los valores predeterminados de fábrica dependen del tema predeterminado de la figura con independencia del tema de la figura actual. Por ejemplo, si el nombre predeterminado de la figura es "light", el color del texto predeterminado de fábrica es oscuro.

get(f,"FactoryTextColor")

ans =

    0.1294    0.1294    0.1294

Nota

No puede definir u obtener el valor predeterminado del tema de la figura usando la sintaxis predeterminada. En su lugar, utilice la ventana de configuración de MATLAB. En la pestaña Home del escritorio de MATLAB, en la sección Environment, haga clic en Settings y seleccione MATLAB > Appearance. Después, seleccione un elemento del menú Figure Theme.

Si especifica el valor predeterminado de una propiedad, ese valor predeterminado se mantiene incluso si cambia el tema de la figura. Por ejemplo, establezca el color predeterminado del objeto Text en [1 0 0] (rojo).

set(f,"DefaultTextColor",[1 0 0])
get(f,"DefaultTextColor")

ans =

    1    0    0

Cambie el tema de la figura y obtenga nuevamente el color de texto predeterminado. El valor sigue siendo rojo.

f.Theme = "light";
get(f,"DefaultTextColor")

ans =

    1    0    0