Arrow のプロパティ

矢印の外観と動作

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

ar = annotation("arrow");
c = ar.Color;
ar.Color = "red";

色とスタイル

Color — 矢印の色

[0 0 0] (既定値) | RGB 3 成分 | 16 進数カラー コード | "r" | "g" | "b" | ...

矢印の色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。既定の RGB 3 成分の値 [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]

LineStyle — 矢印の軸のスタイル

"-" (既定値) | "--" | ":" | "-." | "none"

矢印の軸のスタイル。次の表に挙げるライン スタイルのいずれかとして指定します。

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

LineWidth — 矢印の軸の幅

0.5 (既定値) | 正の値

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

例: 0.75

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

HeadStyle — 矢じりのスタイル

"vback2" (既定値) | "plain" | "ellipse" | "vback1" | "vback3" | "cback1" | ...

矢じりのスタイル。次の表の矢じりスタイル オプションのいずれかとして指定します。

スタイル	結果	スタイル	結果
"plain"		"fourstar"
"ellipse"		"rectangle"
"vback1"		"diamond"
"vback2" (既定)		"rose"
"vback3"		"hypocycloid"
"cback1"		"astroid"
"cback2"		"deltoid"
"cback3"		"none"	矢じりなし

HeadLength — 矢じりの長さ

10 (既定値) | スカラー数値

矢じりの長さ。ポイント単位のスカラー数値として指定します。1 ポイントは 1/72 インチです。矢じりは、X プロパティと Y プロパティで定義される点 (x_end,y_end) から逆方向に伸びます。

例: 15

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

HeadWidth — 矢じりの幅

10 (既定値) | スカラー数値

矢じりの幅。ポイント単位のスカラー数値として指定します。1 ポイントは 1/72 インチです。

例: 15

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

位置

X — 始点と終点の x 座標

[0.3 0.4] (既定値) | 2 要素ベクトル

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

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

例: [0.2 0.5]

Y — 始点と終点の y 座標

[0.3 0.4] (既定値) | 2 要素ベクトル

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

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

例: [0.2 0.5]

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 プロパティを使用します。

例: [0.5 0.5 0.2 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 プロパティを指定する場合は、指定する順序が重要です。特定の単位で位置を定義するには、Units プロパティを設定してから Position プロパティを設定しなければなりません。

バージョン履歴

R2006a より前に導入

参考

annotation

トピック

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