Main Content

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

GeographicAxes のプロパティ

地理座標軸の外観と動作の制御

GeographicAxes プロパティは、GeographicAxes オブジェクトの外観と動作を制御します。プロパティの値を変更することによって、地理座標軸の一部の特性を変更できます。座標軸のプロパティは、一部のグラフィックス関数によってリセットされるため、プロット後に設定します。

一部のグラフィックス関数はプロット時に地理座標軸を作成します。gca を使用して、新しく作成された座標軸にアクセスします。すべてのプロパティの既定値を使用して地理座標軸を作成するには、関数 geoaxes を使用します。

gx = geoaxes;

マップ

すべて展開する

データがプロットされるマップ。表にリストされている値のいずれかとして指定します。6 つのベースマップは、Natural Earth を使用して作成されたタイル表示のデータセットです。5 つのベースマップは、Esri® によってホストされる高ズームレベルのマップです。

'satellite' basemap.

'satellite'

高解像度の衛星写真で構成される地球全体のベースマップ。

Esri によりホストされています。

'streets' basemap.

'streets'

道路と輸送網を正確で見やすいスタイルで強調した汎用道路マップ。

Esri によりホストされています。

'topographic' basemap.

'topographic'

地形的な特徴を示すスタイルを備えた汎用マップ。

Esri によりホストされています。

'streets-dark' basemap.

'streets-dark'

地理コンテキストを提供し、暗い背景にユーザー データを強調表示するように設計されたマップ。

Esri によりホストされています。

'landcover' basemap.

'landcover'

衛星から得られた土地被覆データ、影付きの起伏および海底起伏を組み合わせたマップ。主題マップと参照マップには、明るくナチュラルなパレットが適しています。

Natural Earth を使用して作成されています。

'streets-light' basemap.

'streets-light'

地理コンテキストを提供し、明るい背景にユーザー データを強調表示するように設計されたマップ。

Esri によりホストされています。

'colorterrain' basemap.

'colorterrain'

土地被覆パレットとブレンドされた影付き起伏マップ。高湿度の低地は緑、乾燥した低地は茶。

Natural Earth を使用して作成されています。

'grayterrain' basemap.

'grayterrain'

グレー階調の地形マップ。影付きの起伏により、高山と、低地で検出された微小地形の両方が強調されます。

Natural Earth を使用して作成されています。

'bluegreen' basemap.

'bluegreen'

2 トーンの陸海マップ。陸地部分は薄い緑、水域は薄い青。

Natural Earth を使用して作成されています。

'grayland' basemap.

'grayland'

2 トーンの陸海マップ。陸地部分はグレー、水域は白。

Natural Earth を使用して作成されています。

'darkwater' basemap.

'darkwater'

2 トーンの陸海マップ。陸地部分はライト グレー、水域はダーク グレー。このベースマップは MATLAB® と共にインストールされています。

Natural Earth を使用して作成されています。

 

'none'

空白の背景。緯度経度グリッド、目盛り、ラベルを使用してデータをプロットします。

'darkwater' 以外のすべてのベースマップで、インターネット アクセスが必要です。'darkwater' ベースマップは、MATLAB に含まれています。

インターネットへの安定したアクセスがない場合、アドオン エクスプローラーを使用して、Natural Earth を使用して作成されたベースマップをローカル システムにダウンロードできます。5 つの高ズームレベル マップはダウンロードできません。ローカル システムでのベースマップのダウンロードと、既定のベースマップの変更の詳細については、地理座標軸とチャートのベースマップへのアクセスを参照してください。

境界の配置と地域ラベルはデータ ベンダーが提供する機能による表現であり、MathWorks® の承認を意味するものではありません。

例: gb = geobubble(1:10,1:10,'Basemap','bluegreen')

例: gb.Basemap = 'bluegreen'

データ型: char | string

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

マップの緯度の範囲。[-90,90] の範囲にある有限の実数値の 1 行 2 列のベクトルを [southern_limit northern_limit] の形式で指定します。緯度の範囲を変更するには、関数 geolimits を使用します。

例: [-85 85]

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

マップの経度の範囲。有限の実数値からなる [western_limit eastern_limit] の形式の 1 行 2 列のベクトルとして指定します。値は (-Inf, Inf) の範囲内でなければなりません。経度の範囲を変更するには、関数 geolimits を使用します。

例: [-100 100]

マップの中心点の緯度と経度。有限の実数値からなる [center_latitude center_longitude] 形式の 2 要素ベクトルとして指定します。

例: [38.6292 -95.2520]

マップ中心の選択モード。次の値のいずれかとして指定します。

  • 'auto' — データの範囲に基づいて、オブジェクトがマップ中心を自動的に選択します。

  • 'manual'MapCenter の値を指定すると、オブジェクトはこのプロパティを自動的に 'manual' に設定します。

例: gx.MapCenterMode = 'auto'

マップの倍率レベル。0 ~ 25 (等値を含む) の有限の実数値スカラーとして指定します。値は、基底 2 の対数マップ スケールです。ZoomLevel 値を 1 増加すると、マップ スケールは 2 倍になります。

ズーム レベルの選択モード。次の値のいずれかとして指定します。

  • 'auto' — データの範囲に基づいて、オブジェクトがズーム レベルを選択します。

  • 'manual'ZoomLevel の値を指定すると、オブジェクトはこのプロパティを自動的に 'manual' に設定します。

例: gx.ZoomLevelMode = 'manual'

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

マップ上の比例距離を表示するスケール バー。GeographicScalebar オブジェクトとして指定します。スケール バーの外観と動作 (可視性など) を変更するには、GeographicScalebar オブジェクトのプロパティを使用します。これらのプロパティの詳細については、GeographicScalebar のプロパティ を参照してください。

例: sbar = gx.Scalebar は、GeographicScalebar オブジェクトを返します。

例: gx.Scalebar.Visible = 'off'; は、GeographicScalebar プロパティの値を設定します。

フォント

すべて展開する

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

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

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

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

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

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

  • スケール バー — 既定では座標軸のフォント サイズの 80% です。

例: gx.FontSize = 12

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

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

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

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

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

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

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

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

例: gx.LabelFontSizeMultiplier = 1.75

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

例: gx.TitleFontSizeMultiplier = 1.75

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

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

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

例: gx.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 プロパティを設定しなければなりません。

目盛り

すべて展開する

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

説明
'in'軸のラインの内側に目盛りを付けます。

'out'軸のラインの外側に目盛りを付けます。

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

例: gx.TickDir = 'out';

TickDir プロパティにより設定された目盛りの方向の選択モード。次の値のいずれかとして指定します。

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

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

例: gx.TickDirMode = 'auto';

目盛りの長さ。[length unused] の形式の 2 要素ベクトルとして指定します。length は目盛りの長さです。最も長い座標軸の次元を基準にして正規化された単位で値を指定します。GeographicRuler オブジェクトは、他のルーラー オブジェクトのこのプロパティの値と一致させるために 2 要素ベクトルを使用しますが、2 番目の要素は使用されません。

メモ

TickLength プロパティを設定すると、LatitudeAxis プロパティおよび LongitudeAxis プロパティに関連付けられた GeographicRuler オブジェクトの TickLength プロパティが自動的に同じ値に設定されます。逆に、GeographicRuler オブジェクトの TickLength プロパティを設定しても、axes オブジェクトの同じプロパティは自動的に設定されません。座標軸のプロパティ値によってルーラーのプロパティ値が上書きされないようにするには、最初に座標軸のプロパティ値を設定してから、ルーラーのプロパティ値を設定してください。

例: gx.TickLength = [0.02 0.0];

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

形式説明
'dd'小数部を含む度とコンパス方位
23°N
'dm'度、小数部を含む分とコンパス方位
18°30'W
'dms' (既定)度、分、小数部を含む秒とコンパス方位
110°06'18.5"E
'-dd'小数部を含む度。南と西を表す場合はマイナス符号 (-) を付ける
-115.25°
'-dm'度、小数部を含む分。南と西を表す場合はマイナス符号 (-) を付ける
-5°45.5'
'-dms'度、分、小数部を含む秒。南と西を表す場合はマイナス符号 (-) を付ける
-3°21'05"

既定のラベル形式では度、分、秒が表示されます。ただし、目盛りラベルの分と秒の部分は、ズーム レベル 14 以上でマップを拡大するまで表示されません。

例: gx.TickLabelFormat = '-dm';

ルーラー

すべて展開する

緯度ルーラー。GeographicRuler オブジェクトとして指定します。GeographicRuler オブジェクトのプロパティを使用して、軸ルーラーの外観と動作を制御します。詳細については、GeographicRuler のプロパティ を参照してください。

例: latruler = gx.LatitudeAxis;

例: gx.LatitudeAxis.TickLabelRotation = 45;

経度ルーラー。GeographicRuler オブジェクトとして指定します。GeographicRuler オブジェクトのプロパティを使用して、軸ルーラーの外観と動作を制御します。詳細については、GeographicRuler のプロパティ を参照してください。

例: lonruler = gx.LongitudeAxis;

例: gx.LongitudeAxis.TickDirection = 'out';

軸のライン、目盛り値およびラベルの色。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'

メモ

AxisColor プロパティを設定すると、GeographicRuler オブジェクトおよび GeographicScalebar オブジェクトの Color プロパティが自動的に同じ値に設定されます。GeographicRuler オブジェクトは、地理座標軸のルーラーの動作と外観を制御します。GeographicScalebar オブジェクトは、地理座標軸のスケール バーを制御します。逆に、GeographicRuler または GeographicScalebar オブジェクトで Color プロパティを設定しても、axes オブジェクトの AxisColor プロパティは設定されません。座標軸のプロパティ値によってルーラーまたはスケール バーのプロパティ値が上書きされないようにするには、最初に座標軸のプロパティ値を設定してから、ルーラーまたはスケール バーのプロパティ値を設定してください。

例: gx.AxisColor = [0 0 1];

例: gx.AxisColor = 'b';

例: gx.AxisColor = 'blue';

例: gx.AxisColor = '#0000FF';

グリッド

すべて展開する

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

  • 'on' – グリッド ラインを表示します。

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

例: gx.Grid = 'off';

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

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

'--'破線

':'点線

'-.'一点鎖線

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

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

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

例: gx.GridColor = [0 0 1];

例: gx.GridColor = 'b';

例: gx.GridColor = 'blue';

例: gx.GridColor = '#0000FF';

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

  • 'auto' — オブジェクトが自動的に色を選択します。

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

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

例: gx.GridAlpha = 0.5

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

  • 'auto' — オブジェクトが透明度の値を選択します。

  • 'manual' — 透明度の値を指定するために、GridAlpha プロパティを使用します。

例: gx.GridAlphaMode = 'auto'

ラベル

すべて展開する

座標軸のタイトル。Text オブジェクトまたは categorical 値として指定します。

Text オブジェクトを使用する場合、次のようにタイトルを Text オブジェクトの String プロパティ値として指定します。gx.Title.String = 'My Geographic Plot'フォント スタイル、色などのタイトルの外観を変更するには、Text オブジェクトの他のプロパティを使用します。プロパティの一覧については、Text のプロパティ を参照してください。

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

また、関数 title を使用してタイトルを指定することもできます。

例: gx.Title.String = 'My Geographic Plot'

緯度軸ラベル。Text オブジェクトとして指定します。ラベルを指定するには、Text オブジェクトの String プロパティを設定します。フォント スタイル、色などのラベルの外観を変更するには、Text オブジェクトの他のプロパティを設定します。プロパティの一覧については、Text のプロパティ を参照してください。

例: gx.LatitudeLabel.String = 'My Latitude'

経度軸ラベル。Text オブジェクトとして指定します。ラベルを指定するには、テキスト オブジェクトの String プロパティを設定します。フォント スタイル、色などのラベルの外観を変更するには、Text オブジェクトの他のプロパティを設定します。プロパティの一覧については、Text のプロパティ を参照してください。

例: gx.LongitudeLabel.String = 'My Longitude'

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

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

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

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

gx = gca;
lgd = gx.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 を使用する場合と似ています。

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 成分の m 行 3 列の配列として指定します。あるいは、関数 colormap を使用してカラーマップを変更することもできます。

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

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

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

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

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

例: gx.ColorScale = 'log'

カラーマップの色の範囲。[cmin cmax] の形式の 2 要素ベクトルとして指定します。

対応するモード プロパティが 'auto' に設定されている場合、MATLAB によって色の範囲が選択されます。このプロパティに値を割り当てた場合は、モードが 'manual' に設定され、色の範囲が MATLAB によって自動で選択されなくなります。

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

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

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

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

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

  • 'linear' — 線形スケール

  • 'log' — 対数スケール

例: gx.AlphaScale = 'log'

alphamap のアルファ値の範囲。[amin amax] の形式の 2 要素ベクトルとして指定します。

対応するモード プロパティが 'auto' に設定されている場合、MATLAB によってアルファ値の範囲が選択されます。このプロパティを設定した場合は、モードが 'manual' に設定され、アルファ値の範囲が MATLAB によって自動で選択されなくなります。

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

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

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

ボックスのスタイル

すべて展開する

背景色。RGB 3 成分、16 進数カラー コード、色名、または色の省略名として指定します。この背景色は、Basemap プロパティが 'none' に設定されている場合にのみ表示されます。

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

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

例: gx.Color = 'b';

例: gx.Color = 'blue';

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

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

例: gx.LineWidth = 1.5

地球座標軸の周りの外枠。'on' または 'off'、あるいは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off'false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

例: gx.Box = 'off'

位置

すべて展開する

ラベルと余白を含む地理座標軸のサイズと位置。[left bottom width height] の形式の 4 要素ベクトルとして指定します。このベクトルは、地理座標軸の外側の境界を囲む四角形の範囲を定義します。left 要素と bottom 要素で、地理座標軸を格納する Figure またはパネルの左下隅から四角形の左下隅までの距離を定義します。width 要素と height 要素は四角形の大きさです。

既定では、コンテナーを基準に正規化された単位が使用されます。単位を変更するには、Units プロパティを設定します。既定値 [0 0 1 1] は、コンテナーの内側全体になります。

メモ

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

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

メモ

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

ラベルまたは余白を含まない地理座標軸のサイズと位置。[left bottom width height] の形式の 4 要素ベクトルとして指定します。このベクトルは、地理座標軸を囲む最も狭い四角形の範囲を定義します。left 要素と bottom 要素で、コンテナーの左下隅から四角形の左下隅までの距離を定義します。width 要素と height 要素は四角形の大きさです。

既定では、コンテナーを基準に正規化された単位が使用されます。単位を変更するには、Units プロパティを設定します。

例: gx.Position = [0 0 1 1] は、コンテナーの左下の隅と四角形の間の距離がゼロであることを指定し、また幅と高さがコンテナー全体を占めることを指定します。

メモ

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

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

テキスト ラベル用の余白。[left bottom right top] の形式の 4 要素ベクトルとして返されます。このプロパティは読み取り専用です。

要素は、Position プロパティの境界から地理座標軸のテキスト ラベルとタイトルの範囲までの距離を定義します。既定では、地理座標軸を格納する Figure または uipanel を基準に正規化された単位が使用されます。単位を変更するには、Units プロパティを設定します。

Position プロパティと TightInset プロパティは、地理座標軸とそのラベルおよびタイトルを囲む最も狭いボックスを定義します。

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

  • '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'

ピクセル。

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

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

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

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

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

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

ax.Layout.Tile = 3;

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

ax.Layout.TileSpan = [2 3];

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

対話機能

すべて展開する

データ探索ツール バー。AxesToolbar オブジェクトとして指定します。このツール バーは、地理座標軸の右上隅にカーソルを合わせると表示されます。このツール バーでは、ズーム、表示の復元、データ ヒントなどのデータ探索ツールに簡単にアクセスできます。

地理座標軸にカーソルを合わせたときにツール バーを表示しないようにする場合は、AxesToolbar オブジェクトの Visible プロパティを 'off' に設定します。AxesToolbar オブジェクトのプロパティの詳細については、AxesToolbar のプロパティを参照してください。

例: gx.Toolbar.Visible = 'off'

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

既定では、地理座標軸内のチャートには、パン、ズーム、およびデータヒントの操作が含まれます。既定のセットを新しい操作セットに置き換えることはできますが、既定のセットの操作にアクセスしたり、変更したりすることはできません。たとえば、次のコードは、既定の操作セットを PanInteraction および ZoomInteraction オブジェクトに置き換えます。

gx = gca;
gx.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 列の配列として指定します。

[lat lon 0
 lat lon 0]

CurrentPoint プロパティには、地理座標軸に対するマウス ポインターの緯度 (lat) および経度 (lon) 座標が格納されます。(lat,lon) 点は最後にマウスをクリックした位置を表します。ただし、Figure に WindowButtonMotionFcn コールバックが定義されている場合、(lat,lon) 点はマウス ポインターの最後の位置を表します。

戻り値の形式は、Axes オブジェクトの CurrentPoint プロパティの戻り値と一致します。地理座標軸の場合、戻り値の 3 列目は必ず 0 になります。2 行目の緯度と経度の値は、1 行目の値を複製したものです。

例: [52.1411 -125.1167 0; 52.1411 -125.1167 0]

コンテキスト メニュー。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' に設定しなければなりません。GeographicAxes オブジェクトがクリックに応答するか、先祖がクリックに応答するかは、HitTest プロパティが決定します。

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

  • 'none' — マウス クリックをキャプチャしません。GeographicAxes オブジェクトをクリックすると、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'GeographicAxes オブジェクトの ButtonDownFcn コールバックをトリガーします。ContextMenu プロパティが定義されている場合は、コンテキスト メニューを呼び出します。

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

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

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

メモ

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

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

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

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

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

親/子

すべて展開する

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

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

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

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

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

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

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

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

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

識別子

すべて展開する

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

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

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

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

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

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

すべて展開する

R2020a 以降は非推奨

R2020a 以降は非推奨

R2019b での動作変更

R2019b での動作変更

R2018b で導入