Main Content

set

Obtener las propiedades de los objetos de gráficas

contraer todo en la página

    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

    ejemplo

    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.

    ejemplo

    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.

    ejemplo

    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.

    ejemplo

    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

    contraer todo

    Abrir script en vivo

    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")

    Figure contains an axes object. The axes object contains an object of type line.

    Abrir script en vivo

    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")

    Figure contains objects of type uibutton.

    Abrir script en vivo

    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)

    Figure contains an axes object. The axes object contains 4 objects of type line.

    Abrir script en vivo

    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)

    Figure contains an axes object. The axes object contains 3 objects of type stem.

    Abrir script en vivo

    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

    contraer todo

    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.

    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.

    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.

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

    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.

    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.

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

    Argumentos de salida

    contraer todo

    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.

    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

    Temas