set
グラフィックス オブジェクトのプロパティの設定
構文
説明
set( は、1 つ以上の名前と値の引数を使用して、指定したグラフィックス オブジェクト h,Name,Value)h のプロパティを設定します。h がオブジェクトのベクトルの場合、set はプロパティを h のすべてのオブジェクトに設定します。h が空 ([ ]) の場合、set は何もせず、警告やエラーを返しません。
設定できるプロパティの詳細については、Figure、Axes のプロパティ、Line のプロパティ、Text のプロパティ など、各オブジェクトのプロパティ ページを参照してください。
set( は、プロパティの名前と値の 1 つ以上のペアを使用して指定したグラフィックス オブジェクト h,defaultTypeProperty,defaultValue)h の指定したプロパティおよびオブジェクト タイプの既定値を変更します。defaultTypeProperty は、default という単語にオブジェクト タイプ (Figure など) とプロパティ名 (Color など) を連結し、引用符で囲んだものです。たとえば、set(groot,"defaultFigureColor","red") は、Figure オブジェクトの Color プロパティの既定値をグラフィックス ルート オブジェクト groot の red に変更します。
set( は、指定したグラフィックス オブジェクト h,NameArray,ValueArray)h の複数のプロパティを設定します。
hがスカラー オブジェクトの場合、1 つ以上のプロパティの名前または値を含む 1 行 n 列の cell 配列としてNameArrayおよびValueArrayを指定します。ここで、n は設定するプロパティの数です。hがオブジェクトのベクトルの場合、hの各オブジェクトの各種プロパティ値を設定するには、ValueArrayを m 行 n 列の cell 配列として指定します。ここで、m はhの要素数、n はNameArrayに含まれるプロパティ名の数です。
v = set(h,propertyName)set は値を含む cell 配列を返します。固定の一連の値をもたないその他のプロパティの場合、set は空の cell 配列を返します。h は単一のオブジェクトでなければなりません。この構文では h のプロパティは変更されません。
v を指定しなかった場合、set はコマンド ウィンドウに取り得る値を表示します。
例
ライン プロットを作成して、Line オブジェクトを p として返します。ラインの Color プロパティを "red" に設定します。
p = plot(1:10); set(p,"Color","red")
3 つのボタンをもつ Figure を作成し、それらのボタンを配列 btns に入れます。すべてのボタンの FontColor プロパティを "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")
乱数データを使用して 4 つのラインをもつプロットを作成し、これら 4 つの Line オブジェクトを p に返します。4 つの Line オブジェクトのそれぞれの LineStyle プロパティを異なる値に設定します。LineStyle 値のリストを行ベクトルから列ベクトルに転置し、p の形状に合わせます。
p = plot(rand(4));
NameArray = {'LineStyle'};
ValueArray = transpose({'-','--',':','-.'});
set(p,NameArray,ValueArray)
離散データ シーケンスをプロットし、3 つの Stem オブジェクトを st として返します。3 つの異なる Stem オブジェクトの Marker および Tag プロパティを異なる値に設定します。値の cell 配列の各行は st のオブジェクトに対応し、2 つの値が含まれます。1 つは Marker プロパティの値で、もう 1 つは 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 を作成し、Figure のユーザーが設定可能なプロパティおよび取り得る値を返します。
fig = uifigure; s = set(fig);
Pointer プロパティの取り得る値を表示します。
s.Pointer
ans = 17×1 cell
{'arrow' }
{'ibeam' }
{'crosshair'}
{'watch' }
{'topl' }
{'topr' }
{'botl' }
{'botr' }
{'circle' }
{'cross' }
{'fleur' }
{'custom' }
{'left' }
{'top' }
{'right' }
{'bottom' }
{'hand' }
Name、Color、および Pointer フィールドをもつ構造体を作成し、その構造体を使用して Figure の該当するプロパティを設定します。
a.Name = "My App"; a.Color = "red"; a.Pointer = "crosshair"; set(fig,a)
入力引数
出力引数
ヒント
同じ
setステートメントでFontSizeプロパティとFontUnitsプロパティを設定する場合は、FontUnitsプロパティを先に指定します。この順序にすることで、関数setは指定したFontSizeを意図したように解釈できます。同様に、Figure や座標軸の単位を設定する場合は、Unitsプロパティを先に設定してから、指定した単位を使用して計算される値をもつ追加のプロパティを設定します。たとえば、次のコマンドでは、Unitsプロパティを先に設定してから、Unitsプロパティで指定した単位の測定値をもつPositionプロパティを設定しています。f = figure; set(f,"Units","characters","Position",[30 30 120 35]);
バージョン履歴
R2006a より前に導入
