ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

Axes のプロパティ

座標軸の外観と動作

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

R2014b から、プロパティのクエリと設定にドット表記を使用できるようになりました。

ax = gca;
c = ax.Color;
ax.Color = 'blue';

それより前のリリースを使用している場合は、代わりに関数 get および set を使用してください。

フォント

すべて展開する

フォント名。サポートされているフォント名または 'FixedWidth' として指定します。テキストを正しく表示し印刷するには、システムでサポートされているフォントを選択しなければなりません。既定のフォントは、オペレーティング システムとロケールによって異なります。

どのロケールでもテキストが整って見える固定幅のフォントを使用するには、'FixedWidth' を使用します。固定幅フォントは、ルートの FixedWidthFontName プロパティによって決まります。ルートの FixedWidthFontName プロパティを設定すると、表示内容が新しいフォントを使用して直ちに更新されます。

文字の太さ。'normal' または 'bold' として指定します。

MATLAB® ではフォントは、FontWeight プロパティを使用して、ユーザーのシステムで使用可能なフォントから選択します。すべてのフォントに太字があるとは限りません。そのため、太字フォントを指定しても標準フォントの太さと変わらない場合があります。

フォント サイズ。スカラー数値として指定します。フォント サイズは、タイトル、軸ラベル、目盛りラベルに影響します。また、座標軸に関連付けられているすべての凡例やカラー バーにも影響します。既定のフォント サイズは、特定のオペレーティング システムとロケールによって異なります。既定では、フォント サイズはポイント単位で測定されます。単位を変更するには、FontUnits プロパティを設定します。

MATLAB は、一部のテキストを座標軸のフォント サイズの所定の割合に自動的にスケーリングします。

  • タイトルと軸ラベル — 既定では座標軸のフォント サイズの 110% です。スケーリングを制御するには、TitleFontSizeMultiplier プロパティと LabelFontSizeMultiplier プロパティを使用します。

  • 凡例とカラー バー — 既定では座標軸のフォント サイズの 90% です。別のフォント サイズを指定するには、Legend オブジェクトまたは Colorbar オブジェクトの FontSize プロパティを代わりに設定します。

例: ax.FontSize = 12

フォント サイズの選択モード。次の値のいずれかとして指定します。

  • 'auto' — フォント サイズは MATLAB により指定されます。座標軸を既定より小さいサイズに変更すると、可読性とレイアウトの向上のためフォント サイズが小さくなる場合があります。

  • 'manual' — フォント サイズを手動で指定します。座標軸のサイズが変化してもフォント サイズはスケーリングされません。フォント サイズを指定するには、FontSize プロパティを設定します。

文字の傾斜。'normal' または 'italic' として指定します。

すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントを指定しても標準フォントと変わらない場合があります。

ラベルのフォント サイズのスケール係数。0 より大きい数値として指定します。このスケール係数は、x 軸、y 軸および z 軸のラベルのフォント サイズを定義する FontSize プロパティの値に適用されます。

例: ax.LabelFontSizeMultiplier = 1.5

タイトルのフォント サイズのスケール係数。0 より大きい数値として指定します。このスケール係数は、タイトルのフォント サイズを定義する FontSize プロパティの値に適用されます。

例: ax.TitleFontSizeMultiplier = 1.75

タイトル文字の太さ。次の値のいずれかとして指定します。

  • 'bold' — 標準よりも太い文字

  • 'normal' — 各フォントで定義されている既定の太さ

例: ax.TitleFontWeight = 'normal'

フォント サイズの単位。次の値のいずれかとして指定します。

Units説明
'points'ポイント。1 ポイントは 1/72 インチです。
'inches'インチ。
'centimeters'センチメートル。
'normalized' フォント サイズを座標軸の高さに対する割合として解釈します。座標軸のサイズを変更すると、それに合わせてフォント サイズが変更されます。たとえば、FontSize が正規化された単位の 0.1 である場合、テキストは座標軸の Position プロパティに格納された高さの値の 1/10 になります。
'pixels'

ピクセル。

R2015b 以降、Windows® および Macintosh システムにおいて、ピクセル単位の距離はシステム解像度に依存しません。

  • Windows システムの 1 ピクセルは 1/96 インチです。

  • Macintosh システムの 1 ピクセルは 1/72 インチです。

  • Linux® システムでは、ピクセルのサイズは使用しているシステムの解像度によって決まります。

1 回の関数呼び出しでフォント サイズとフォントの単位の両方を設定する場合は、指定したフォント サイズを Axes オブジェクトが正しく解釈するように、最初に FontUnits プロパティを設定しなければなりません。

文字の平滑化。'on' または 'off' として指定します。

説明結果
'on'

アンチエイリアス処理を使用して画面上のテキストの表示を滑らかにします。

例: ax.FontSmoothing = 'on'

'off'

アンチエイリアス処理を使用しません。この設定はテキストがぼやけて見えるときに使用します。

例: ax.FontSmoothing = 'off'

目盛り

すべて展開する

目盛り値。増加する値からなるベクトルとして指定します。軸に沿って目盛りを表示しない場合は、空のベクトル [] を指定します。目盛り値は、軸に沿って目盛りが表示される位置です。目盛りラベルは、各目盛りの横に表示されるラベルです。XTickLabelsYTickLabels、および ZTickLabels の各プロパティを使用して関連するラベルを指定します。

例: ax.XTick = [2 4 6 8 10]

例: ax.YTick = 0:10:100

あるいは、関数 xticksytickszticks を使用して目盛り値を指定します。例については、軸の目盛り値とラベルの指定を参照してください。

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

目盛り値の選択モード。次の値のいずれかとして指定します。

  • 'auto' — 軸のデータの範囲に基づいて目盛り値を自動的に選択します。

  • 'manual' — 目盛り値を手動で指定します。値を指定するには、XTickYTickZTick の各プロパティを指定します。

例: ax.XTickMode = 'auto'

目盛りラベル。文字ベクトルの cell 配列、string 配列または categorical 配列として指定します。目盛りラベルを表示しない場合は、空の cell 配列 {} を指定します。指定したラベルの個数が目盛り値の個数より少ない場合、ラベルが繰り返されます。

目盛りラベルでは TeX マークアップおよび LaTeX マークアップがサポートされます。詳細については、TickLabelInterpreter プロパティを参照してください。

このプロパティを categorical 配列として指定した場合、MATLAB はカテゴリではなく、配列内の値を使用します。

このプロパティを設定する代わりに、関数 xticklabelsyticklabelszticklabels を使用することもできます。例については、軸の目盛り値とラベルの指定を参照してください。

例: ax.XTickLabel = {'Jan','Feb','Mar','Apr'}

目盛りラベルの選択モード。次の値のいずれかとして指定します。

  • 'auto' — 目盛りラベルを自動的に選択します。

  • 'manual' — 目盛りラベルを手動で指定します。ラベルを指定するには、XTickLabelYTickLabelZTickLabel の各プロパティを指定します。

例: ax.XTickLabelMode = 'auto'

目盛りラベルの解釈。次の値のいずれかとして指定します。

  • 'tex' — TeX マークアップのサブセットを使用してラベルを解釈します。

  • 'latex' — LaTeX マークアップのサブセットを使用してラベルを解釈します。

  • 'none' — リテラル文字を表示します。

TeX マークアップ

MATLAB では、既定で TeX マークアップのサブセットをサポートしています。TeX マークアップを使用して、上付き文字や下付き文字の追加、テキストのタイプや色の変更、テキストへの特殊文字の挿入を行うことができます。

次の表に、TickLabelInterpreter プロパティを 'tex' (既定値) に設定した場合にサポートされる修飾子を示します。修飾子の効果はテキストの末尾まで適用されます。ただし、上付き文字と下付き文字は例外で、次の 1 文字または中かっこ {} で囲まれたテキストにのみ適用されます。

修飾子説明
^{ }上付き文字'text^{superscript}'
_{ }下付き文字'text_{subscript}'
\bf太字フォント'\bf text'
\itイタリック フォント'\it text'
\sl斜体フォント (ほとんど使用しません)'\sl text'
\rm標準フォント'\rm text'
\fontname{specifier}specifier でフォント ファミリの名前を指定してフォント スタイルを変更します。これは他の修飾子と共に使用できます。'\fontname{Courier} text'
\fontsize{specifier}specifier でスカラー数値を指定してフォント サイズを変更します。'\fontsize{15} text'
\color{specifier}specifer で色を指定します。redgreenyellowmagentablueblackwhitegraydarkGreenorangelightBlue を指定できます。'\color{magenta} text'
\color[rgb]{specifier}specifier で RGB 3 成分を指定してフォントの色を変更します。'\color[rgb]{0,0.5,0.5} text'

次の表に、Interpreter プロパティが 'tex' に設定されている場合にサポートされる特殊文字を示します。

文字列記号文字列記号文字列記号

\alpha

α

\upsilon

υ

\sim

~

\angle

\phi

\leq

\ast

*

\chi

χ

\infty

\beta

β

\psi

ψ

\clubsuit

\gamma

γ

\omega

ω

\diamondsuit

\delta

δ

\Gamma

Γ

\heartsuit

\epsilon

ϵ

\Delta

Δ

\spadesuit

\zeta

ζ

\Theta

Θ

\leftrightarrow

\eta

η

\Lambda

Λ

\leftarrow

\theta

θ

\Xi

Ξ

\Leftarrow

\vartheta

ϑ

\Pi

Π

\uparrow

\iota

ι

\Sigma

Σ

\rightarrow

\kappa

κ

\Upsilon

ϒ

\Rightarrow

\lambda

λ

\Phi

Φ

\downarrow

\mu

µ

\Psi

Ψ

\circ

º

\nu

ν

\Omega

Ω

\pm

±

\xi

ξ

\forall

\geq

\pi

π

\exists

\propto

\rho

ρ

\ni

\partial

\sigma

σ

\cong

\bullet

\varsigma

ς

\approx

\div

÷

\tau

τ

\Re

\neq

\equiv

\oplus

\aleph

\Im

\cup

\wp

\otimes

\subseteq

\oslash

\cap

\in

\supseteq

\supset

\lceil

\subset

\int

\cdot

·

\o

ο

\rfloor

\neg

¬

\nabla

\lfloor

\times

x

\ldots

...

\perp

\surd

\prime

´

\wedge

\varpi

ϖ

\0

\rceil

\rangle

\mid

|

\vee

\langle

\copyright

©

LaTeX マークアップ

LaTeX マークアップを使用するには、TickLabelInterpreter プロパティを 'latex' に設定します。テキストをドル記号で囲みます。たとえば、インライン モードでは '$\int_1^{20} x^2 dx$'、表示モードでは '$$\int_1^{20} x^2 dx$$' を使用します。

テキストは LaTeX の既定のフォント スタイルで表示され、フォント スタイルを変更するには、テキスト内で LaTeX マークアップを使用します。FontNameFontWeightFontAngle プロパティは影響しません。

LaTeX インタープリターで使用できるテキストの最大サイズは 1200 文字です。複数行のテキストの場合、この制限から 1 行につき 10 文字ほど少なくなります。LaTeX システムの詳細については、LaTeX プロジェクトの Web サイト (www.latex-project.org) を参照してください。

目盛りラベルの回転。度単位の数値で指定します。正の値を指定すると反時計回りになります。負の値を指定すると時計回りになります。

例: ax.XTickLabelRotation = 45

例: ax.YTickLabelRotation = 90

あるいは、関数 xtickangleytickangle および ztickangle を使用します。

小目盛り。次の値のいずれかとして指定します。

  • 'off' — 小目盛りを表示しません。この値は、線形スケールを使用する軸の既定値です。

  • 'on' — 軸の大目盛りの間に小目盛りを表示します。大目盛りの間隔に応じて小目盛りの数が決まります。この値は、対数スケールを使用する軸の既定値です。

例: ax.XMinorTick = 'on'

目盛りの方向。次の値のいずれかとして指定します。

  • 'in' — 軸のラインの内側に目盛りを付けます。(2 次元表示の既定値)

  • 'out' — 軸のラインの外側に目盛りを付けます。(3 次元表示の既定値)

  • 'both' — 軸のラインに目盛りの中心を合わせます。

例: ax.TickDir = 'out'

TickDir プロパティの選択モード。次の値のいずれかとして指定します。

  • 'auto' — 現在の表示に基づいて、目盛りの方向を自動的に選択します。

  • 'manual' — 目盛りの方向を手動で指定します。目盛りの方向を指定するには、TickDir プロパティを設定します。

例: ax.TickDirMode = 'auto'

目盛りの長さ。[2Dlength 3Dlength] の形式の 2 要素ベクトルとして指定します。最初の要素が 2 次元表示の目盛りの長さで、2 番目の要素が 3 次元表示の目盛りの長さです。表示される x 軸、y軸、z 軸のラインのうち、最も長いラインに対して正規化される単位で値を指定します。

例: ax.TickLength = [0.02 0.035]

ルーラー

すべて展開する

範囲の上限と下限。[min max] の形式の 2 要素ベクトルとして指定します。ここで、maxmin より大きい値です。範囲は、数値、カテゴリカル値、datetime 値、または duration 値として指定できます。ただし、指定する値の型は、軸に沿った値の型と一致していなければなりません。

両方の限界値を指定することも、一方の限界値を指定して座標軸にもう一方を自動計算させることもできます。下限値および上限値を自動的に計算する場合は、それぞれ -inf または inf を使用します。

例: ax.XLim = [0 10]

例: ax.YLim = [-inf 10]

例: ax.ZLim = [0 inf]

または、関数 xlimylim および zlim を使用して範囲を設定します。例については、軸の範囲の指定を参照してください。

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

軸の範囲の選択モード。次の値のいずれかとして指定します。

  • 'auto' — プロットされたデータに基づいて軸の範囲を自動的に選択します。つまり、すべてのオブジェクトの XDataYDataZData の全範囲が座標軸に表示されます。

  • 'manual' — 軸の範囲を手動で指定します。軸の範囲を指定するには、XLimYLimZLim の各プロパティを指定します。

例: ax.XLimMode = 'auto'

軸ルーラー。ルーラー オブジェクトとして返されます。このルーラーは、x 軸、y 軸または z 軸の外観と動作を制御します。特定座標軸の外観と動作を変更するには、対応するルーラーにアクセスし、ルーラーのプロパティを設定します。各座標軸に対して MATLAB が作成するルーラーのタイプは、プロットされるデータによって異なります。Axes オブジェクトがサポートしているルーラーのプロパティのリストについては、次を参照してください。

たとえば、XAxis プロパティを通して x 軸のルーラーにアクセスします。次に、そのルーラーの Color プロパティを変更することで、x 軸の色を赤に変更します。同様に、y 軸の色を緑に変更します。

ax = gca;
ax.XAxis.Color = 'r';
ax.YAxis.Color = 'g';
Axes オブジェクトに 2 つの y 軸がある場合、YAxis プロパティは 2 つのルーラー オブジェクトを格納します。

x 軸の位置。次の表のいずれかの値を指定します。このプロパティは 2 次元表示にのみ適用されます。

説明結果
'bottom'

座標軸の下部。

例: ax.XAxisLocation = 'bottom'

'top'

座標軸の上部。

例: ax.XAxisLocation = 'top'

'origin'

原点 (0,0) を通る。

例: ax.XAxisLocation = 'origin'

y 軸の位置。次の表のいずれかの値を指定します。このプロパティは 2 次元表示にのみ適用されます。

説明結果
'left'

座標軸の左側。

例: ax.YAxisLocation = 'left'

'right'

座標軸の右側。

例: ax.YAxisLocation = 'right'

'origin'

原点 (0,0) を通る。

例: ax.YAxisLocation = 'origin'

xyz 方向の軸のライン、目盛り値およびラベルの色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。GridColor プロパティまたは MinorGridColor プロパティを使用してグリッド ラインの色を指定していない限り、指定する色はグリッド ラインにも影響します。

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

例: ax.XColor = [1 1 0]

例: ax.YColor = 'y'

例: ax.ZColor = 'yellow'

例: ax.ZColor = '#FFFF00'

x 軸のグリッド色を設定するためのプロパティ。'auto' または 'manual' として指定します。このモード値は x 軸のグリッド色にのみ影響します。x 軸のライン、目盛り値、ラベルは、モードに関係なく常に XColor 値を使用します。

x 軸のグリッドの色は、以下に示すように、XColorMode プロパティと GridColorMode プロパティの両方によって決まります。

XColorModeGridColorModex 軸のグリッド色
'auto''auto'GridColor プロパティ
'manual'GridColor プロパティ
'manual''auto'XColor プロパティ
'manual'GridColor プロパティ

x 軸のマイナー グリッドの色は、以下に示すように、XColorMode プロパティと MinorGridColorMode プロパティの両方によって決まります。

XColorModeMinorGridColorModex 軸のマイナー グリッド色
'auto''auto'MinorGridColor プロパティ
'manual'MinorGridColor プロパティ
'manual''auto'XColor プロパティ
'manual'MinorGridColor プロパティ

y 軸のグリッド色を設定するためのプロパティ。'auto' または 'manual' として指定します。このモード値は y 軸のグリッド色にのみ影響します。y 軸のライン、目盛り値、ラベルは、モードに関係なく常に YColor 値を使用します。

y 軸のグリッドの色は、以下に示すように、YColorMode プロパティと GridColorMode プロパティの両方によって決まります。

YColorModeGridColorModez 軸のグリッド色
'auto''auto'GridColor プロパティ
'manual'GridColor プロパティ
'manual''auto'YColor プロパティ
'manual'GridColor プロパティ

y 軸のマイナー グリッドの色は、以下に示すように、YColorMode プロパティと MinorGridColorMode プロパティの両方によって決まります。

YColorModeMinorGridColorModey 軸のマイナー グリッド色
'auto''auto'MinorGridColor プロパティ
'manual'MinorGridColor プロパティ
'manual''auto'YColor プロパティ
'manual'MinorGridColor プロパティ

z 軸のグリッド色を設定するためのプロパティ。'auto' または 'manual' として指定します。このモード値は z 軸のグリッド色にのみ影響します。z 軸のライン、目盛り値、ラベルは、モードに関係なく常に ZColor 値を使用します。

z 軸のグリッドの色は、以下に示すように、ZColorMode プロパティと GridColorMode プロパティの両方によって決まります。

ZColorModeGridColorModez 軸のグリッド色
'auto''auto'GridColor プロパティ
'manual'GridColor プロパティ
'manual''auto'ZColor プロパティ
'manual'GridColor プロパティ

z 軸のマイナー グリッドの色は、以下に示すように、ZColorMode プロパティと MinorGridColorMode プロパティの両方によって決まります。

ZColorModeMinorGridColorModez 軸のマイナー グリッド色
'auto''auto'MinorGridColor プロパティ
'manual'MinorGridColor プロパティ
'manual''auto'ZColor プロパティ
'manual'MinorGridColor プロパティ

x 軸の方向。次のいずれかの値として指定します。

説明2 次元での結果3 次元での結果
'normal'

値は左から右へ増加します。

例: ax.XDir = 'normal'

'reverse'

値は右から左へ増加します。

例: ax.XDir = 'reverse'

y 軸の方向。次のいずれかの値として指定します。

説明2 次元での結果3 次元での結果
'normal'

値は下から上へ (2 次元表示)、または手前から奥へ (3 次元表示) 増加します。

例: ax.YDir = 'normal'

'reverse'

値は上から下へ (2 次元表示)、または奥から手前へ (3 次元表示) 増加します。

例: ax.YDir = 'reverse'

z 軸の方向。次のいずれかの値として指定します。

説明3 次元での結果
'normal'

値は画面から手前の方向へ (2 次元表示)、または下から上へ (3 次元表示) 増加します。

例: ax.ZDir = 'normal'

'reverse'

値は手前から画面へ (2 次元表示)、または上から下へ (3 次元表示) 増加します。

例: ax.ZDir = 'reverse'

軸のスケール。次の値のいずれかとして指定します。

説明結果
'linear'

線形スケール

例: ax.XScale = 'linear'

'log'

対数スケール

例: ax.XScale = 'log'

グリッド

すべて展開する

グリッド ライン。次の値のいずれかとして指定します。

  • 'off' — グリッド ラインを表示しません。

  • 'on'xyz の定数値などを基準に、各軸に対して垂直なグリッド ラインを表示します。

あるいは、grid on または grid off コマンドを使用して、3 つすべてのプロパティをそれぞれ 'on' または 'off' に設定します。詳細については、grid を参照してください。

例: ax.XGrid = 'on'

グリッド ラインと目盛りのグラフィックス オブジェクトに対する相対的な位置。次の値のいずれかとして指定します。

  • 'bottom' — 目盛りとグリッド ラインをグラフィックス オブジェクトの下に表示します。

  • 'top' — 目盛りとグリッド ラインをグラフィックス オブジェクトの上に表示します。

このプロパティは 2 次元表示にのみ影響します。

例: ax.Layer = 'top'

グリッド ラインのライン スタイル。次の表のライン スタイルのいずれかとして指定します。

ライン スタイル説明結果として得られる線
'-'実線

'--'破線

':'点線

'-.'一点鎖線

'none'ラインなしラインなし

グリッド ラインを表示するには、grid on コマンドを使用するか、XGridYGridZGrid の各プロパティを 'on' に設定します。

例: ax.GridLineStyle = '--'

グリッド ラインの色。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'

座標軸のボックスの外枠の色を設定するには、XColorYColorZColor の各プロパティを使用します。

グリッド ラインを表示するには、grid on コマンドを使用するか、XGridYGridZGrid の各プロパティを 'on' に設定します。

例: ax.GridColor = [0 0 1]

例: ax.GridColor = 'b'

例: ax.GridColor = 'blue'

例: ax.GridColor = '#0000FF'

グリッド色を設定するためのプロパティ。次の値のいずれかとして指定します。

  • 'auto'XColorModeYColorModeZColorMode の各プロパティの値を確認して、x、y、z の各方向のグリッド ライン色を決定します。

  • 'manual'GridColor を使用して、すべての方向のグリッド ラインの色を設定します。

グリッド ラインの透明度。[0,1] の範囲の値として指定します。値 1 は不透明で、値 0 は完全に透明です。

例: ax.GridAlpha = 0.5

GridAlpha プロパティの選択モード。次の値のいずれかとして指定します。

  • 'auto' — 既定の透明度の値 (0.15)。

  • 'manual' — 透明度の値を手動で指定します。値を指定するには、GridAlpha プロパティを設定します。

例: ax.GridAlphaMode = 'auto'

マイナー グリッド ライン。次の値のいずれかとして指定します。

  • 'off' — グリッド ラインを表示しません。

  • 'on' — 各軸の小目盛りを基準にグリッド ラインを表示します。マイナー グリッド ラインを表示するために、小目盛りを有効にする必要はありません。

または、grid minor コマンドを使用して、マイナー グリッド ラインの表示/非表示を切り替えます。

例: ax.XMinorGrid = 'on'

マイナー グリッド ラインのライン スタイル。次の表のライン スタイルのいずれかとして指定します。

ライン スタイル説明結果として得られる線
'-'実線

'--'破線

':'点線

'-.'一点鎖線

'none'ラインなしラインなし

マイナー グリッド ラインを表示するには、grid minor コマンドを使用するか、XMinorGridYMinorGridZMinorGrid の各プロパティを 'on' に設定します。

例: ax.MinorGridLineStyle = '-.'

マイナー グリッド ラインの色。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'

マイナー グリッド ラインを表示するには、grid minor コマンドを使用するか、XMinorGridYMinorGridZMinorGrid の各プロパティを 'on' に設定します。

例: ax.MinorGridColor = [0 0 1]

例: ax.MinorGridColor = 'b'

例: ax.MinorGridColor = 'blue'

例: ax.MinorGridColor = '#0000FF'

マイナー グリッド色を設定するためのプロパティ。次の値のいずれかとして指定します。

  • 'auto'XColorModeYColorModeZColorMode の各プロパティの値を確認して、x、y、z の各方向のグリッド ライン色を決定します。

  • 'manual'MinorGridColor を使用して、すべての方向のマイナー グリッド ラインの色を設定します。

マイナー グリッド ラインの透明度。[0,1] の範囲の値として指定します。値 1 は不透明で、値 0 は完全に透明です。

例: ax.MinorGridAlpha = 0.5

MinorGridAlpha プロパティの選択モード。次の値のいずれかとして指定します。

  • 'auto' — 既定の透明度の値 (0.25)。

  • 'manual' — 透明度の値を手動で指定します。値を指定するには、MinorGridAlpha プロパティを設定します。

例: ax.MinorGridAlphaMode = 'auto'

ラベル

すべて展開する

座標軸のタイトルの text オブジェクト。タイトルを追加するには、text オブジェクトの String プロパティを設定します。フォント スタイルや色などのタイトルの外観を変更するには、他のプロパティを設定します。完全な一覧については、Text のプロパティ を参照してください。

ax = gca;
ax.Title.String = 'My Title';
ax.Title.FontWeight = 'normal';

別の方法として、関数 title を使用してタイトルを追加し、外観を制御することができます。

title('My Title','FontWeight','normal')

メモ

この text オブジェクトは座標軸の Children プロパティには含まれていません。そのため、findobj で返すことはできず、text オブジェクトに定義されている既定値は使用されません。

軸ラベルの text オブジェクト。軸ラベルを追加するには、text オブジェクトの String プロパティを設定します。フォント サイズなどのラベルの外観を変更するには、他のプロパティを設定します。完全な一覧については、Text のプロパティ を参照してください。

ax = gca;
ax.YLabel.String = 'My y-Axis Label';
ax.YLabel.FontSize = 12;

または、関数 xlabelylabel および zlabel を使用して、軸ラベルの追加と外観の制御を行います。

ylabel('My y-Axis Label','FontSize',12)

メモ

これらの text オブジェクトは座標軸の Children プロパティには含まれていません。そのため、findobj で返すことはできず、text オブジェクトに定義されている既定値は使用されません。

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

Axes オブジェクトに関連付けられた凡例。Legend オブジェクトとして指定します。凡例を座標軸に追加するには、関数 legend を使用します。その後、このプロパティを使用して凡例を変更できます。プロパティの一覧については、Legend のプロパティ を参照してください。

plot(rand(3))
legend({'Line 1','Line 2','Line 3'},'FontSize',12)
ax = gca;
ax.Legend.TextColor = 'red';

このプロパティを使用して、座標軸に凡例があるかどうかも判別できます。

ax = gca;
lgd = ax.Legend
if ~isempty(lgd)
    disp('Legend Exists')
end

複数のプロット

すべて展開する

色の順序。RGB 3 成分からなる 3 列の行列として指定します。行列の各行で色の順序に含まれる色を 1 つずつ定義します。既定の色の順序には 7 種類の色が含まれています。

既定の色の順序対応する RGB 3 成分

    [    0    0.4470    0.7410
    0.8500    0.3250    0.0980
    0.9290    0.6940    0.1250
    0.4940    0.1840    0.5560
    0.4660    0.6740    0.1880
    0.3010    0.7450    0.9330
    0.6350    0.0780    0.1840]

プロットの前に色の順序を変更

色の順序の変更はプロットの前に行わなければなりません。順序を変更しても、既存のプロットには影響しません。ただし、グラフィックス関数の多くで、プロットの前に色の順序が既定値にリセットされます。指定された色の順序を座標軸で確実に使用するには、次のいずれかの方法を使用します。

  • プロットの前に、座標軸の "既定" の色の順序を変更する。

  • プロットの前に、座標軸の NextPlot プロパティを 'replacechildren' または 'add' に設定する。

たとえば、次のコードは、今後のすべての座標軸について既定の色の順序を変更します。

co = [1    0  0.4
    0.8  0.2  0.5
    0.6  0.4  0.6
    0.4  0.6  0.7
    0.2  0.8  0.8
      0    1  0.9];
set(groot,'defaultAxesColorOrder',co)
plot(rand(5))
色の順序を元に戻すには、次のコマンドを使用します。
set(groot,'defaultAxesColorOrder','remove')

あるいは、プロットの前に Axes オブジェクトの NextPlot プロパティを 'replacechildren' に設定します。既存のプロットが新しいプロットに置き代わり、色の順序の最初の色が使用されますが、座標軸の他のプロパティはリセットされません。

co = [1    0  0.4
    0.8  0.2  0.5
    0.6  0.4  0.6
    0.4  0.6  0.7
    0.2  0.8  0.8
      0    1  0.9];
ax = axes('ColorOrder',co,'NextPlot','replacechildren');
plot(ax,rand(5))

色の順序で次に使用する色。正の整数として指定します。たとえば、このプロパティを 1 に設定すると、座標軸に追加される次のプロットは、色の順序の最初の色を使用します。インデックス値が色の順序の色数を超える場合、インデックス値を色数で除算した後の剰余により、次に使用する色が決まります。

hold on コマンドを使用した場合、あるいは座標軸の NextPlot プロパティが 'add' に設定されている場合、新しいプロットが追加されるたびに色の順序のインデックス値が増加します。色の順序をリセットするには、ColorOrderIndex プロパティを 1 に設定します。

例: ax.ColorOrderIndex = 5

ライン スタイルの順序。文字ベクトル、文字ベクトルの cell 配列または string 配列として指定します。表にあるライン スタイル指定子のうち 1 つ以上を使用して各要素を作成します。ラインとマーカーの指定子を組み合わせて '-*' などのように 1 つの要素にすることができます。

例: {'-*',':','o'}

MATLAB で ColorOrder プロパティに格納されている色がすべて使用された後にのみ、次のライン スタイルが繰り返し使用されます。既定の LineStyleOrder にはライン スタイル '-' が 1 つだけ含まれています。

指定子ライン スタイル
'-' (既定) 実線
'--'破線
':'点線
'-.'一点鎖線
'+'プラス記号のマーカー
'o'円形のマーカー
'*'星印のマーカー
'.'点のマーカー
'x'X 印のマーカー
's'四角形のマーカー
'd'菱形のマーカー
'^'上向きの三角形のマーカー
'v'下向きの三角形のマーカー
'>'右向きの三角形のマーカー
'<'左向きの三角形のマーカー
'p'星形五角形のマーカー
'h'星形六角形のマーカー

プロットの前にライン スタイルの順序を変更

ライン スタイルの順序の変更はプロットの前に行わなければなりません。順序を変更しても、既存のプロットには影響しません。ただし、グラフィックス関数の多くで、プロットの前にライン スタイルの順序が既定値にリセットされます。指定したライン スタイルの順序を座標軸で確実に使用するには、次のいずれかの方法を使用します。

  • プロットの前に、座標軸の "既定" のライン スタイルの順序を変更する。

  • プロットの前に、座標軸の NextPlot プロパティを 'replacechildren' または 'add' に設定する。

たとえば、次のコードは、今後のすべての座標軸について既定のライン スタイルの順序を変更します。

set(groot,'defaultAxesLineStyleOrder',{'-*',':','o'})
plot(rand(15))
ライン スタイルの順序を元に戻すには、次のコマンドを使用します。
set(groot,'defaultAxesLineStyleOrder','remove')

あるいは、プロットの前に Axes オブジェクトの NextPlot プロパティを 'replacechildren' に設定します。既存のプロットが新しいプロットに置き換わり、最初の色とライン スタイルが使用されますが、座標軸の他のプロパティはリセットされません。

ax = axes('LineStyleOrder',{'-*',':','o'},'NextPlot','replacechildren');
plot(ax,rand(15))

ライン スタイルの順序で次に使用するライン スタイル。正の整数として指定します。たとえば、このプロパティを 1 に設定すると、座標軸に追加される次のプロットでは、ライン スタイルの順序における最初のライン スタイルが使用されます。インデックス値が、ライン スタイルの順序に含まれるライン スタイルの数を超える場合、インデックス値をライン スタイルの数で除算した後の剰余により、次に使用するライン スタイルが決まります。

hold on コマンドを使用した場合、あるいは座標軸の NextPlot プロパティが 'add' に設定されている場合、新しいプロットが追加されるたびにインデックス値が増加します。その後のプロットは、ライン スタイルの順序を繰り返し使用します。ライン スタイルの順序をリセットするには、LineStyleOrderIndex プロパティを 1 に設定します。

例: ax.LineStyleOrderIndex = 1

座標軸への新しいプロットの追加時にリセットするプロパティ。次の値のいずれかとして指定します。

  • 'add' — 既存の座標軸に新しいプロットを追加します。新しいプロットを表示する前に、既存のプロットの削除や、座標軸のプロパティのリセットは行いません。

  • 'replacechildren' — 既存のプロットを削除してから、新しいプロットを表示します。ColorOrderIndex プロパティおよび LineStyleOrderIndex プロパティを 1 にリセットしますが、座標軸のその他のプロパティはリセットしません。この座標軸に追加する次のプロットでは、ColorOrder および LineStyle の順序のプロパティに基づいて最初の色とライン スタイルが使用されます。この値は、個々の新しいプロットの前に cla を使用する場合と似ています。

  • 'replace' — 既存のプロットを削除し、PositionUnits を除く座標軸のプロパティを既定値にリセットしてから新しいプロットを表示します。

  • 'replaceall' — 既存のプロットを削除し、PositionUnits を除く座標軸のプロパティを既定値にリセットしてから新しいプロットを表示します。この値は、個々の新しいプロットの前に cla reset を使用する場合と似ています。

メモ

y 軸が 1 本だけの Axes オブジェクトの場合、'replace' プロパティと 'replaceall' プロパティの値は等価です。y 軸が 2 本ある Axes オブジェクトの場合、'replace' の値はアクティブな側にのみ影響しますが、'replaceall' の値は両側に影響します。

NextPlot プロパティは Figure にもあります。または、関数 newplot を使用して、後続のグラフィックス コマンド用の Figure と座標軸を用意することもできます。

オブジェクトのレンダリング順序。次の値のいずれかとして指定します。

  • 'depth' — 現在の表示に基づいて背面から前面の順にオブジェクトを描画します。この値を使用すると、他のオブジェクトよりも前面にあるオブジェクトが正しく描画されます。

  • 'childorder' — 3 次元でのオブジェクトの位置関係を考慮せずに、グラフィックス関数で作成された順にオブジェクトを描画します。この値を使用するとレンダリング速度が上がり、特に Figure が非常に大きい場合に便利ですが、表示されるオブジェクトの前後方向の並べ替えが適切にならないこともあります。

カラーマップと透明度マップ

すべて展開する

カラーマップ。m の個々の色を定義する RGB (赤、緑、青) 3 成分の m3 列の配列として指定します。

例: ax.Colormap = [1 0 1; 0 0 1; 1 1 0] は、カラーマップを、マゼンタ、青、黄の 3 色に設定します。

MATLAB は、行番号でこれらの色にアクセスします。

あるいは、関数 colormap を使用してカラーマップを変更します。

カラーマップのスケール。次の値のいずれかとして指定します。

  • 'linear' — 線形スケール。カラーバーの目盛り値も線形スケールを使用します。

  • 'log' — 対数スケール。カラーバーの目盛り値も対数スケールを使用します。

例: ax.ColorScale = 'log'

カラーマップを使用する座標軸のオブジェクトの色の範囲。[cmin cmax] の形式の 2 要素ベクトルとして指定します。このプロパティは、データ値をカラーマップの色にどのようにマッピングするかを定義します。

  • cmin は、カラーマップの最初の色にマッピングされるデータ値を指定します。

  • cmax は、カラーマップの最後の色にマッピングされるデータ値を指定します。

Axes オブジェクトは、cmincmax の間のデータ値をカラーマップに従って内挿します。この範囲外の値には、最初と最後のいずれか近い方の色が使用されます。

CLim プロパティの選択モード。次の値のいずれかとして指定します。

  • 'auto' — 座標軸に含まれるグラフィックス オブジェクトのカラー データに基づいて、範囲が自動的に選択されます。

  • 'manual' — 値を手動で指定します。値を指定するには、CLim プロパティを設定します。座標軸の子の範囲が変わっても、これらの値は変わりません。

透明度マップ。0 から 1 まで線形に増加する有限アルファ値の配列として指定します。配列のサイズは m 行 1 列または 1 行 m 列にすることができます。MATLAB は配列のインデックスを使用してアルファ値にアクセスします。Alphamap は、任意の長さに設定できます。

透明度マッピングのスケール。次の値のいずれかとして指定します。

  • 'linear' — 線形スケール

  • 'log' — 対数スケール

例: ax.AlphaScale = 'log'

アルファ値の範囲。[amin amax] の形式の 2 要素ベクトルとして指定します。このプロパティは、surface オブジェクト、image オブジェクト、patch オブジェクトなどのグラフィックス オブジェクトの AlphaData 値に影響します。このプロパティは AlphaData 値を Figure の alphamap にどのようにマッピングするかを定義します。

  • amin は、Figure の alphamap の最初のアルファ値にマッピングされるデータ値を指定します。

  • amax は、Figure の alphamap の最後のアルファ値にマッピングされるデータ値を指定します。

Axes オブジェクトは、aminamax の間のデータ値を Figure の alphamap に従って内挿します。この範囲外の値には、alphamap の最初と最後のいずれか近い方の値が使用されます。

alphamap は Figure の Alphamap プロパティに格納されます。詳細については、関数 alpha を参照してください。

ALim プロパティの選択モード。次の値のいずれかとして指定します。

  • 'auto' — 座標軸に含まれるグラフィックス オブジェクトの AlphaData 値に基づいて、範囲が自動的に選択されます。

  • 'manual' — アルファ値の範囲を手動で指定します。アルファ値の範囲を指定するには、ALim プロパティを設定します。

ボックスのスタイル

すべて展開する

背景色。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'

例: ax.Color = [0 0 1];

例: ax.Color = 'b';

例: ax.Color = 'blue';

例: ax.Color = '#0000FF';

座標軸の外枠、目盛り、グリッド ラインのライン幅。ポイント単位の正の数値として指定します。1 ポイントは 1/72 インチです。

例: ax.LineWidth = 1.5

ボックスの外枠。'off' または 'on' として指定します。

説明2 次元での結果3 次元での結果
'off'

座標軸のボックスの外枠を表示しません。

例: ax.Box = 'off'

'on'

座標軸のボックスの外枠を表示します。3 次元表示では、BoxStyle プロパティを使用して外枠の範囲を変更します。

例: ax.Box = 'on'

外枠の色は、XColorYColorZColor の各プロパティで制御します。

例: ax.Box = 'on'

ボックスの外枠スタイル。'back' または 'full' として指定します。このプロパティは 3 次元表示にのみ影響します。

説明結果
'back'

3 次元のボックスの背景部分に外枠を表示します。

例: ax.BoxStyle = 'back'

'full'

3 次元のボックス全体に外枠を表示します。

例: ax.BoxStyle = 'full'

座標軸の範囲へのオブジェクトのクリップ。'on' または 'off' のいずれかとして指定します。Axes オブジェクト内でのオブジェクトのクリップ動作は、Axes オブジェクトの Clipping プロパティおよび個々のオブジェクトの Clipping プロパティの両方によって決まります。Axes オブジェクトのプロパティ値は次の効果をもちます。

  • 'on' — 座標軸内の各オブジェクトが、その Clipping プロパティ値に基づいてそれ自体のクリップ動作を制御できます。

  • 'off' — 個々のオブジェクトの Clipping プロパティ値とは無関係に、座標軸内のすべてのオブジェクトのクリップを無効にします。座標軸の範囲の外側に、オブジェクトの一部が表示される場合があります。たとえば、プロットを作成して hold on コマンドを使用し、軸のスケーリングを固定した後に、元のプロットよりも大きなプロットを追加した場合、オブジェクトの一部が範囲の外側に表示されることがあります。

次の表に、Clipping プロパティの値をさまざまな組み合わせの結果を示します。

axes オブジェクトの Clipping プロパティ各オブジェクトの Clipping プロパティ結果
'on''on'個々のオブジェクトがクリップされます。その他は、クリップされる場合とされない場合があります。
'on''off'個々のオブジェクトはクリップされません。その他は、クリップされる場合とされない場合があります。
'off''on'すべてのオブジェクトはクリップされません。
'off''off'すべてのオブジェクトはクリップされません。

クリップの境界。次の表のいずれかの値として指定します。プロットにマーカーが含まれる場合、データ点が座標軸の範囲内にある限りは MATLAB によりそのマーカー全体が描画されます。

Clipping プロパティが 'off' に設定されている場合、ClippingStyle プロパティの効果はありません。

説明境界領域の例
'3dbox'

座標軸の範囲で定義される座標軸ボックスの 6 つの面に対し、プロット オブジェクトをクリップします。

座標軸の範囲外に太いラインが表示される場合があります。

'rectangle'

任意の表示において座標軸を囲む四角形の境界に対し、プロット オブジェクトをクリップします。

座標軸の範囲で太いラインをクリップします。

背景光の色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。背景光は、座標軸内のすべてのオブジェクトを一様に照らす方向性のない光です。光を追加するには、関数 light を使用します。

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

例: ax.AmbientLightColor = [1 0 1]

例: ax.AmbientLightColor = 'm'

例: ax.AmbientLightColor = 'magenta'

例: ax.AmbientLightColor = '#FF00FF'

位置

すべて展開する

ラベルと余白を含むサイズと位置。[left bottom width height] の形式の 4 要素ベクトルとして指定します。既定では、MATLAB はコンテナーを基準に正規化された単位で値を測定します。単位を変更するには、Units プロパティを設定します。既定値 [0 0 1 1] は、コンテナーの内側全体になります。

  • left 要素と bottom 要素は、コンテナー (通常は Figure、パネルまたはタブ) の左下隅から位置境界の左下隅までの距離を定義します。

  • width 要素と height 要素は、外側の位置境界の寸法です。

以下の図に、OuterPosition 値 (青) と Position 値 (赤) で定義された領域を示します。

座標軸の 2 次元表示座標軸の 3 次元表示

座標軸の位置の詳細については、座標軸のレイアウトの制御を参照してください。

ラベルの余白を除いたサイズと位置。[left bottom width height] の形式の 4 要素ベクトルとして指定します。既定では、MATLAB はコンテナーを基準に正規化された単位で値を測定します。単位を変更するには、Units プロパティを設定します。

  • left 要素と bottom 要素は、コンテナー (通常は Figure、パネルまたはタブ) の左下隅から位置境界の左下隅までの距離を定義します。

  • width 要素と height 要素は、位置境界の寸法です。3 次元表示の座標軸では、Position プロパティは座標軸を囲む最小の四角形です。

座標軸の周りのテキストを考慮して位置を指定する場合は、代わりに OuterPosition プロパティを設定します。以下の図に、OuterPosition 値 (青) と Position 値 (赤) で定義された領域を示します。

座標軸の 2 次元表示座標軸の 3 次元表示

座標軸の位置の詳細については、座標軸のレイアウトの制御を参照してください。

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

テキスト ラベル用の余白。[left bottom right top] の形式の 4 要素ベクトルとして指定します。既定では、MATLAB はコンテナーを基準に正規化された単位で値を測定します。単位を変更するには、Units プロパティを設定します。

その要素は、Position プロパティの境界から周囲のテキストの範囲までの距離を定義します。Position 値と TightInset 値の組み合わせは、座標軸と周囲のテキストを囲む最も狭い境界ボックスを定義します。

以下の図に、OuterPosition 値 (青)、Position 値 (赤)、および TightInset 値 (マゼンタ) で拡張された Position によって定義される各領域を示します。

座標軸の 2 次元表示座標軸の 3 次元表示

詳細については、座標軸のレイアウトの制御を参照してください。

サイズ変更実行時のアクティブな位置プロパティ。次の値のいずれかとして指定します。

  • 'outerposition'OuterPosition プロパティを一定に保ちます。

  • 'position'Position プロパティを一定に保ちます。

Figure のサイズは、対話形式でサイズを変更する場合と印刷またはエクスポートの実行時に変更できます。

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

Units説明
'normalized' (既定)コンテナー (通常は Figure またはパネル) を基準に正規化されます。コンテナーの左下隅は (0,0) に、右上隅は (1,1) にマッピングされます。
'inches'インチ。
'centimeters'センチメートル。
'characters'

グラフィックス ルート オブジェクトの既定の uicontrol フォントに基づきます。

  • 文字の幅 = 文字 x の幅。

  • 文字の高さ = 2 行のテキストのベースライン間の距離。

'points'タイポグラフィのポイント。1 ポイントは 1/72 インチです。
'pixels'

ピクセル。

R2015b 以降、Windows および Macintosh システムにおいて、ピクセル単位の距離はシステム解像度に依存しません。

  • Windows システムの 1 ピクセルは 1/96 インチです。

  • Macintosh システムの 1 ピクセルは 1/72 インチです。

  • Linux システムでは、ピクセルのサイズは使用しているシステムの解像度によって決まります。

オブジェクトの作成中に Name,Value のペアとして単位を指定する場合、それらの単位を使用するプロパティ (Position など) を指定する前に Units プロパティを設定しなければなりません。

各軸のデータ単位の相対的な長さ。[dx dy dz] の形式の 3 要素ベクトルとして指定します。このベクトルは、xyz のデータの相対的なスケール係数を定義します。たとえば、このプロパティを [1 2 1] と指定すると、x 軸のデータ単位が 1、y 軸のデータ単位が 2、z 軸のデータ単位が 1 に設定されます。

あるいは、関数 daspect を使用してデータの縦横比を変更します。

例: ax.DataAspectRatio = [1 1 1]

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

データの縦横比モード。次の値のいずれかとして指定します。

  • 'auto' — 利用できる領域を最大に活用する値を自動的に選択します。PlotBoxAspectRatioModeCameraViewAngleMode'auto' に設定した場合、"表示域に合わせる" 動作を有効にします。Position プロパティで定義された利用可能なスペースを満たすように座標軸を拡張します。

  • 'manual' — "表示域に合わせる" 動作を無効にし、手動で指定されたデータの縦横比を使用します。値を指定するには、DataAspectRatio プロパティを設定します。

各軸の相対的な長さ。[px py pz] の形式の 3 要素ベクトルとして指定します。このベクトルは、x 軸、y 軸、z 軸の相対的なスケール係数を定義します。プロット ボックスは、座標軸の範囲の定義に従って座標軸のデータ領域を取り囲むボックスです。

あるいは、関数 pbaspect を使用してデータの縦横比を変更します。

軸の範囲、データの縦横比、プロット ボックスの縦横比を指定した場合、MATLAB はプロット ボックスの縦横比を無視します。軸の範囲とデータの縦横比に従います。

例: ax.PlotBoxAspectRatio = [1 0.75 0.75]

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

PlotBoxAspectRatio プロパティの選択モード。次の値のいずれかとして指定します。

  • 'auto' — 利用できる領域を最大に活用する値を自動的に選択します。DataAspectRatioModeCameraViewAngleMode'auto' に設定した場合、"表示域に合わせる" 動作を有効にします。Position プロパティで定義された利用可能なスペースを満たすように Axes オブジェクトを拡張します。

  • 'manual' — "表示域に合わせる" 動作を無効にし、手動で指定されたプロット ボックスの縦横比を使用します。値を指定するには、PlotBoxAspectRatio プロパティを設定します。

ビュー

すべて展開する

視点の方位角と仰角。[azimuth elevation] の形式の 2 要素ベクトル (度単位) として指定します。または、関数 view を使用して表示を設定します。

例: ax.View = [45 45]

2 次元の画面への射影のタイプ。次の値のいずれかとして指定します。

  • 'orthographic' — 視点から与えられた点までの距離に関して、グラフィックス オブジェクトの相対的な大きさを正しく保ち、データ内の平行線を画面上でも平行に描画します。

  • 'perspective' — 3 次元のオブジェクトの 2 次元表現で奥行きが感じられるように、遠近法を組み込みます。遠近法では、オブジェクトの相対的な大きさは維持されません。同じ長さの線でも、遠いものは近いものに比べ短く表示されます。データ内の平行線は、画面上では平行ではない場合があります。

カメラの位置 (視点)。[x y z] の形式の 3 要素ベクトルとして指定します。このベクトルは、座標軸を見る視点である、カメラの位置の各軸の座標を定義します。カメラの向きは、カメラの位置とカメラのターゲットを直線でつないだ視点軸の方向になります。詳細については、カメラ グラフィックス用語を参照してください。

Projection プロパティが 'perspective' に設定されている場合、CameraPosition 設定を変更すると遠近の度合いも変化します。

あるいは、関数 campos を使用してカメラの位置を設定します。

例: ax.CameraPosition = [0.5 0.5 9]

データ型: single | double

CameraPosition プロパティの選択モード。次の値のいずれかとして指定します。

  • 'auto'CameraPosition を視点軸に沿って自動的に設定します。関数 view から返される現在のビューで指定された方位角と仰角に従って、カメラがターゲットから一定の距離に固定されるように位置を計算します。rotate3dzoompan などの関数は、対応するアクションを実行するためにこのモードを 'auto' に変更します。

  • 'manual' — 値を手動で指定します。値を指定するには、CameraPosition プロパティを設定します。

カメラのターゲット ポイント。[x y z] 形式の 3 要素ベクトルとして指定します。このベクトルは、点の各軸の座標を定義します。カメラの向きは、カメラの位置とカメラのターゲットを直線でつないだ視点軸の方向になります。詳細については、カメラ グラフィックス用語を参照してください。

あるいは、関数 camtarget を使用してカメラのターゲットを設定します。

例: ax.CameraTarget = [0.5 0.5 0.5]

データ型: single | double

CameraTarget プロパティの選択モード。次の値のいずれかとして指定します。

  • 'auto' — カメラのターゲットを座標軸のプロット ボックスの中央に設定します。

  • 'manual' — 手動で指定したカメラのターゲットの点を使用します。値を指定するには、CameraTarget プロパティを設定します。

上方向を定義するベクトル。[x y z] の形式の 3 要素方向ベクトルとして指定します。2 次元表示の既定値は [0 1 0] です。3 次元表示の既定値は [0 0 1] です。詳細については、カメラ グラフィックス用語を参照してください。

あるいは、関数 camup を使用して上方向を設定します。

例: ax.CameraUpVector = [sin(45) cos(45) 1]

CameraUpVector プロパティの選択モード。次の値のいずれかとして指定します。

  • 'auto' — 3 次元表示の場合、z 軸の正の方向が上向きになるように値を [0 0 1] に自動的に設定します。2 次元表示の場合、y 軸の正の方向が上向きになるように値を [0 1 0] に設定します。

  • 'manual' — 上方向を定義するベクトルを手動で指定します。値を指定するには、CameraUpVector プロパティを設定します。

視野。角度を示す 0 より大きい 180 以下のスカラー値として指定します。カメラの視点角度は、座標軸内に表示されるグラフィックス オブジェクトの見掛けのサイズに影響を与えます。しかし、遠近の度合いには影響ありません。角度を大きくすると視野が広くなり、シーンに表示されるオブジェクトが小さく見えます。詳細については、カメラ グラフィックス用語を参照してください。

例: ax.CameraViewAngle = 15

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

CameraViewAngle プロパティの選択モード。次の値のいずれかとして指定します。

  • 'auto' — シーン全体を捉えるのに必要な最小角度 (180 度以下) を視野として自動的に選択します。

  • 'manual' — 視野を手動で指定します。値を指定するには、CameraViewAngle プロパティを設定します。

対話機能

すべて展開する

データ探索ツール バー。AxesToolbar オブジェクトです。ツール バーは、座標軸の右上隅にカーソルを置くと表示されます。

このツール バーのボタンは座標軸の内容に応じて異なりますが、通常はズーム、移動、回転、データ ヒント、データのブラシ選択、および元の表示に戻す機能があります。関数 axtoolbar および関数 axtoolbarbtn を使用して、ツール バーのボタンをカスタマイズできます。

座標軸にカーソルを置いたときにツール バーを表示しないようにする場合は、AxesToolbar オブジェクトの Visible プロパティを 'off' に設定します。

ax = gca;
ax.Toolbar.Visible = 'off';

詳細については、AxesToolbar のプロパティ を参照してください。

操作。操作オブジェクトの配列または空の配列として指定します。指定した操作は、動作を通じてチャート内で使用できます。これらを使用するのに座標軸ツール バーのボタンを選択する必要はありません。たとえば、panInteraction オブジェクトを使用すると、チャート内でドラッグして移動することができます。操作オブジェクトのリストについては、チャートの対話機能の制御を参照してください。

既定の操作セットは、表示するチャートのタイプによって異なります。既定のセットを新しい操作セットに置き換えることはできますが、既定のセットの操作にアクセスしたり、変更したりすることはできません。たとえば、次のコードは、既定の操作セットを panInteraction および zoomInteraction オブジェクトに置き換えます。

ax = gca;
ax.Interactions = [panInteraction zoomInteraction];

すべての操作を座標軸から削除するには、このプロパティを空の配列に設定します。現在の操作セットを一時的に無効にするには、関数 disableDefaultInteractivity を呼び出します。関数 enableDefaultInteractivity を呼び出すことで再度有効にできます。

メモ

  • このプロパティの設定はライブ エディターでサポートされていません。

  • 操作オブジェクトは findobjfindall では返されず、また copyobj ではコピーされません。

可視性の状態。次の値のいずれかとして指定します。

  • 'on' — オブジェクトを表示します。

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

マウス ポインターの位置。2 行 3 列の配列として指定します。CurrentPoint プロパティには、座標軸に対するマウス ポインターの (x、y、z) 座標が格納されます。次の形式の配列が返されます。

[xfront yfront zfront
 xback  yback  zback]

2 点は最後にマウスをクリックした位置を表します。ただし、Figure に WindowButtonMotionFcn コールバックが定義されている場合、これらの点はマウス ポインターの最後の位置を表します。Figure には CurrentPoint プロパティもあります。

遠近法を使用する場合は、座標軸で囲まれる直方体の形が異なるので、同じ点を直交投影した場合と座標が異なることがあります。

直交投影

直交投影を使用している場合、クリックが座標軸内または座標軸外のいずれであるかに応じて値が決まります。

  • 座標軸内をクリックした場合、これらの 2 つの点は、画面の平面に垂直で、ポインターを通る直線上に存在します。その座標は、この直線と、座標軸で囲まれる直方体 (x 軸、y 軸および z 軸の範囲で定義される) の前面および背面との交点の座標です。最初の行は、カメラ位置に最も近い点です。2 番目の行は、カメラ位置から最も遠い点です。これは、2 次元表示と 3 次元表示の両方に適用されます。

  • Figure 内の座標軸外をクリックした場合、これらの点は、ポインターを通りカメラのターゲットおよびカメラ位置の平面に対して垂直な直線上にあります。最初の行は、カメラ位置の平面内にある点です。2 番目の行は、カメラのターゲットの平面内にある点です。

遠近投影

遠近投影で Axes オブジェクトの外側をクリックすると、フロント ポイントが現在のカメラ位置として返されます。バック ポイントだけが、カメラ位置からポインターを通り、カメラのターゲットと交差する線上にある点の座標に更新されます。

コンテキスト メニュー。ContextMenu オブジェクトとして指定します。このプロパティは、オブジェクトを右クリックしたときにコンテキスト メニューを表示するために使用します。関数 uicontextmenu を使用して、コンテキスト メニューを作成します。

メモ

PickableParts プロパティが 'none' に設定されている場合または HitTest プロパティが 'off' に設定されている場合には、このコンテキスト メニューは表示されません。

選択状態。次の値の 1 つとして指定します。

  • 'on' — 選択されています。プロット編集モードでオブジェクトをクリックした場合、MATLAB は Selected プロパティを 'on' に設定します。SelectionHighlight プロパティも 'on' に設定されている場合、MATLAB はオブジェクトの周囲に選択ハンドルを表示します。

  • 'off' — 選択されていません。

選択時に選択ハンドルを表示。次の値の 1 つとして指定します。

  • 'on'Selected プロパティが 'on' に設定されているときに選択ハンドルを表示します。

  • 'off'Selected プロパティが 'on' に設定されている場合でも選択ハンドルを表示しません。

コールバック

すべて展開する

マウスクリック コールバック。次の値のいずれかとして指定します。

  • 関数ハンドル

  • 関数ハンドルと追加の引数を含む cell 配列

  • ベース ワークスペース内で評価される有効な MATLAB コマンドまたは MATLAB 関数の文字ベクトル (非推奨)

このプロパティは、オブジェクトをクリックしたときにコードを実行するために使用します。関数ハンドルを使用してこのプロパティを指定した場合、MATLAB はコールバックを実行するときに次の 2 つの引数をコールバック関数に渡します。

  • クリックしたオブジェクト — コールバック関数内から、クリックしたオブジェクトのプロパティにアクセスします。

  • イベント データ — 空の引数です。この引数が使用されないことを示すために、関数定義の中でこの引数をチルダ文字 (~) に置換します。

関数ハンドルを使用してコールバック関数を定義する方法についての詳細は、コールバック定義を参照してください。

メモ

PickableParts プロパティが 'none' に設定されている場合または HitTest プロパティが 'off' に設定されている場合には、このコールバックは実行されません。

オブジェクト作成関数。次の値のいずれかとして指定します。

  • 関数ハンドル。

  • 最初の要素が関数ハンドルである cell 配列。cell 配列内のその後の要素はコールバック関数に渡される引数です。

  • 有効な MATLAB 式を含む文字ベクトル (非推奨)。MATLAB は、この式をベース ワークスペースで評価します。

コールバックを関数ハンドル、cell 配列、または文字ベクトルとして指定する方法の詳細については、コールバック定義を参照してください。

このプロパティは、MATLAB がオブジェクトを作成するときに実行されるコールバック関数を指定します。MATLAB は CreateFcn コールバックを実行する前に、すべてのプロパティ値を初期化します。CreateFcn プロパティを指定しない場合、MATLAB は既定の作成関数を実行します。

既存のコンポーネントに CreateFcn プロパティを設定しても効果はありません。

このプロパティを関数ハンドルまたは cell 配列として指定した場合、コールバック関数の最初の引数を使用して、作成中のオブジェクトにアクセスできます。それ以外の場合は、関数 gcbo を使用してオブジェクトにアクセスします。

オブジェクト削除関数。次の値のいずれかとして指定します。

  • 関数ハンドル。

  • 最初の要素が関数ハンドルである cell 配列。cell 配列内のその後の要素はコールバック関数に渡される引数です。

  • 有効な MATLAB 式を含む文字ベクトル (非推奨)。MATLAB は、この式をベース ワークスペースで評価します。

コールバックを関数ハンドル、cell 配列、または文字ベクトルとして指定する方法の詳細については、コールバック定義を参照してください。

このプロパティは、MATLAB がオブジェクトを削除するときに実行されるコールバック関数を指定します。MATLAB は、オブジェクトのプロパティを破棄する前に DeleteFcn コールバックを実行します。DeleteFcn プロパティを指定しない場合、MATLAB は既定の削除関数を実行します。

このプロパティを関数ハンドルまたは cell 配列として指定した場合、コールバック関数の最初の引数を使用して、削除されるオブジェクトにアクセスできます。それ以外の場合は、関数 gcbo を使用してオブジェクトにアクセスします。

コールバック実行制御

すべて展開する

コールバックの割り込み。'on' または 'off' として指定します。Interruptible プロパティは実行中のコールバックが割り込み可能かどうかを決定します。

次の 2 つのコールバックの状態について考慮する必要があります。

  • "実行中" コールバックは、現在実行しているコールバックです。

  • "割り込み" コールバックは、実行中のコールバックに割り込もうとするコールバックです。

MATLAB がコールバックを呼び出すたびに、そのコールバックは実行中のコールバック (がある場合) に割り込もうとします。実行中のコールバックを所有するオブジェクトの Interruptible プロパティが、割り込み可能かどうかを決定します。Interruptible プロパティは次の 2 つの値をとることができます。

  • 'on' — 他のコールバックがオブジェクトのコールバックに割り込むことを許可します。割り込みは、drawnowfigureuifiguregetframewaitforpause コマンドなどの、MATLAB が次にキューを処理するポイントで発生します。

    • 実行中のコールバックにこれらのいずれかのコマンドが含まれている場合、MATLAB はそのポイントでコールバックの実行を停止し、割り込みコールバックを実行します。割り込みコールバックが完了すると、MATLAB は実行中だったコールバックの実行を再開します。

    • 実行中のコールバックにこれらのコマンドが含まれていない場合、MATLAB はそのコールバックの実行を割り込みなしで完了します。

  • 'off' — 割り込みの試行をすべてブロックします。割り込みコールバックを所有するオブジェクトの BusyAction プロパティが、その割り込みコールバックを破棄するかキューに入れるかを決定します。

メモ

コールバックの割り込みと実行は、以下の状況では動作が異なります。

  • 割り込みコールバックが DeleteFcnCloseRequestFcn または SizeChangedFcn の各コールバックの場合、Interruptible プロパティの値にかかわらず割り込みが発生します。

  • 実行中のコールバックが関数 waitfor を現在実行している場合、Interruptible プロパティの値にかかわらず割り込みが発生します。

  • Timer オブジェクトは、Interruptible プロパティ値にかかわらず、スケジュールに従って実行されます。

MATLAB は、割り込みが発生したときにプロパティの状態や表示を保存しません。たとえば、gca コマンドや gcf コマンドから返されたオブジェクトは、別のコールバックを実行するときに変更されている可能性があります。

コールバック キューイング。'queue' または 'cancel' として指定します。BusyAction プロパティは MATLAB による割り込みコールバックの実行の処理方法を決定します。次の 2 つのコールバックの状態について考慮する必要があります。

  • "実行中" コールバックは、現在実行しているコールバックです。

  • "割り込み" コールバックは、実行中のコールバックに割り込もうとするコールバックです。

MATLAB がコールバックを呼び出すたびに、そのコールバックは実行中のコールバックに割り込もうとします。実行中のコールバックを所有するオブジェクトの Interruptible プロパティが、割り込みを許可するかどうかを決定します。割り込みが許可されない場合は、割り込みコールバックを所有するオブジェクトの BusyAction プロパティが、そのコールバックを破棄するかキューに入れるかを決定します。BusyAction プロパティは次の値を取ることができます。

  • 'queue' — 割り込みコールバックをキューに入れ、実行中のコールバックが終了した後に処理されるようにします。

  • 'cancel' — 割り込みコールバックを実行しません。

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

  • 'visible' — 表示されている場合にのみマウス クリックをキャプチャします。Visible プロパティは、'on' に設定しなければなりません。Axes オブジェクトがクリックに応答するか、先祖がクリックに応答するかは、HitTest プロパティが決定します。

  • 'all' — 表示状態に関係なくマウス クリックをキャプチャします。Visible プロパティは 'on' または 'off' に設定できます。Axes オブジェクトがクリックに応答するか、先祖がクリックに応答するかは、HitTest プロパティが決定します。

  • 'none' — マウス クリックをキャプチャしません。Axes オブジェクトをクリックすると、Figure ウィンドウの現在のビュー内でその下にあるオブジェクト (通常は axes または figure) にクリックが渡されます。HitTest プロパティは無効になります。

クリック可能にしない他のオブジェクトの下にあるオブジェクトをクリック可能にする場合は、他のオブジェクトをクリックが通過するように、それらのオブジェクトの PickableParts プロパティを 'none' に設定します。

キャプチャしたマウス クリックへの応答。次の値の 1 つとして指定します。

  • 'on'Axes オブジェクトの ButtonDownFcn コールバックをトリガーします。UIContextMenu プロパティが定義されている場合は、コンテキスト メニューを呼び出します。

  • 'off'Axes オブジェクトの先祖のうち、次のいずれかの条件を満たす最も近い先祖のコールバックをトリガーします。

    • HitTest プロパティが 'on' に設定されている

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

メモ

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

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

削除状態。'off' または 'on' として返されます。MATLAB は、DeleteFcn コールバックが実行を開始すると、BeingDeleted プロパティを 'on' に設定します。コンポーネント オブジェクトが存在しなくなるまで BeingDeleted プロパティは 'on' に設定されたままです。

クエリや変更の前にオブジェクトが削除されようとしていないか確認するために BeingDeleted プロパティの値をチェックします。

親/子

すべて展開する

親。Figure オブジェクト、Panel オブジェクトまたは Tab オブジェクトとして指定します。

子。グラフィックス オブジェクトの配列として返されます。このプロパティは、子のリストの参照や子の並べ替えに使用します。子を並べ替えるには、このプロパティ自体で値の順序を並べ替えます。

Children プロパティを使用して子の追加や削除を行うことはできません。このリストに子を追加するには、子グラフィックス オブジェクトの Parent プロパティにこの Axes オブジェクトを設定します。

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

  • 'on' — オブジェクト ハンドルは常に表示されます。

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

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

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

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

識別子

すべて展開する

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

グラフィックス オブジェクトのタイプ。'axes' として返されます。

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

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

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

R2006a より前に導入