Baseline のプロパティ

ベースラインの外観と動作

Baseline オブジェクトは、棒グラフ、面グラフ、およびステム グラフの一部として作成されます。Baseline プロパティは、Baseline オブジェクトの外観と動作を制御します。プロパティの値を変更することによって、ベースラインの一部の特性を変更できます。ドット表記を使用して、特定のオブジェクトとプロパティを参照します。

b = bar(1:10);
bl = b.BaseLine;
c = bl.Color;
bl.Color = 'red';

外観

Color — ラインの色

'none' | RGB 3 成分 | 16 進数カラー コード | 'r' | 'g''b' | ...

ラインの色。RGB 3 成分、'none'、16 進数カラー コード、色名、または省略名として指定します。色を 'none' に指定した場合、ベースラインは透明になります。

RGB 3 成分および 16 進数カラー コードは、カスタム色を指定するのに役立ちます。

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

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

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

色名	省略名	RGB 3 成分	16 進数カラー コード	外観
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"

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

RGB 3 成分	16 進数カラー コード	外観
[0 0.4470 0.7410]	"#0072BD"
[0.8500 0.3250 0.0980]	"#D95319"
[0.9290 0.6940 0.1250]	"#EDB120"
[0.4940 0.1840 0.5560]	"#7E2F8E"
[0.4660 0.6740 0.1880]	"#77AC30"
[0.3010 0.7450 0.9330]	"#4DBEEE"
[0.6350 0.0780 0.1840]	"#A2142F"

例: 'blue'

例: [0 0 1]

例: '#0000FF'

LineStyle — ライン スタイル

'-' | '--' | ':' | '-.' | 'none'

ライン スタイル。次の表にリストされるライン スタイルのいずれかとして指定します。

ライン スタイル	説明	結果として得られる線
'-'	実線
'--'	破線
':'	点線
'-.'	一点鎖線
'none'	ラインなし	ラインなし

LineWidth — ライン幅

正の値

ライン幅。ポイント単位の正の値として指定します。

例: 0.75

位置と可視性

BaseValue — ベースラインの値

スカラー

ベースラインの値。スカラーとして指定します。

通常、ベースラインは bar series オブジェクト、stem series オブジェクトまたは area オブジェクトに関連付けられます。これらの関連するオブジェクトの BaseValue プロパティと baseline オブジェクトの BaseValue プロパティは、常に同じ値になります。一方のプロパティを設定すると、もう一方のプロパティも設定されます。baseline オブジェクトは、関連するオブジェクトの BaseLine プロパティに格納されます。

例: 0.75

Visible — 可視性

'on' | on/off logical 値

可視性。'on' または 'off'、もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

• 'on' — ベースラインを表示します。

• 'off' — ベースラインを削除せずに非表示にします。非表示のベースラインのプロパティに引き続きアクセスできます。

通常、ベースラインは bar series オブジェクト、stem series オブジェクトまたは area オブジェクトに関連付けられます。これらの関連するオブジェクトの ShowBaseline プロパティと baseline オブジェクトの Visible プロパティは、常に同じ値になります。一方のプロパティを設定すると、もう一方のプロパティも設定されます。baseline オブジェクトは、関連するオブジェクトの BaseLine プロパティに格納されます。

親/子

Parent — 親

Axes オブジェクト

親。Axes オブジェクトとして返されます。ただし、Baseline オブジェクトは座標軸の子としてリストされていません。

Children — 子

空の GraphicsPlaceholder 配列

ベースラインには子がありません。このプロパティは設定できません。

バージョン履歴

R2014b で導入

参考

stem | bar | barh | area

トピック

• プロパティ値へのアクセス
• グラフィックス オブジェクトのプロパティ