Line のプロパティ

注釈ラインの外観と動作

Line プロパティは、Line オブジェクトの外観と動作を制御します。プロパティの値を変更することによって、ラインの一部の特性を変更できます。プロパティのクエリと設定にはドット表記を使用します。

h = annotation('line');
c = h.Color;
h.Color = 'red';

色とスタイル

すべて展開する

`Color` — ラインの色
`[0 0 0]` (既定値) | RGB 3 成分 | 16 進数カラーコード | `'r'` | `'g'` | `'b'` | ...

ラインの色。RGB 3 成分、16 進数カラーコード、色名、または省略名として指定します。既定値 [0 0 0] は、黒に相当します。

カスタム色を使用する場合は、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"`
`"none"`	該当なし	該当なし	該当なし	色なし

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.5` (既定値) | 正の値

ライン幅。ポイント単位の正の値として指定します。1 ポイントは 1/72 インチです。

例: 0.75

位置

すべて展開する

`X` — 始点と終点の x 座標
`[0.3 0.4]` (既定値) | 2 要素ベクトル

始点と終点の x 座標。[x_begin x_end] の形式の 2 要素ベクトルとして指定します。

既定では、単位は Figure を基準に正規化されます。Figure の左下隅が (0,0) で、右上隅が (1,1) になります。単位を変更するには、Units プロパティを使用します。

例: [0.2 0.3]

`Y` — 始点と終点の y 座標
`[0.3 0.4]` (既定値) | 2 要素ベクトル

始点と終点の y 座標。[y_begin y_end] の形式の 2 要素ベクトルとして指定します。

例: [0.2 0.3]

`Position` — サイズと位置
`[0.3 0.3 0.1 0.1]` (既定値) | 4 要素ベクトル

サイズと位置。[x_begin y_begin dx dy] の形式の 4 要素ベクトルとして指定します。最初の 2 つの要素でラインの始点の座標を指定します。次の 2 つの要素でラインの傾きを指定します。

既定では、単位は Figure を基準に正規化されます。Figure の左下隅が (0,0) で、右上隅が (1,1) になります。単位を変更するには、Units プロパティを使用します。単位を変更するには、Units プロパティを使用します。

例: [0.2 0.2 0.3 0.3]

`Units` — 位置の単位
`'normalized'` (既定値) | `'inches'` | `'centimeters'` | `'characters'` | `'points'` | `'pixels'`

位置の単位。次の表のいずれかの値を指定します。

`Units`	説明
`'normalized'` (既定)	注釈を含む Figure、uipanel または uitab を基準にして正規化されます。コンテナーの左下隅が `(0,0)` で、右上隅が `(1,1)` になります。
`'inches'`	インチ。
`'centimeters'`	センチメートル。
`'characters'`	既定のシステムフォントの文字サイズを基準にします。文字の幅 = 文字 `x` の幅。文字の高さ = 2 行のテキストのベースライン間の距離。
`'points'`	ポイント。1 ポイントは 1/72 インチです。
`'pixels'`	ピクセル。 R2015b 以降、Windows^® および Macintosh システムにおいて、ピクセル単位の距離はシステム解像度に依存しません。 Windows システムの 1 ピクセルは 1/96 インチです。 Macintosh システムの 1 ピクセルは 1/72 インチです。 Linux^® システムでは、ピクセルのサイズは使用しているシステムの解像度によって決まります。

すべての単位は、Figure ウィンドウの左下隅から測定されます。

このプロパティは Position プロパティに影響します。単位を変更した場合、Units の設定値が既定値であることを前提としている他の関数に影響を及ぼさないように、計算終了後に元の既定値に戻すことを推奨します。

オブジェクトの作成時に Position プロパティと Units プロパティを Name,Value のペアとして指定する場合は、指定する順序が重要です。特定の単位で位置を定義するには、Units プロパティを設定してから Position プロパティを設定しなければなりません。

バージョン履歴

R2006a より前に導入

参考

annotation

Line のプロパティ

色とスタイル

Color — ラインの色 [0 0 0] (既定値) | RGB 3 成分 | 16 進数カラー コード | 'r' | 'g' | 'b' | ...

LineStyle — ライン スタイル "-" (既定値) | "--" | ":" | "-." | "none"

LineWidth — ライン幅 0.5 (既定値) | 正の値

位置

X — 始点と終点の x 座標 [0.3 0.4] (既定値) | 2 要素ベクトル

Y — 始点と終点の y 座標 [0.3 0.4] (既定値) | 2 要素ベクトル

Position — サイズと位置 [0.3 0.3 0.1 0.1] (既定値) | 4 要素ベクトル

Units — 位置の単位 'normalized' (既定値) | 'inches' | 'centimeters' | 'characters' | 'points' | 'pixels'