set

Obtener las propiedades de los objetos de gráficas

Sintaxis

set(h,Name,Value)

set(h,defaultTypeProperty,defaultValue)

set(h,NameArray,ValueArray)

set(h,a)

s = set(h)

v = set(h,propertyName)

Descripción

set(h,Name,Value) establece las propiedades del objeto de gráficas h especificado utilizando uno o más argumentos nombre-valor. Si h es un vector de objetos, set establece las propiedades de todos los objetos de h. Si h está vacío ([ ]), set no hace nada y no devuelve un error o advertencia.

Para obtener más información sobre las propiedades que puede establecer, consulte las páginas de las propiedades de cada objeto; por ejemplo, Figure Properties, Axes Properties, Line Properties y Text Properties.

set(h,defaultTypeProperty,defaultValue) cambia el valor predeterminado de la propiedad y el tipo de objeto especificados para el objeto de gráficas h especificado utilizando uno o más pares de nombres y valores de propiedades. defaultTypeProperty es la palabra default concatenada con el tipo de objeto (por ejemplo, Figure) y el nombre de la propiedad (por ejemplo, Color) entre comillas. Por ejemplo, set(groot,"defaultFigureColor","red") cambia el valor predeterminado de la propiedad Color de los objetos Figure a red para el objeto de gráficas raíz groot.

set(h,NameArray,ValueArray) establece múltiples propiedades para el objeto de gráficas h especificado.

• Si h es un objeto escalar, especifique NameArray y ValueArray como arreglos de celdas de 1 por n que contienen uno o más nombres o valores de propiedades, donde n es igual al número de propiedades que se establece.

• Si h es un vector de objetos, para establecer un valor de propiedad diferente para cada objeto de h, especifique ValueArray como un arreglo de celdas de m por n, donde m es igual al número de elementos de h y n es igual al número de nombres de propiedades que contiene NameArray.

set(h,a) establece múltiples propiedades utilizando a, una estructura cuyos nombres de campos son los nombres de las propiedades de objeto y cuyos valores de campo son los valores correspondientes de las propiedades. Si a está vacío, set no hace nada y no devuelve un error o advertencia.

s = set(h) devuelve las propiedades configurables por el usuario y los posibles valores para el objeto de gráficas h especificado. h debe ser un único objeto. Esta sintaxis no cambia las propiedades de h.

Si s no se especifica, set muestra las propiedades configurables por el usuario y los posibles valores en la ventana de comandos.

v = set(h,propertyName): devuelve los valores posibles para la propiedad especificada. Si los valores posibles son cadenas o vectores de caracteres, set devuelve un arreglo de celdas que contiene los valores. Para otras propiedades que no tienen un conjunto fijo de valores, set devuelve un arreglo de celdas vacío. h debe ser un único objeto. Esta sintaxis no cambia las propiedades de h.

Si v no se especifica, set muestra los posibles valores en la ventana de comandos.

Ejemplos

Establecer la propiedad de un objeto

Cree una gráfica de líneas y devuelva el objeto Line como p. Establezca la propiedad Color de la línea en "red".

p = plot(1:10);
set(p,"Color","red")

Establecer la propiedad de varios objetos

Cree una figura con tres botones y colóquelos en el arreglo btns. Establezca la propiedad FontColor de todos los botones como "red".

fig = uifigure;
btn1 = uibutton(fig,"Position",[100 100 100 20]);
btn2 = uibutton(fig,"Position",[100 75 100 20]);
btn3 = uibutton(fig,"Position",[100 50 100 20]);
btns = [btn1 btn2 btn3];
set(btns,"FontColor","red")

Establecer distintos valores para la propiedad de varios objetos

Cree una gráfica con cuatro líneas utilizando datos aleatorios y devuelva los cuatro objetos de Line como p. Establezca la propiedad LineStyle en un valor diferente para cada uno de los cuatro objetos de Line. Trasponga la lista de valores de LineStyle de un vector fila a un vector columna para que coincida con la forma de p.

p = plot(rand(4));
NameArray = {'LineStyle'};
ValueArray = transpose({'-','--',':','-.'});
set(p,NameArray,ValueArray)

Establecer múltiples propiedades para varios objetos

Represente una secuencia de datos discretos y devuelva los tres objetos Stem como st. Establezca las propiedades Marker y Tag de los tres objetos Stem diferentes en distintos valores. Cada fila del arreglo de celdas de valores se corresponde con un objeto en st y contiene dos valores, uno para la propiedad Marker y otro para la propiedad Tag.

x = 0:30;
y = [1.5*cos(x); 4*exp(-.1*x).*cos(x); exp(.05*x).*cos(x)]';
st = stem(x,y);
NameArray = {'Marker','Tag'};
ValueArray = {'o','Decaying Exponential'; ...
   'square','Growing Exponential'; ...
   '*','Steady State'};
set(st,NameArray,ValueArray)

Establecer propiedades utilizando una estructura

Cree una figura y devuelva las propiedades configurables por el usuario y los posibles valores.

fig = uifigure;
s = set(fig);

Muestre los posibles valores para la propiedad Pointer.

s.Pointer

ans = 17x1 cell
    {'arrow'    }
    {'ibeam'    }
    {'crosshair'}
    {'watch'    }
    {'topl'     }
    {'topr'     }
    {'botl'     }
    {'botr'     }
    {'circle'   }
    {'cross'    }
    {'fleur'    }
    {'custom'   }
    {'left'     }
    {'top'      }
    {'right'    }
    {'bottom'   }
    {'hand'     }

Cree una estructura con los campos Name, Color y Pointer, y utilícela para establecer esas propiedades para la figura.

a.Name = "My App";
a.Color = "red";
a.Pointer = "crosshair";

set(fig,a)

Argumentos de entrada

h — Objetos de gráficas

objeto único | vector de objetos

Objeto de gráficas, especificado como un objeto único o un vector de objetos.

Nota

No utilice la función set en objetos Java^®, ya que se producirá una pérdida de memoria. Para obtener más información, consulte Access Public and Private Data.

Name,Value — Pares de propiedad y valor

Name1=Value1,...,NameN=ValueN | "Name1",Value1,...,"NameN",ValueN

Pares de propiedad y valor, especificados como Name1=Value1,...,NameN=ValueN, donde Name es igual al nombre de la propiedad y Value es el valor correspondiente.

Cada tipo de objeto es compatible con un conjunto de propiedades diferente. Para obtener una lista completa de las propiedades y descripciones de cada tipo, consulte la página de propiedades del objeto asociado (por ejemplo, Figure Properties, Axes Properties, Line Properties, y Text Properties).

Para establecer los valores de las propiedades, especifique el nombre seguido de un signo igual (=) y el valor correspondiente. Por ejemplo, set(h,Color="red").

En las versiones anteriores a R2021a, utilice comas para separar cada nombre y valor, y encierre Name entre comillas. Por ejemplo, set(h,"Color","red").

Para establecer una propiedad en sus valores predeterminados, especifique el valor de la propiedad como la palabra default entre comillas. Por ejemplo, set(h,"Color","default").

Para obtener más información sobre cómo establecer los valores predeterminados, consulte Valores predeterminados de las propiedades.

defaultTypeProperty,defaultValue — Pares de propiedad y valor predeterminados

defaultTypeProperty1=defaultValue1,...,defaultTypePropertyN=defaultValueN | "defaultTypeProperty1",defaultValue1,...,"defaultTypePropertyN",defaultValueN

Pares de propiedad y valor predeterminados, especificados como defaultTypeProperty1=defaultValue1,...,defaultTypePropertyN=defaultValueN, donde defaultTypeProperty es la palabra default concatenada con el tipo de objeto (por ejemplo, Figure) y el nombre de la propiedad (por ejemplo, Color), y defaultValue es el valor predeterminado correspondiente.

Para cambiar los valores de propiedad predeterminados, especifique defaultTypeProperty seguido de un signo igual (=) y el valor predeterminado correspondiente. Por ejemplo, set(h,defaultFigureColor="red").

En las versiones anteriores a R2021a, utilice comas para separar cada nombre y valor, y encierre Name entre comillas. Por ejemplo, set(h,"defaultFigureColor","red").

Para eliminar el valor predeterminado de una propiedad, especifique el valor de la propiedad como la palabra remove entre comillas. Por ejemplo, set(h,"defaultFigureColor","remove").

Para obtener más información sobre cómo establecer los valores predeterminados, consulte Valores predeterminados de las propiedades.

NameArray — Nombres de propiedades

arreglo de celdas

Nombres de propiedades, especificados como un arreglo de celdas que contienen uno o más nombres de propiedad.

ValueArray — Valores de propiedades

arreglo de celdas

Valores de propiedades, especificados como un arreglo de celdas de m por n, donde m es el número de elementos de h y n es el número de nombres de propiedades que contiene NameArray.

a — Nombres y valores de propiedades de objeto

estructura

Nombres y valores de propiedades de objeto, especificados como una estructura cuyos nombres de campos son los nombres de las propiedades del objeto y cuyos valores de campos son los valores correspondientes de las propiedades.

propertyName — Nombre de propiedad

escalar de cadena | vector de caracteres

Nombre de propiedad, especificado como un escalar de cadena o un vector de caracteres.

Argumentos de salida

s — Nombres y valores de propiedades

estructura

Nombres de propiedades y sus valores, devueltos como una estructura. En la estructura, los nombres de campo son los nombres de las propiedades del objeto, y los valores de campo son los posibles valores de las propiedades correspondientes.

v — Valores de propiedad posibles

arreglo de celdas

Valores de propiedad posibles, devueltos como un arreglo de celdas. Si los valores posibles son cadenas o vectores de caracteres, set devuelve un arreglo de celdas que contiene los valores. Para otras propiedades que no tienen un conjunto fijo de valores, set devuelve un arreglo de celdas vacío.

Sugerencias

• Cuando establezca las propiedades FontSize y FontUnits en la misma instrucción set, especifique primero la propiedad FontUnits. Este orden permite que la función set interprete la propiedad FontSize especificada como se espera. Del mismo modo, cuando establezca las unidades de figuras y ejes, establezca la propiedad Units antes que el resto de propiedades cuyos valores se calculan utilizando las unidades especificadas. Por ejemplo, este comando establece la propiedad Units antes que Position, cuya medida se basa en las unidades especificadas por la propiedad Units.

  f = figure;
  set(f,"Units","characters","Position",[30 30 120 35]);

Historial de versiones

Introducido antes de R2006a

Consulte también

Funciones

• findobj | gco | get | gcf | gcbo | gca | groot

Temas

• Propiedades de objetos de gráficas
• Valores predeterminados de las propiedades