Main Content

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

DatetimeRuler のプロパティ

datetime 値をもつ軸の制御

DatetimeRuler プロパティは、datetime 値を示す x 軸、y 軸または z 軸の外観と動作を制御します。それぞれの軸が固有のルーラー オブジェクトをもちます。ルーラーのプロパティ値を変更することにより、特定の軸の一部の特性を変更できます。

特定のルーラーとプロパティを参照するには、ドット表記を使用します。ルーラー オブジェクトにアクセスするには、Axes オブジェクトの XAxisYAxis および ZAxis の各プロパティを使用します。

ax = gca;
co = ax.XAxis.Color;
ax.XAxis.Color = 'blue';

外観

すべて展開する

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

メモ

ルーラーの Color プロパティの値と、関連付けられている親座標軸の XColorYColor または ZColor プロパティの値は常に同じです。このうち一方を設定すると、もう片方も設定されます。

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

例: ax.XAxis.LineWidth = 2;

メモ

親座標軸の LineWidth プロパティを設定すると、ルーラーの LineWidth プロパティも同じ値に設定されます。ただし、ルーラーのプロパティを設定しても、座標軸のプロパティは設定されません。座標軸のプロパティ値によってルーラーのプロパティ値が上書きされないようにするには、最初に座標軸の値を設定してから、ルーラーの値を設定してください。

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

ax = gca;
ax.XAxis.Label.String = 'X Axis';
ax.XAxis.Label.FontSize = 12;

オプションの完全な一覧については、Text のプロパティ を参照してください。

あるいは、関数 xlabelylabel および zlabel を使用して、軸ラベルの追加または変更を行います。

メモ

text オブジェクトはルーラー オブジェクトの子ではありません。したがって、findobj で返すことはできず、既定のテキスト プロパティ値を使用しません。

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

  • 'on' — 軸を表示します。

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

例: ax.XAxis.Visible = 'off';

スケールと方向

すべて展開する

軸の下限と上限。[min max] の形式の 2 要素ベクトルとして指定します。minmax は datetime 値です。以下に例を示します。

t = datetime(2014,6,28) + caldays(1:10);
y = rand(1,10);
plot(t,y);
ax = gca;
ax.XAxis.Limits = [t(2) t(8)];

あるいは、関数 xlimylimzlim を使用して範囲を設定します。

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

メモ

ルーラーの Limits プロパティの値と、関連付けられている親座標軸の XLimYLim または ZLim プロパティの値は常に同じです。このうち一方を設定すると、もう片方も設定されます。

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

  • 'auto' — プロットされるデータに基づいて軸の範囲を自動的に選択します。

  • 'manual' — 指定された軸の範囲値を使用します。軸の範囲を指定するには、Limits プロパティを設定します。

メモ

ルーラーの LimitsMode プロパティの値と、関連付けられている親座標軸の XLimModeYLimMode または ZLimMode プロパティの値は常に同じです。このうち一方を設定すると、もう片方も設定されます。

軸の値のスケール。'linear' として返されます。DatetimeRuler オブジェクトは対数スケールをサポートしません。

値が増加する方向。次の値のいずれかとして指定します。

  • 'normal' — 値は左から右、あるいは下から上へと増加します。

  • 'reverse' — 値は右から左、あるいは上から下へと増加します。

メモ

ルーラーの Direction プロパティの値と、関連付けられている親座標軸の XDirYDir または ZDir プロパティの値は常に同じです。このうち一方を設定すると、もう片方も設定されます。

例: ax.XAxis.Direction = 'reverse';

目盛りの値とラベル

すべて展開する

軸の目盛りの位置。datetime 値のベクトルとして指定します。以下に例を示します。

t = datetime(2014,6,28) + caldays(1:10);
y = rand(1,10);
plot(t,y);
ax = gca;
ax.XAxis.TickValues = [t(1) t(3) t(5) t(10)];

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

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

メモ

ルーラーの TickValues プロパティの値と、関連付けられている親座標軸の XTickYTick または ZTick プロパティの値は常に同じです。このうち一方を設定すると、もう片方も設定されます。

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

  • 'auto' — プロットされるデータに基づいて目盛りの値を自動的に選択します。

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

メモ

ルーラーの TickValuesMode プロパティの値と、関連付けられている親座標軸の XTickModeYTickMode または ZTickMode プロパティの値は常に同じです。このうち一方を設定すると、もう片方も設定されます。

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

例: ax.XAxis.TickLabels = {'January','February','March','April','May'}';

例: ax.YAxis.TickLabels = {'\pi','2\pi','3\pi'}'

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

あるいは、関数 xticklabelsyticklabels および zticklabels を使用して目盛りラベルを指定します。

メモ

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

  • ルーラーの TickLabels プロパティの値と、関連付けられている親座標軸の XTickLabelYTickLabel または ZTickLabel プロパティの値は常に同じです。このうち一方を設定すると、もう片方も設定されます。

データ型: char | string | categorical

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

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

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

メモ

ルーラーの TickLabelsMode プロパティの値と、関連付けられている親座標軸の XTickLabelModeYTickLabelMode または ZTickLabelMode プロパティの値は常に同じです。このうち一方を設定すると、もう片方も設定されます。

目盛りラベル インタープリター。次の値のいずれかとして指定します。

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

  • 'latex' — LaTeX マークアップを使用して文字を解釈します。目盛りラベルを指定するときには、cell 配列の各要素をドル記号で囲みます。

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

メモ

親座標軸の TickLabelInterpreter プロパティを設定すると、ルーラーの TickLabelInterpreter プロパティも同じ値に設定されます。ただし、ルーラーのプロパティを設定しても、座標軸のプロパティは設定されません。座標軸のプロパティ値によってルーラーのプロパティ値が上書きされないようにするには、最初に座標軸の値を設定してから、ルーラーの値を設定してください。

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/) を参照してください。

目盛りラベルの形式。文字ベクトルまたは string として指定します。既定の形式はデータに基づきます。

例: ax.XAxis.TickLabelFormat = 'yyyy-MM-dd'; は、日付と時刻を 2014-04-19 のような形式で表示します。

例: ax.XAxis.TickLabelFormat = 'eeee, MMMM d, yyyy HH:mm:ss'; は、日付と時刻を土曜日, 4 月 19, 2014 21:41:06 のような形式で表示します。

例: ax.XAxis.TickLabelFormat = 'MMMM d, yyyy HH:mm:ss Z'; は、日付と時刻を 4 月 19, 2014 21:41:06 -0400 のような形式で表示します。

次の表に、形式の作成に使用できる文字識別子を示します。フィールドを区切るには、ハイフン、スペース、コロンなどのアルファベット以外の文字、または任意の非 ASCII 文字を使用します。識別子は、Unicode® ロケール データ マークアップ言語 (LDML) の標準の日付表記に対応します。

日付と時刻の形式

日付および時刻のフィールドの表示形式を指定するには、次の識別子を使用します。

文字識別子説明表示
G紀元CE
y先頭に 0 を付けない表記の年。この表の後のメモを参照してください。2014
yy下 2 桁表記の年。この表の後のメモを参照してください。14
yyyyyyy ...'y' の数に対応する桁数以上で表記した年2014 年の場合、'yyy' では 2014 と表示され、'yyyyy' では 02014 と表示されます。
uuu ...ISO 年。年を単一の数値で表したものです。ISO 年では、紀元後の年が正の値、紀元前の年が負の値で表され、紀元前 1 年が 0 年になります。2014
Q1 桁表記の四半期2
QQ2 桁表記の四半期02
QQQ省略形で表記した四半期Q2
QQQQ完全名で表記した四半期第2四半期
M1 桁または 2 桁の数値で表記した月4
MM2 桁の数値で表記した月04
MMM短縮名で表記した月4月
MMMM完全名で表記した月4月
MMMMM大文字の頭文字で表記した月A
W月間通算週1
d1 桁または 2 桁表記の月間通算日5
dd2 桁表記の月間通算日05
D1 ~ 3 桁表記の年間通算日95
DD2 桁表記の年間通算日95
DDD3 桁表記の年間通算日095
e1 桁または 2 桁の数値で表記した曜日7 (週の始まりは日曜日)
ee2 桁の数値で表記した曜日07
eee短縮名で表記した曜日
eeee完全名で表記した曜日土曜日
eeeee先頭文字で表記した曜日
a午前と午後の区分午後
h1 桁または 2 桁表記の 12 時間制の時間9
hh2 桁表記の 12 時間制の時間09
H1 桁または 2 桁表記の 24 時間制の時間21
HH2 桁表記の 24 時間制の時間21
m1 桁または 2 桁表記の分41
mm2 桁表記の分41
s1 桁または 2 桁表記の秒6
ss2 桁表記の秒06
SSS ... SSSSSSSSS'S' の数に対応する桁数で表記した秒の小数部 (最大 9 桁)'SSS' の場合、6.12345 秒は 123 までに切り捨てられます。

ヒントと考慮事項:

  • 2 桁の年番号を読み取る場合に形式を y または yy として指定すると、その年の世紀はピボット年に基づいて判別されます。

  • ゼロに近い年番号を扱うときは、文字 y の代わりに文字 u を 1 文字以上使用します。

  • 紀元後 144683 年より後または紀元前 140743 年より前の datetime 値については、指定した形式の値に関係なく、年番号のみが表示されます。

タイム ゾーン オフセットの形式

タイム ゾーン オフセットの表示形式を指定するには、次の識別子を使用します。タイム ゾーン オフセットは、特定の日付および時刻と UTC との時差です。これは、1 年の特定時期のオフセットを定義するルールを構成するタイム ゾーンとは異なります。時刻の成分が必ず明確に表示されるようにする場合は、タイム ゾーン オフセットの識別子を含めます。

文字識別子説明表示
zタイム ゾーン オフセットの省略名。この値が指定されていない場合、タイム ゾーン オフセットには UTC-4 などの短い UTC 形式が使用されます。EDT
ZISO 8601 基本形式。時、分、秒 (オプション) の各フィールドがあります。-0400
ZZZZ長い UTC 形式。UTC-04:00
ZZZZZISO 8601 拡張形式。時、分、秒 (オプション) の各フィールドがあります。ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。-04:00
x または XISO 8601 基本形式。時、分 (オプション) の各フィールドがあります。X を指定すると、ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。-04
xx または XXISO 8601 基本形式。時、分の各フィールドがあります。XX を指定すると、ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。-0400
xxx または XXXISO 8601 拡張形式。時、分の各フィールドがあります。XXX を指定すると、ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。-04:00
xxxx または XXXXISO 8601 基本形式。時、分、秒 (オプション) の各フィールドがあります。XXXX を指定すると、ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。-0400
xxxxx または XXXXXISO 8601 拡張形式。時、分、秒 (オプション) の各フィールドがあります。XXXXX を指定すると、ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。-04:00

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

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

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

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

あるいは、関数 xtickangleytickangle および ztickangle を使用して目盛りラベルを回転させることができます。

メモ

ルーラーの TickLabelRotation プロパティの値と、関連付けられている親座標軸の XTickLabelRotationYTickLabelRotation または ZTickLabelRotation プロパティの値は常に同じです。このうち一方を設定すると、もう片方も設定されます。

例: ax.XAxis.TickLabelRotation = 45;

例: ax.YAxis.TickLabelRotation = -45;

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

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

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

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

  • 'in' — 軸のラインの内側に目盛りを付けます。これは 2 次元表示の既定の設定です。

  • 'out' — 軸のラインの外側に目盛りを付けます。これは 3 次元表示の既定の設定です。

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

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

メモ

親座標軸の TickDir プロパティを設定すると、ルーラーの TickDirection プロパティも同じ値に設定されます。ただし、ルーラーのプロパティを設定しても、座標軸のプロパティは設定されません。座標軸のプロパティ値によってルーラーのプロパティ値が上書きされないようにするには、最初に座標軸の値を設定してから、ルーラーの値を設定してください。

例: ax.YAxis.TickDirection = 'out';

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

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

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

目盛りの長さ。[2Dlength 3Dlength] の形式の 2 要素ベクトルとして指定します。最初の要素は、2 次元表示での目盛りの長さです。2 番目の要素は、3 次元表示での目盛りの長さです。最も長い座標軸の次元を基準にして正規化された単位で値を指定します。

メモ

親座標軸の TickLength プロパティを設定すると、ルーラーの TickLength プロパティも同じ値に設定されます。ただし、ルーラーのプロパティを設定しても、座標軸のプロパティは設定されません。座標軸のプロパティ値によってルーラーのプロパティ値が上書きされないようにするには、最初に座標軸の値を設定してから、ルーラーの値を設定してください。

例: ax.YAxis.TickLength = [0.02 0.035];

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

  • 'on' — 軸の大目盛りの間に小目盛りを表示します。これは、対数スケールを使用する軸の既定値です。大目盛りの間隔に応じて小目盛りの数が決まります。MinorTickValues プロパティが空の [] に設定されている場合、小目盛りは表示されません。MinorTickValues プロパティを設定して、目盛りの位置を指定します。

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

メモ

ルーラーの MinorTick プロパティの値と、関連付けられている親座標軸の XMinorTickYMinorTick または ZMinorTick プロパティの値は常に同じです。このうち一方を設定すると、もう片方も設定されます。

例: ax.XAxis.MinorTick = 'on';

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

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

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

  • 'auto' — 自動的に計算された小目盛り値を使用します。

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

フォント

すべて展開する

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

メモ

親座標軸の FontName プロパティを設定すると、ルーラーの FontName プロパティも同じ値に設定されます。ただし、ルーラーのプロパティを設定しても、座標軸のプロパティは設定されません。座標軸のプロパティ値によってルーラーのプロパティ値が上書きされないようにするには、最初に座標軸の値を設定してから、ルーラーの値を設定してください。

例: ax.XAxis.FontName = 'Cambria';

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

メモ

親座標軸の FontSize プロパティを設定すると、ルーラーの FontSize プロパティも同じ値に設定されます。ただし、ルーラーのプロパティを設定しても、座標軸のプロパティは設定されません。座標軸のプロパティ値によってルーラーのプロパティ値が上書きされないようにするには、最初に座標軸の値を設定してから、ルーラーの値を設定してください。

例: ax.XAxis.FontSize = 12;

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

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

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

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

メモ

親座標軸の FontWeight プロパティを設定すると、ルーラーの FontWeight プロパティも同じ値に設定されます。ただし、ルーラーのプロパティを設定しても、座標軸のプロパティは設定されません。座標軸のプロパティ値によってルーラーのプロパティ値が上書きされないようにするには、最初に座標軸の値を設定してから、ルーラーの値を設定してください。

例: ax.XAxis.FontWeight = 'bold';

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

メモ

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

例: ax.XAxis.FontAngle = 'italic';

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

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

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

メモ

親座標軸の FontSmoothing プロパティを設定すると、ルーラーの FontSmoothing プロパティも同じ値に設定されます。ただし、ルーラーのプロパティを設定しても、座標軸のプロパティは設定されません。座標軸のプロパティ値によってルーラーのプロパティ値が上書きされないようにするには、最初に座標軸の値を設定してから、ルーラーの値を設定してください。

例: ax.XAxis.FontSmoothing = 'off';

親/子

すべて展開する

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

メモ

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

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

R2016b で導入