Main Content

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

GeographicRuler のプロパティ

地理的な値を使用して軸の外観と動作を制御します。

GeographicRuler プロパティは、GeographicAxes の緯度軸と経度軸の外観と動作を制御します。各軸は GeographicRuler オブジェクトです。ルーラーのプロパティ値を変更することにより、特定の軸の特定の特性を変更できます。

特定のルーラーのプロパティについて、各ルーラーのプロパティを設定する代わりに、地理座標軸のプロパティを設定することにより、両方のルーラー (緯度軸と経度軸) の外観をカスタマイズできます。たとえば、GeographicRuler プロパティを使用して、ルーラーごとに異なる色を指定できます。通常は、GeographicAxes プロパティを使用して両方のルーラーの色を指定し、ルーラーの外観を一致させる方が望ましく、また簡単です。

ルーラーのプロパティを参照するには、ドット表記を使用します。GeographicAxes オブジェクトの LatitudeAxis プロパティまたは LongitudeAxis プロパティを介して、ルーラー オブジェクトにアクセスします。

% Create a GeographicAxes. 
gx = geoaxes;

% View GeographicRuler object.
latruler = gx.LatitudeAxis

latruler = 

  GeographicRuler with properties:

             Limits: [-85.0511 85.0511]
         TickValues: [-75 -45 0 45 75]
    TickLabelFormat: 'dms'

  Show all properties

外観

すべて展開する

軸の範囲の下限と上限。[min max] の形式の 2 要素ベクトルとして指定します。Limits は読み取り専用プロパティです。

GeographicAxes の範囲を設定するには、関数 geolimits を使用します。

メモ

緯度と経度の GeographicRuler オブジェクトの Limits プロパティは必ず、親 GeographicAxes オブジェクトの LatitudeLimits プロパティと Longitudelimits プロパティの値とそれぞれ等しくなります。

例: latlim = gx.LatitudeAxis.Limits;

軸のラインとラベルの色。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'

メモ

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

例: gx.LatitudeAxis.Color = 'b'

例: gx.LatitudeAxis.Color = 'blue'

例: gx.LatitudeAxis.Color = [0.1 0.7 0.8];

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

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

メモ

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

例: gx.LatitudeAxis.LineWidth = 2;

軸ラベル。Text オブジェクトとして指定します。

既存のテキストを変更するには、Text オブジェクトの String プロパティを設定します。フォント スタイルや色など、Text オブジェクトのその他のプロパティを使用してテキストの外観を変更します。

gx.LatitudeAxis.Label.String = 'Latitude Axis';
gx.LatitudeAxis.Label.FontSize = 16;

オプションの完全な一覧については、Text のプロパティ オブジェクトのプロパティのリファレンス ページを参照してください。

メモ

Text オブジェクトはルーラー オブジェクトの子ではないため、findobj によって返されるオブジェクトのリストには表示されません。この Text オブジェクトは、Text の既定のプロパティを使用しません。

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

  • 'on' — 軸ルーラーを表示する。

  • 'off' — 軸ルーラーを削除せず、非表示にする。ルーラー オブジェクトを使用して、非表示の軸ルーラーのプロパティにアクセスできます。

例: gx.LatitudeAxis.Visible = 'off';

目盛りの値とラベル

すべて展開する

軸の目盛りの位置。増加する値からなるベクトルとして指定します。

このプロパティに値を割り当てた場合、MATLAB は TickValuesMode プロパティを 'manual' に設定します。

例: gx.LatitudeAxis.TickValues = [-15 -10 0 10 15];

例: gx.LongitudeAxis.TickValues = 0:10:100;

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

  • 'auto' — マップの範囲と軸の位置 (サイズ) に基づいて目盛り値を自動的に選択します。

  • 'manual' — 指定された目盛りの値を使用します。値を指定するには、TickValues プロパティを設定します。

目盛りラベル。文字ベクトルの cell 配列または string 配列として指定します。指定したラベルの個数が目盛り値の個数よりも少ない場合、ラベルが繰り返されます。ラベルでは TeX および LaTeX マークアップがサポートされます。詳細については、TickLabelInterpreter プロパティを参照してください。

例: gx.TickValues = [-66.5 -23.5 0 23.5 66.5];gx.LatitudeAxis.TickLabels = {'Antarctic Circle','Tropic of Capricorn','Equator','Tropic of Cancer','Artic Circle'};

このプロパティを設定した場合、MATLAB は TickLabelsMode プロパティを 'manual' に設定します。

データ型: char | string

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

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

  • 'manual' — 指定された目盛りラベルを使用します。ラベルを指定するには、TickLabels プロパティを設定します。

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

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

  • 'latex' — LaTeX マークアップを使用して文字を解釈します。

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

これらのインタープリターの詳細については、Text のプロパティ リファレンス ページの Interpreter プロパティを参照してください。

例: gx.LatitudeAxis.TickLabelInterpreter = 'latex';

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

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

また、目盛りラベルの形式は関数 geotickformat を使用して指定することもできます。

メモ

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

例: gx.LatitudeAxis.TickLabelFormat = 'dd';

目盛りラベルの回転。度単位のスカラー値として指定します。正の値を指定すると反時計回りになります。負の値を指定すると時計回りになります。たとえば、gx.LatitudeAxis.TickLabelRotation = 45; を指定すると、目盛りラベルが反時計方向に 45 度回転します。

このプロパティに値を割り当てた場合、MATLAB は TickLabelRotation プロパティを 'manual' に設定します。

例: gx.LatitudeAxis.TickLabelRotation = -45;

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

  • 'auto' — オブジェクトが自動的に目盛りラベルの回転を選択します。

  • 'manual' — 指定された目盛りラベルの回転を使用します。回転を指定するには、TickLabelRotation プロパティを設定します。

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

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

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

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

このプロパティに値を割り当てた場合、MATLAB は TickDirectionMode プロパティを 'manual' に設定します。

メモ

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

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

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

  • 'auto' — 目盛りの方向を自動的に選択します。

  • 'manual' — 指定された目盛りの方向を使用します。目盛りの方向を指定するには、TickDirection プロパティを設定します。

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

メモ

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

例: gx.LatitudeAxis.TickLength = [0.04 0];

フォント

すべて展開する

フォント名。システムでサポートされているフォント名または 'FixedWidth' として指定します。既定のフォントは、特定のシステムとロケールによって異なります。どのロケールでもテキストが整って見える固定幅のフォントを使用するには、'FixedWidth' を指定します。実際に使用される固定幅フォントは、root オブジェクトの FixedWidthFontName プロパティによって決まります。

メモ

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

例: gx.LatitudeAxis.FontName = 'Cambria';

フォント サイズ。スカラー数値として指定します。既定のフォント サイズは、特定のオペレーティング システムとロケールによって異なります。

メモ

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

例: gx.LatitudeAxis.FontSize = 12;

テキスト文字の太さ。次の値のいずれかとして指定します。

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

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

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

メモ

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

例: gx.LatitudeAxis.FontWeight = 'bold';

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

メモ

親座標軸の FontAngle プロパティを設定すると、LatitudeAxisLongitudeAxis の両方の GeographicRuler オブジェクトの FontAngle プロパティも同じ値に設定されます。逆に、ルーラーのプロパティを設定しても、座標軸のプロパティは設定されません。座標軸のプロパティ値によってルーラーのプロパティ値が上書きされないようにするには、最初に座標軸の値を設定してから、ルーラーの値を設定してください。

例: gx.LatitudeAxis.FontAngle = 'italic';

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

  • 'on' — テキストのアンチエイリアス処理を使用して、テキスト文字のギザギザを減らし、読みやすくします。場合によっては、平滑化されたテキストは背景色と混ざり合って不鮮明になることがあります。

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

例: gx.LatitudeAxis.FontSmoothing = 'off';

親/子

すべて展開する

ルーラーの親。Axes オブジェクトとして指定します。

メモ

ルーラー オブジェクトは、親の Axes オブジェクトの Children プロパティにはリストされません。

このルーラーには子がありません。このプロパティは設定できません。

R2019a で導入