主要内容

このペ,ジの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。

BoxChartのプロパティ

ボックスチャ,トの外観と動作の制御

BoxChartプロパティは,BoxChartオブジェクトの外観と動作を制御します。プロパティの値を変更することによって、オブジェクトの一部の特性を変更できます。

プロパティのクエリと設定にドット表記を使用できます。たとえば、ボックス チャートのボックスの色を変更できます。

B = boxchart(rand(10,1));b.BoxFaceColor = [0 0.5 0.5];

デ,タの表示

すべて展開する

個々のボックスの相対的な幅。範囲[0, 1]のスカラ,値として指定します。このプロパティは,ボックスの間隔を制御するのに使用します。既定値は0.5です。1。このプロパティを1に設定すると,ボックスが隙間なく表示されます。

例:b = boxchart(rand(10,3),'BoxWidth',0.75)

例:b.BoxWidth = 0.75;

外れ値マ,カ,変位。“上”または“关闭”もしくは数値または逻辑1真正的)または0)として指定します。“上”の値は真正的と等価であり,“关闭”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型のon/off逻辑値として格納されます。

JitterOutliersプロパティを“上”に設定すると,boxchartは外れ値のマ,カ,をXData方向にランダムに変位するため,類似するydata値をも外れ値が区別しやすくなります。例にいては,外れ値の可視化と検出を参照してください。

例:b = boxchart([兰德(20日1);2;2;2],“JitterOutliers”,“上”)

例:b.JitterOutliers = 'on';

中央値比較表示。“上”または“关闭”もしくは数値または逻辑1真正的)または0)として指定します。“上”の値は真正的と等価であり,“关闭”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型のon/off逻辑値として格納されます。

切口プロパティを“上”に設定すると,boxchartにより,各中央値の周りに先細の影付き領域が作成されます。ノッチがオ,バ,ラップしないボックスチャ,トには,5%の有意水準で異なる中央値があります。詳細にいては,ボックスチャ,ト(箱ひげ図)を参照してください。

ノッチは下位四分位数と上位四分位数を超えて拡張できます。

例:b = boxchart(rand(10,2),'Notch','on')

例:b.Notch = 'on';

ボックスチャ,トの方向。“垂直”または“水平”として指定します。通常の設定では,ボックスチャ,トの方向は垂直であるため、ydata統計はy軸に揃えられます。方向に関係なく,boxchartydata値をBoxChartオブジェクトのYDataプロパティに格納します。

例:b = boxchart(rand(10,1),'Orientation','horizontal')

例:b.方向=“水平”;

色とスタ@ @ル

すべて展開する

ボックスの色。RGB 3成分,16進数カラコド,色名,または省略名として指定します。

カスタム色を使用する場合は,rgb 3成分または16進数カラコドを指定します。

  • RGB 3成分は,色の赤,緑,青成分の強度を指定する3成分の行ベクトルです。強度値は[0, 1]の範囲でなければなりません。たとえば[0.4 0.6 0.7]のようになります。

  • 16進数カラ、コ、ドは、ハッシュ記号()で始まり,3桁または6桁の0からFまでの範囲の16進数が続く文字ベクトルまたは字符串スカラ,です。これらの値では大文字小文字は区別されません。したがって,カラ,コ,ド“# FF8800”“# ff8800”“# F80”,および“# f80”は等価です。

あるいは,名前を使用して一部の一般的な色を指定できます。次の表に,名前の付いた色オプション,等価のRGB 3成分,および16進数カラーコードを示します。

色名 省略名 RGB 3成分 16進数カラコド 外観
“红色” “r” [10 0 0] “# FF0000”

“绿色” ‘g’ [0 10 0] “# 00 ff00”

“蓝” “b” [0 0 1] “# 0000 ff”

“青色” “c” [0 1 1] “# 00飞行符”

“红色” “米” [10 0 1] “#就”

“黄色” “y” [11 10 0] “# FFFF00”

“黑” “k” [0 0 0] # 000000的

“白色” ' w ' [1 1 1] “# FFFFFF”

“没有” 該当なし 該当なし 該当なし 色なし

MATLAB®の多くのタイプのプロットで使用されている既定の色のRGB 3成分および16進数カラーコードを次に示します。

RGB 3成分 16進数カラコド 外観
[0 0.4470 0.7410] “# 0072 bd”

[0.8500 0.3250 0.0980] “# D95319”

[0.9290 0.6940 0.1250] “# EDB120”

[0.4940 0.1840 0.5560] “# 7 e2f8e”

[0.4660 0.6740 0.1880] “# 77 ac30”

[0.3010 0.7450 0.9330] “# 4 dbeee”

[0.6350 0.0780 0.1840] “# A2142F”

例:b = boxchart(rand(10,1),'BoxFaceColor','red')

例:b.BoxFaceColor = [0 0.5 0.5];

例:b.BoxFaceColor = '#EDB120';

BoxFaceColorプロパティの設定方法。次のいずれかの値として指定します。

  • “汽车”-座標軸のColorOrderプロパティから色を選択することにより,matlabがBoxFaceColorの値を制御します。

  • “手动”—ユザがBoxChartオブジェクトの作成時に色を指定するか,作成後にそのオブジェクトでBoxFaceColorを設定することにより,BoxFaceColorの値を手動で制御します。

BoxFaceColorの値を手動で変更すると,matlabはBoxFaceColorModeプロパティの値を“手动”に変更します。

ひげの色。RGB 3成分,16進数カラコド,色名,または省略名として指定します。

カスタム色を使用する場合は,rgb 3成分または16進数カラコドを指定します。

  • RGB 3成分は,色の赤,緑,青成分の強度を指定する3成分の行ベクトルです。強度値は[0, 1]の範囲でなければなりません。たとえば[0.4 0.6 0.7]のようになります。

  • 16進数カラ、コ、ドは、ハッシュ記号()で始まり,3桁または6桁の0からFまでの範囲の16進数が続く文字ベクトルまたは字符串スカラ,です。これらの値では大文字小文字は区別されません。したがって,カラ,コ,ド“# FF8800”“# ff8800”“# F80”,および“# f80”は等価です。

あるいは,名前を使用して一部の一般的な色を指定できます。次の表に,名前の付いた色オプション,等価のRGB 3成分,および16進数カラーコードを示します。

色名 省略名 RGB 3成分 16進数カラコド 外観
“红色” “r” [10 0 0] “# FF0000”

“绿色” ‘g’ [0 10 0] “# 00 ff00”

“蓝” “b” [0 0 1] “# 0000 ff”

“青色” “c” [0 1 1] “# 00飞行符”

“红色” “米” [10 0 1] “#就”

“黄色” “y” [11 10 0] “# FFFF00”

“黑” “k” [0 0 0] # 000000的

“白色” ' w ' [1 1 1] “# FFFFFF”

“没有” 該当なし 該当なし 該当なし 色なし

MATLABの多くのタイプのプロットで使用されている既定の色のRGB 3成分および16進数カラーコードを次に示します。

RGB 3成分 16進数カラコド 外観
[0 0.4470 0.7410] “# 0072 bd”

[0.8500 0.3250 0.0980] “# D95319”

[0.9290 0.6940 0.1250] “# EDB120”

[0.4940 0.1840 0.5560] “# 7 e2f8e”

[0.4660 0.6740 0.1880] “# 77 ac30”

[0.3010 0.7450 0.9330] “# 4 dbeee”

[0.6350 0.0780 0.1840] “# A2142F”

例:b = boxchart(rand(10,1),'WhiskerLineColor','r')

例:b.WhiskerLineColor = [0.25 0.5 0.5];

例:b.WhiskerLineColor = '#A2142F';

ボックスの塗りぶしの透明度。[0, 1]の範囲のスカラ,として指定します。値1は不透明で,値0は完全に透明です。01の間の値は半透明です。

例:b = boxchart(rand(10,1),'BoxFaceAlpha',0.4)

例:b.BoxFaceAlpha = 0.4;

ひげのスタ@ @ル。次の表にリストされたオプションのいずれかとして指定します。

ラ▪▪ンスタ▪▪ル 説明 結果として得られる線
“- - -” 実線

“——” 破線

“:” 点線

“-”。 一点鎖線

“没有” ラ@ @ンなし ラ@ @ンなし

例:b = boxchart(rand(10,1),'WhiskerLineStyle','——')

例:b.WhiskerLineStyle = '——';

ボックスエッジおよびひげの幅。ポ▪▪ント単位の正のスカラ▪▪として指定します。1ポaapl . exeントは1/72 aapl . exeンチです。线宽値は中央値の線幅も制御します。

例:b = boxchart(rand(10,1),'LineWidth',1.5)

例:b.LineWidth = 1.5;

シリズンデックス。0または正の整数として指定します。このプロパティは,複数のBoxChartオブジェクトが相互に一致するように、それらのボックスの色(BoxFaceColor)と外れ値の色(MarkerColor)を再割り当てする場合に役立ます。通常の設定では,BoxChartオブジェクトのSeriesIndexプロパティは,1から始まるオブジェクトの作成順序に対応する数値です。

MATLABはこの数値を使用して,プロット関数を呼び出すときに色を割り当てるインデックスを計算します。このesc escンデックスは,座標軸のColorOrderプロパティに格納されている配列の行を表します。

該当するSeriesIndexを変更する場合,または座標軸でColorOrderプロパティを変更する場合,matlabはBoxChartオブジェクトのボックスの色または外れ値の色を自動的に更新します。ただし,変更が有効になるには、以下の条件に該当しなければなりません。

  • BoxChartオブジェクトのBoxFaceColorModeまたはMarkerColorModeプロパティが“汽车”に設定されている。

  • BoxChartオブジェクトのSeriesIndexプロパティが0より大きい。

  • 坐标轴オブジェクトのNextSeriesIndexプロパティが0より大きい。

マカ

すべて展開する

外れ値スタ@ @ル。次の表にリストされたオプションのいずれかとして指定します。

説明
“o”
“+” プラス記号
‘*’ アスタリスク
“。”
“x” 十字
“_” 水平線
“|” 垂直線
“广场”または“年代” 正方形
“钻石”または' d ' 菱形
“^” 上向き三角形
“v” 下向き三角形
“>” 右向き三角形
“<” 左向き三角形
五角星形的または“p” 星形五角形
“卦”または“h” 星形六角形
“没有” マ,カ,なし

例:b = boxchart([rand(10,1);2],' markstyle ','x')

例:b.MarkerStyle = 'x';

外れ値のサ@ @ズ。ポ▪▪ント単位の正のスカラ▪▪として指定します。1ポaapl . exeントは1/72 aapl . exeンチです。

例:b = boxchart([rand(10,1);2],'MarkerSize',8)

例:b.MarkerSize = 8;

外れ値の色。RGB 3成分,16進数カラコド,色名,または省略名として指定します。

カスタム色を使用する場合は,rgb 3成分または16進数カラコドを指定します。

  • RGB 3成分は,色の赤,緑,青成分の強度を指定する3成分の行ベクトルです。強度値は[0, 1]の範囲でなければなりません。たとえば[0.4 0.6 0.7]のようになります。

  • 16進数カラ、コ、ドは、ハッシュ記号()で始まり,3桁または6桁の0からFまでの範囲の16進数が続く文字ベクトルまたは字符串スカラ,です。これらの値では大文字小文字は区別されません。したがって,カラ,コ,ド“# FF8800”“# ff8800”“# F80”,および“# f80”は等価です。

あるいは,名前を使用して一部の一般的な色を指定できます。次の表に,名前の付いた色オプション,等価のRGB 3成分,および16進数カラーコードを示します。

色名 省略名 RGB 3成分 16進数カラコド 外観
“红色” “r” [10 0 0] “# FF0000”

“绿色” ‘g’ [0 10 0] “# 00 ff00”

“蓝” “b” [0 0 1] “# 0000 ff”

“青色” “c” [0 1 1] “# 00飞行符”

“红色” “米” [10 0 1] “#就”

“黄色” “y” [11 10 0] “# FFFF00”

“黑” “k” [0 0 0] # 000000的

“白色” ' w ' [1 1 1] “# FFFFFF”

“没有” 該当なし 該当なし 該当なし 色なし

MATLABの多くのタイプのプロットで使用されている既定の色のRGB 3成分および16進数カラーコードを次に示します。

RGB 3成分 16進数カラコド 外観
[0 0.4470 0.7410] “# 0072 bd”

[0.8500 0.3250 0.0980] “# D95319”

[0.9290 0.6940 0.1250] “# EDB120”

[0.4940 0.1840 0.5560] “# 7 e2f8e”

[0.4660 0.6740 0.1880] “# 77 ac30”

[0.3010 0.7450 0.9330] “# 4 dbeee”

[0.6350 0.0780 0.1840] “# A2142F”

例:b = boxchart([rand(10,1);2],' markcolor ','magenta')

例:b.MarkerColor = [0.5 0.5 1];

例:b.MarkerColor = '#7E2F8E';

MarkerColorプロパティの設定方法。次のいずれかの値として指定します。

  • “汽车”-座標軸のColorOrderプロパティから色を選択することにより,matlabがMarkerColorの値を制御します。

  • “手动”—ユザがBoxChartオブジェクトの作成時に色を指定するか,作成後にそのオブジェクトでMarkerColorを設定することにより,MarkerColorの値を手動で制御します。

MarkerColorの値を手動で変更すると,matlabはMarkerColorModeプロパティの値を“手动”に変更します。

デタ

すべて展開する

位置デ,タ。数値ベクトルまたは分类ベクトルとして指定します。

  • YDataがベクトルの場合,XDataYDataと同じ長さのベクトルです。XData(我)値はYData(我)値を使用して作成されたボックスチャ,トの位置を示します。

  • YDataが行列の場合,XDataは長さがYDataの列の数と等しいベクトルです。XData(我)値は列YData(:,我)を使用して作成されたボックスチャ,トの位置を示します。

通常の設定では,XDatax軸上のボックスチャ,トの位置を制御します。ただし,取向プロパティ値が“水平”の場合,XData値はy軸上の位置に対応します。

デ,タ型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类

サンプルデ,タ。数値ベクトルまたは行列として指定します。

デ,タ型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64

凡例

すべて展開する

凡例ラベル。文字ベクトルまたは字符串スカラ,として指定します。传说コマンドを呼び出すまで,凡例は表示されません。テキストを指定しない場合,传说“dataN”形式を使用してラベルを設定します。

このプロパティは読み取り専用です。

凡例にオブジェクトを含めるか除外するかの制御。注释オブジェクトとして返されます。基となるIconDisplayStyleプロパティを次のいずれかの値に設定します。

  • “上”—凡例にオブジェクトを含めます(既定)。

  • “关闭”-凡例にオブジェクトを含めません。

たとえば,グラフィックスオブジェクトを凡例から除外するには,IconDisplayStyleプロパティを“关闭”に設定します。

go.Annotation.LegendInformation.IconDisplayStyle =“关闭”

あるいは,関数传说を使用して,凡例内の項目を制御することもできます。最初の入力引数を,含めるグラフィックスオブジェクトのベクトルとして指定します。最初の入力引数に既存のグラフィックスオブジェクトを指定しない場合,それは凡例に表示されません。ただし,凡例が作成された後に座標軸に追加されたグラフィックス オブジェクトは凡例には表示されません。追加の項目を避けるには、すべてのプロットを作成した後に凡例を作成することを考慮してください。

対話機能

すべて展開する

可視性の状態。“上”または“关闭”,もしくは数値または逻辑1真正的)または0)として指定します。“上”の値は真正的と等価であり,“关闭”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型のon/off逻辑値として格納されます。

  • “上”-オブジェクトを表示します。

  • “关闭”-オブジェクトを削除せずに非表示にします。非表示のオブジェクトのプロパティには引き続きアクセスできます。

デ,タヒントの内容。DataTipTemplateオブジェクトとして指定します。基となるDataTipTemplateオブジェクトのプロパティを変更することにより,デ,タヒントに表示される内容を制御できます。プロパティの一覧にいては,DataTipTemplateのプロパティを参照してください。

デタヒントの変更の例にいては,カスタムデ,タヒントの作成を参照してください。

メモ

DataTipTemplateオブジェクトはfindobjまたはfindallによって返されず,copyobjによってコピ,されません。

マウスクリックキャプチャ機能。次の値の1として指定します。

  • “可见”-表示されている場合にマウスクリックをキャプチャします。可见プロパティが“上”に設定されていなければならず,BoxChartオブジェクトの色が定義されている部分をクリックしなければなりません。関連付けられている色のプロパティが“没有”に設定されている部分をクリックすることはできません。BoxChartオブジェクトがクリックに応答するか,先祖がクリックに応答するかは,HitTestプロパティが決定します。

  • “没有”-マウスクリックをキャプチャしません。BoxChartオブジェクトをクリックすると,图ウィンドウの現在のビュー内でその下にあるオブジェクトにクリックが渡されます。BoxChartオブジェクトのHitTestプロパティの効果はありません。

キャプチャしたマウスクリックへの応答。“上”または“关闭”,もしくは数値または逻辑1真正的)または0)として指定します。“上”の値は真实と等価であり,“关闭”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型のon/off逻辑値として格納されます。

  • “上”- - - - - -BoxChartオブジェクトによるマウスクリックキャプチャを有効にします。

  • “关闭”- - - - - -BoxChartオブジェクトの先祖のう,次のいずれかの条件を満たす最も近い先祖のコルバックをトリガします。

    • HitTestプロパティが“上”に設定されている

    • PickablePartsプロパティが,先祖によるマウスクリックのキャプチャを有効にする値に設定されている

メモ

PickablePartsプロパティは,BoxChartオブジェクトがマウスクリックをキャプチャできるかどうかを決定します。キャプチャできない場合,HitTestプロパティは無効です。

親/子

すべて展開する

親。集团または变换オブジェクトとして指定します。

子。空のGraphicsPlaceholder配列,またはDataTipオブジェクト配列として返されます。このプロパティを使用して、チャートにプロットされるデータ ヒントのリストを表示します。

孩子们プロパティを使用して子の追加や削除を行うことはできません。このリストに子を追加するには,DataTipオブジェクトのプロパティをチャ,トオブジェクトに設定します。

親の孩子们プロパティ内でのオブジェクトハンドルの可視性。次の値のいずれかとして指定します。

  • “上”-オブジェクトハンドルは常に表示されます。

  • “关闭”-オブジェクトハンドルは常に非表示です。このオプションは,他の関数による意図しない変更を防止するために役立ます。HandleVisibility“关闭”に設定すると,その関数の実行中にハンドルが一時的に非表示になります。

  • “回调”——オブジェクトハンドルはコールバック内から,あるいはコールバックにより呼び出される関数から参照できます。しかし,コマンドラ。このオプションを使用すると,コマンドラインからのオブジェクトへのアクセスがブロックされますが,コールバック関数からのアクセスは許可されます。

オブジェクトが親の孩子们プロパティ内にリストされない場合,オブジェクト階層の検索またはハンドルプロパティのクエリによってオブジェクトハンドルを取得する関数は,そのオブジェクトハンドルを返しません。こうした関数の例としては,関数得到findobjgcagcfgconewplotclf,および关闭などが挙げられます。

非表示のオブジェクトハンドルは有効なままです。ルトのShowHiddenHandlesプロパティを“上”に設定すると,HandleVisibilityプロパティの設定にかかわらず,すべてのオブジェクトハンドルがリストされます。

識別子

すべて展開する

このプロパティは読み取り専用です。

グラフィックスオブジェクトのタ@ @プ。“BoxChart”として返されます。プロット階層内にある特定のタイプのすべてのオブジェクトを検出するためにこのプロパティを使用できます。たとえばfindobjを使用してタ@ @プを検索します。

オブジェクト識別子。文字ベクトルまたは字符串スカラとして指定します。オブジェクトの識別子として機能する一意の标签値を指定できます。コ,ドの他の部分からオブジェクトにアクセスする必要がある場合,関数findobjを使用して标签値に基づいてオブジェクトを検索できます。

ユ,ザ,デ,タ。任意のmatlab配列として指定します。たとえば、スカラー、ベクトル、行列、cell 配列、文字配列、table、または構造体を指定できます。このプロパティを使用して、任意のデータをオブジェクトに保存します。

App Designerを使用している場合は,用户数据プロパティを使用する代わりに,アプリでパブリックプロパティまたはプライベートプロパティを作成してデータを共有します。詳細にいては,App Designerアプリ内でのデ,タの共有を参照してください。

参考

R2020aで導入