Main Content

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

Axes のプロパティ

座標軸の外観と動作

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

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

フォント

すべて展開する

フォント名。サポートされているフォント名または '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' もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off'false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

説明結果
'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 マークアップのサブセットを使用してラベルを解釈します。目盛りラベルを指定するときには、cell 配列の各要素をドル記号で囲みます。

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

TeX マークアップ

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

修飾子の効果はテキストの末尾まで適用されます。上付き文字と下付き文字は例外であり、次の 1 文字または中かっこで囲まれた文字にのみ適用されます。インタープリターを 'tex' に設定した場合にサポートされる修飾子は次のとおりです。

修飾子説明
^{ }上付き文字'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}フォントの色 — specifier を、redgreenyellowmagentablueblackwhitegraydarkGreenorangelightBlue の色のいずれかに置き換えます。'\color{magenta} text'
\color[rgb]{specifier}フォントのカスタムの色 — specifier を RGB 3 成分に置き換えます。'\color[rgb]{0,0.5,0.5} text'

次の表に、'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 の既定のフォント スタイルで表示され、FontNameFontWeightFontAngle のプロパティは無視されます。フォント スタイルを変更するには、テキスト内で LaTeX マークアップを使用します。LaTeX インタープリターで使用できるテキストの最大サイズは 1200 文字です。複数行のテキストの場合、テキストの最大サイズは 1 行につき 10 文字ほど文字数が少なくなります。

LaTeX システムの詳細については、LaTeX プロジェクトの Web サイト (https://www.latex-project.org/) を参照してください。

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

例: ax.XTickLabelRotation = 45

例: ax.YTickLabelRotation = 90

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

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

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

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

例: 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'

グリッド

すべて展開する

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

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

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

あるいは、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'

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

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

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

または、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 列の行列として指定します。このプロパティは、LineScatterBar オブジェクトなどのプロット オブジェクトの作成に MATLAB が使用するカラー パレットを定義します。配列の各行は RGB 3 成分です。RGB 3 成分は、各要素が色の赤、緑、青の成分の強度を指定する 3 成分のベクトルです。強度値は [0, 1] の範囲でなければなりません。次の表に既定の色を示します。

行列 ColorOrder


    [    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]

MATLAB はオブジェクトの作成順に従って、オブジェクトに色を割り当てます。たとえば、ラインのプロット時に、1 番目のラインには 1 番目の色を使用し、2 番目のラインには 2 番目の色を使用します。それ以降も同様です。ライン数が色数より多い場合、このサイクルが繰り返されます。

プロット前後での色の順序の変更

R2019b 以降、次のいずれかの方法で色の順序を変更できます。

  • 関数 colororder を呼び出して、Figure 内のすべての座標軸の色の順序を変更する。Figure 内の既存のプロットの色がただちに更新されます。追加の座標軸を Figure に配置した場合、それらの座標軸も新しい色の順序を使用します。引き続きプロット コマンドを呼び出した場合、それらのコマンドも新しい色を使用します。

  • 座標軸の ColorOrder プロパティを設定し、関数 hold を呼び出して座標軸のホールド状態を 'on' に設定してから、目的のプロット関数を呼び出す。これは関数 colororder の呼び出しに似ていますが、この場合、Figure 全体ではなく、特定の座標軸について色の順序を設定します。後続のプロット コマンドが座標軸をリセットして既定の色の順序を使用することを確実に防ぐには、hold 状態を 'on' にする必要があります。

R2019a またはそれ以前のリリースを使用している場合、色の順序行列を変更しても既存のプロットには影響しません。既存のプロットの色を変更するには、ColorOrder プロパティを設定し、座標軸のホールド状態を 'on' にしてからプロット関数を呼び出さなければなりません。

このプロパティの動作は R2019b で変更されました。詳細については、以下を参照してください。

ライン スタイルの順序。文字ベクトル、文字ベクトルの cell 配列、または string 配列として指定します。このプロパティは、座標軸に複数のプロット ラインを表示するために MATLAB が使用するライン スタイルをリストします。MATLAB はラインの作成順に従って、ラインにスタイルを割り当てます。現在のライン スタイルで ColorOrder プロパティのすべての色が 1 巡した後にのみ、次のライン スタイルに変更されます。既定の LineStyleOrder にはライン スタイル '-' が 1 つだけ含まれています。

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

ライン指定子説明
'-' (既定) 実線
'--'破線
':'点線
'-.'一点鎖線

マーカー指定子説明
'+'プラス記号のマーカー
'o'円形のマーカー
'*'星印のマーカー
'.'点のマーカー
'x'X 印のマーカー
's'四角形のマーカー
'd'菱形のマーカー
'^'上向きの三角形のマーカー
'v'下向きの三角形のマーカー
'>'右向きの三角形のマーカー
'<'左向きの三角形のマーカー
'p'星形五角形のマーカー
'h'星形六角形のマーカー

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

R2019b 以降、座標軸へのプロットの前後でライン スタイルの順序を変更できます。LineStyleOrder プロパティを新しい値に設定すると、MATLAB は座標軸内にあるすべてのラインのスタイルを更新します。引き続き座標軸にプロットする場合、プロット コマンドは更新されたリストのライン スタイルを使用し続けます。

R2019a またはそれ以前のリリースを使用している場合は、プロットの前にライン スタイルを変更しなければなりません。LineStyleOrder プロパティの値を設定し、関数 hold を呼び出して座標軸のホールド状態を 'on' に設定してから、プロット関数を呼び出します。

このプロパティの動作は R2019b で変更されました。詳細については、以下を参照してください。

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

座標軸に追加された次のプロット オブジェクトの SeriesIndex 値。0 以上の正の整数として返されます。このプロパティは、オブジェクトが色およびライン スタイルをどのように周期的に繰り返すのかを追跡する場合に便利です。このプロパティは SeriesIndex プロパティをもつ座標軸でオブジェクトのカウントを保持します。MATLAB はこれを使用して SeriesIndex 値を新しいオブジェクトごとに代入します。このカウントは座標軸の作成時に 1 で開始され、オブジェクトが追加されるたびに 1 ずつ増加します。したがって、このカウントは通常 n+1 です。ここで、n は座標軸のオブジェクトの数です。

座標軸で ColorOrderIndex プロパティまたは LineStyleOrderIndex プロパティを手動で変更すると、NextSeriesIndex プロパティの値は 0 に変更されます。その結果、SeriesIndex プロパティをもつオブジェクトは、座標軸で ColorOrder プロパティまたは LineStyleOrder プロパティを変更するときに自動的に更新されなくなります。

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

  • '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 が非常に大きい場合に便利ですが、表示されるオブジェクトの前後方向の並べ替えが適切にならないこともあります。

色の順序のインデックス。正の整数として指定します。このプロパティは、MATLAB が LineScatterBar オブジェクトなど、次のプロット オブジェクトを作成するときに、座標軸の ColorOrder プロパティから選択する次の色を指定します。たとえば、色の順序のインデックス値が 1 の場合、座標軸に追加される次のオブジェクトには行列 ColorOrder の 1 番目の色が使用されます。インデックス値が行列 ColorOrder の色数を超える場合、インデックス値を行列 ColorOrder の色数で除算した後の剰余により、次のオブジェクトの色が決まります。

座標軸の NextPlot プロパティが 'add' に設定されている場合、座標軸に新しいプロットが追加されるたびに色の順序のインデックス値が増加します。再び 1 番目の色で開始するには、ColorOrderIndex プロパティを 1 に設定します。

このプロパティの動作は R2019b で変更されました。詳細については、ColorOrder および LineStyleOrder のインデックス方式によっては、プロットの色とライン スタイルが変化を参照してください。

ライン スタイルの順序のインデックス。正の整数として指定します。このプロパティは、次のプロット ラインを作成するために MATLAB が座標軸の LineStyleOrder プロパティから選択する次のライン スタイルを指定します。たとえば、このプロパティを 1 に設定すると、座標軸に追加される次のプロット ラインでは、LineStyleOrder プロパティの 1 番目の項目が使用されます。インデックス値が配列 LineStyleOrder のライン スタイルの数を超える場合、インデックス値を配列 LineStyleOrder の要素数で除算した後の剰余により、次のライン スタイルが決まります。

座標軸の NextPlot プロパティが 'add' に設定されている場合、MATLAB は現在のライン スタイルで ColorOrder プロパティのすべての色を 1 巡した後にインデックス値をインクリメントします。再び 1 番目のライン スタイルで開始するには、LineStyleOrderIndex プロパティを 1 に設定します。

このプロパティの動作は R2019b で変更されました。詳細については、ColorOrder および LineStyleOrder のインデックス方式によっては、プロットの色とライン スタイルが変化を参照してください。

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

すべて展開する

カラーマップ。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

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

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

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

例: ax.Box = 'on'

'off'

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

例: ax.Box = 'off'

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

例: ax.Box = 'on'

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

説明結果
'back'

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

例: ax.BoxStyle = 'back'

'full'

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

例: ax.BoxStyle = 'full'

座標軸の範囲でのオブジェクトのクリップ。'on' または 'off'、もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off'false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

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 次元表示

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

メモ

親コンテナーが TiledChartLayout の場合、このプロパティを設定しても効果はありません。

内側のサイズと位置。[left bottom width height] の形式の 4 要素ベクトルとして指定します。このプロパティは、Position プロパティと等価です。

メモ

親コンテナーが TiledChartLayout の場合、このプロパティを設定しても効果はありません。

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

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

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

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

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

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

メモ

親コンテナーが TiledChartLayout の場合、このプロパティを設定しても効果はありません。

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

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

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

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

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

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

装飾の追加、削除または変更を行うときに一定に保つ位置プロパティ。次の値のいずれかとして指定します。

  • 'outerposition' — タイトルや軸ラベルなどの装飾の追加、削除、または変更を行うときに、OuterPosition プロパティが一定に保たれます。位置の調整が必要な場合、MATLAB は InnerPosition プロパティを調整します。

  • 'innerposition' — タイトルや軸ラベルなどの装飾の追加、削除、または変更を行うときに、InnerPosition プロパティが一定に保たれます。位置の調整が必要な場合、MATLAB は OuterPosition プロパティを調整します。

メモ

親コンテナーが TiledChartLayout の場合、このプロパティを設定しても効果はありません。

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

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

レイアウト オプション。TiledChartLayoutOptions オブジェクトとして指定します。このプロパティは、座標軸がタイル表示チャート レイアウトの子である場合のオプションを指定します。このプロパティを使用してレイアウト内に座標軸を配置するには、TiledChartLayoutOptions オブジェクトの Tile プロパティと TileSpan プロパティを設定します。

たとえば、次のコードはタイル表示チャート レイアウトの 3 番目のタイルに座標軸 ax を配置します。

ax.Layout.Tile = 3;

複数のタイルにわたって座標軸を広げるには、TileSpan プロパティを 2 要素ベクトルとして指定します。たとえば、次の座標軸は 23 列のタイルに広がります。

ax.Layout.TileSpan = [2 3];

座標軸がタイル表示チャート レイアウトの子ではない場合 (たとえば、Figure またはパネルの子である場合)、このプロパティは空で、効果はありません。

ビュー

すべて展開する

視点の方位角と仰角。[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'、もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off'false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

  • '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' に設定されている場合には、このコンテキスト メニューは表示されません。

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

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

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

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

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

このプロパティは実行中のコールバックが割り込み可能かどうかを決定します。次の 2 つのコールバックの状態について考慮する必要があります。

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

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

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

  • 値が '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' に設定します。

キャプチャしたマウス クリックへの応答。'on' または 'off'、もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off'false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

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

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

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

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

メモ

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

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

削除状態。matlab.lang.OnOffSwitchState 型の on/off logical 値として返されます。

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

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

親/子

すべて展開する

親コンテナー。FigurePanelTab または TiledChartLayout オブジェクトとして指定します。

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

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

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

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

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

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

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

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

識別子

すべて展開する

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

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

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

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

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

互換性についての考慮事項

すべて展開する

R2020a 以降は非推奨

R2020a 以降は非推奨

R2019b での動作変更

R2019b での動作変更

R2006a より前に導入