Rectangle のプロパティ

注釈四角形の外観と動作

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

h = annotation("rectangle");
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"

FaceColor — 塗りつぶし色

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

塗りつぶし色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。

カスタム色を使用する場合は、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"

FaceAlpha — 塗りつぶしの透明度

1 (既定値) | [0,1] の範囲の値

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

例: 0.5

LineStyle — ライン スタイル

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

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

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

LineWidth — ライン幅

0.5 (既定値) | 正の値

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

例: 0.75

位置

Position — サイズと位置

[0.3 0.3 0.1 0.1] (既定値) | 4 要素ベクトル

サイズと位置。[x y length height] の形式の 4 要素ベクトルとして指定します。最初の 2 つの要素で四角形の左下隅の座標を指定します。次の 2 つの要素で四角形の長さと高さを指定します。

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

例: [0.2 0.3 0.4 0.5]

Rotation — 回転角度 (度単位)

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

回転角度 (度単位)。スカラー数値として指定します。回転角度は絶対値で、前の回転からの相対角度ではありません。

次の表に、Rotation が取り得る値について、結果として生じる注釈の回転を示します。

Rotation の値	結果の回転
0	回転なし
正のスカラー値	指定した角度 (度単位) だけ反時計回りに回転
負のスカラー値	指定した角度 (度単位) だけ時計回りに回転

回転のアンカー ポイントは、Position プロパティ ベクトルの最初の 2 つの要素で指定された位置で、[x y] 値によって表されます。

例: 45

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 より前に導入

R2022a: 注釈の回転

Rotation プロパティを使用して、指定した角度 (度単位) だけ注釈を回転させます。回転のアンカー ポイントは、Position プロパティにより指定された位置で、Position プロパティは回転の影響を受けません。

参考

annotation

トピック

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