Main Content

xticklabels

x 軸の目盛りラベルの設定またはクエリ

説明

xticklabels(labels) は、現在の座標軸の x 軸の目盛りラベルを設定します。labels は string 配列または文字ベクトルの cell 配列として指定します。たとえば、{'January','February','March'} とします。ラベルを指定すると、x 軸の目盛り値と目盛りラベルは、それ以降、座標軸への変更に基づいて自動的に更新されなくなります。

xl = xticklabels は、現在の座標軸の x 軸の目盛りラベルを返します。

xticklabels('auto') は、座標軸によって x 軸の目盛りラベルを決定できる自動モードに設定します。このオプションは、ラベルを設定した後でそれらを既定値に戻す場合に使用します。

xticklabels('manual') は、x 軸の目盛りラベルを現在の値に固定する手動モードに設定します。

m = xticklabels('mode') は、x 軸の目盛りラベル モードの現在の値を 'auto' または 'manual' のいずれかで返します。目盛りラベルを指定したり、モードを手動に設定したりしない限り、自動モードが既定で使用されます。

___ = xticklabels(ax,___) は、現在の座標軸の代わりに ax で指定される座標軸を使用します。前述の構文いずれかの最初の入力引数として ax を指定します。

すべて折りたたむ

ライン プロットを作成します。x 軸に沿って、値 0、5 および 10 の位置に目盛りを表示します。その後、各目盛りのラベルを指定します。

x = linspace(0,10);
y = x.^2;
plot(x,y)
xticks([0 5 10])
xticklabels({'x = 0','x = 5','x = 10'})

Figure contains an axes object. The axes object contains an object of type line.

ライン プロットを作成します。x 軸の範囲を指定し、x 軸に沿って π ずつインクリメントする目盛りを表示します。

x = linspace(0,6*pi);
y = sin(x);
plot(x,y)
xlim([0 6*pi])
xticks(0:pi:6*pi)

Figure contains an axes object. The axes object contains an object of type line.

MATLAB® は、目盛りに数値のラベルを付けます。各ラベルのテキストを指定して、π 記号が表示されるようにラベルを変更します。

xticklabels({'0','\pi','2\pi','3\pi','4\pi','5\pi','6\pi'})

Figure contains an axes object. The axes object contains an object of type line.

R2019b 以降、関数 tiledlayout および nexttile を使用して、プロットをタイル表示できます。関数 tiledlayout を呼び出して、2 行 1 列のタイル表示チャート レイアウトを作成します。関数 nexttile を呼び出して、axes オブジェクト ax1 および ax2 を作成します。ランダム データの 2 つのプロットを作成します。ax2 を最初の入力引数として指定することで、2 番目のプロットにおける x 軸の目盛りの値とラベルを設定します。

tiledlayout(2,1)
ax1 = nexttile;
plot(ax1,rand(3))

ax2 = nexttile;
plot(ax2,rand(3))
xticks(ax2,[1 2 3])
xticklabels(ax2,{'one','two','three'})

Figure contains 2 axes objects. Axes object 1 contains 3 objects of type line. Axes object 2 contains 3 objects of type line.

ステム グラフを作成して、x 軸の目盛りの値と対応するラベルを指定します。その後、x 軸の目盛りの値とラベルを既定値に設定し直します。

stem(1:10)
xticks([1 4 6 10])
xticklabels({'A','B','C','D'})

Figure contains an axes object. The axes object contains an object of type stem.

xticks('auto')
xticklabels('auto')

Figure contains an axes object. The axes object contains an object of type stem.

目盛りラベルを空の配列として指定することで、x 軸に沿った目盛りラベルを削除します。

plot(rand(5))
xticklabels({})

Figure contains an axes object. The axes object contains 5 objects of type line.

入力引数

すべて折りたたむ

目盛りラベル。文字ベクトルの cell 配列、string 配列または categorical 配列として指定します。目盛りラベルを表示しない場合は、空の cell 配列 {} を指定します。目盛りラベルでは TeX マークアップおよび LaTeX マークアップがサポートされます。詳細については、Axes オブジェクトの TickLabelInterpreter プロパティを参照してください。

例: xticklabels({'0','\pi','2\pi'})

例: xticklabels({'January','Febrary','March'})

例: xticklabels({})

メモ

  • 目盛り値を指定するには、関数 xticks を使用します。

  • 指定したラベルの個数が目盛り値の個数より少ない場合、MATLAB® はラベルに空の文字ベクトルを続けて、残りの目盛りに使用します。

  • 目盛りラベルを categorical 配列として指定した場合、MATLAB はカテゴリではなく、配列内の値を使用します。

ターゲット座標軸。Axes オブジェクトまたは Axes オブジェクトとの配列して指定します。

この引数を指定しない場合、xticklabels は現在の座標軸を変更します。

出力引数

すべて折りたたむ

現在の目盛りラベル。文字ベクトルの cell 配列または文字配列として返されます。

現在の目盛りラベル モード。次のいずれかの値が返されます。

  • 'auto'x 軸の目盛りラベルが自動的に決定されます。

  • 'manual' — 手動で指定された x 軸の目盛りラベルを使用します。

詳細

すべて折りたたむ

目盛りラベル

目盛りラベルは、各目盛りの横に表示されるラベルです。目盛り値は、x 軸に沿って目盛りが表示される位置です。関数 xticks を使用して値を設定します。関数 xticklabels を使用して対応するラベルを設定します。

アルゴリズム

関数 xticklabels は、x 軸の目盛りラベルに関連するいくつかの座標軸プロパティを設定およびクエリします。

  • XTickLabelx 軸の目盛りラベルのテキストを保存するプロパティ。

  • XTickLabelModex 軸の目盛りラベル モードを保存するプロパティ。xticklabels を使用して x 軸の目盛りラベルを設定すると、このプロパティは 'manual' に変更されます。

  • XTickModex 軸の目盛り値モードを保存するプロパティ。xticklabels を使用して x 軸の目盛りラベルを設定すると、このプロパティは 'manual' に変更されます。

バージョン履歴

R2016b で導入