Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

zlabel

説明

zlabel(txt) は、現在の座標軸の z 軸にテキスト txt でラベルを付けます。zlabel コマンドを再度使用すると、古いラベルが新しいラベルに置き換えられます。

zlabel(txt,Name,Value) は、さらに 1 つ以上の Name,Value のペアの引数を使用して、text オブジェクト プロパティを指定します。

zlabel(ax,___) は、ax で指定された軸にラベルを追加します。この構文では、ラベルを追加する軸を指定することができます。ax は、前述の構文にあるすべての入力引数の組み合わせより前に指定できます。

h = zlabel(___) は、z 軸ラベルとして使用される text オブジェクトのハンドルを返します。このハンドルは、ラベルを後で変更する場合に役立ちます。

すべて折りたたむ

surf(peaks)
zlabel('Height')

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

figure
surf(peaks)
zlabel(123)

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

MATLAB® は z 軸の横に 123 を表示します。

複数行の cell 配列を使用して、複数行のラベルを作成します。

figure
surf(peaks)
zlabel({'First Line';'Second Line'})

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

Name,Value ペアを使用して、z 軸ラベルのフォント サイズ、フォントの太さ、テキストの色のプロパティを設定します。

figure
surf(peaks)
zlabel('Elevation','FontSize',12,...
       'FontWeight','bold','Color','r')

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

'FontSize',12 はラベル テキストを 12 ポイントのフォントで表示します。'FontWeight','bold' はテキストを太字にします。'Color','r' はテキストの色を赤に設定します。

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

tiledlayout(2,1)
ax1 = nexttile;
surf(ax1,peaks(30))

ax2 = nexttile;
surf(ax2,peaks(45))
zlabel(ax2,'Height')

Figure contains 2 axes objects. Axes object 1 contains an object of type surface. Axes object 2 contains an object of type surface.

z 軸にラベルを付けて、ラベルとして使用される text オブジェクトを返します。

surf(peaks)
t = zlabel('Population Change');

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

ラベルの色を赤に設定します。プロパティの設定にはドット表記を使用します。

t.Color = 'red';

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

入力引数

すべて折りたたむ

軸のラベル。string スカラー、文字ベクトル、string 配列、文字配列、cell 配列、categorical 配列、または数値として指定します。

例: 'my label'

例: {'first line','second line'}

例: 123

ラベルに数値変数とテキストを含めるには、関数 num2str を使用します。以下に例を示します。

x = 42;
txt = ['The value is ',num2str(x)];

上付き文字、下付き文字、ギリシャ文字、数学記号などの特殊文字を含めるには、TeX マークアップを使用します。サポートされるマークアップの一覧については、Interpreter プロパティを参照してください。

複数行ラベルを作成するには、次の手順に従います。

  • string 配列を使用して、["first line","second line"] のように、各要素にテキストを 1 行ずつ含めます。

  • cell 配列を使用して、{'first line','second line'} のように、各セルにテキストを 1 行ずつ含めます。

  • 文字配列を使用して、['abc'; 'ab '] のように、各行に同じ数の文字を含めます。

  • sprintf を使用して、sprintf('first line \n second line') のように、改行文字を含むテキストを作成します。

数値ラベルは sprintf('%g',value) を使用してテキストに変換されます。たとえば、123456781.23457e+07 として表示されます。

メモ

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

  • defaultfactory および remove という語は予約語で、通常の文字として引用符で囲まれている場合はラベルに表示されません。これらの語を個別に表示するには、'\default' または '\remove' のように、その語の前にバックスラッシュを付けます。

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

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

名前と値の引数

引数のオプションのペアを Name1=Value1,...,NameN=ValueN として指定します。ここで Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name を引用符で囲みます。

例: 'Color','red','FontSize',12 は赤色、12 ポイントのフォントを指定します。

以下に加え、Name,Value のペア引数を使用してその他の text オブジェクト プロパティを指定できます。Text のプロパティ を参照してください。

フォント サイズ。ポイント単位の 0 より大きいスカラー値として指定します。1 ポイントは 1/72 インチです。フォントの単位を変更するには、FontUnits プロパティを使用します。

関連付けられた座標軸のフォント サイズ プロパティを設定すると、ラベルのフォント サイズにも影響します。ラベルのフォント サイズは、座標軸のフォント サイズにラベルのスケール係数を乗じたものと等しくなるように更新されます。座標軸の FontSize プロパティには座標軸のフォント サイズが含まれています。座標軸の LabelFontSizeMultiplier プロパティにはラベルのスケール係数が含まれています。既定では、座標軸のフォント サイズは 10 ポイントでスケール係数は 1.1 であるため、z 軸ラベルのフォント サイズは 11 ポイントになります。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

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

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

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

テキストの色。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'

Sample of the color red

'green''g'[0 1 0]'#00FF00'

Sample of the color green

'blue''b'[0 0 1]'#0000FF'

Sample of the color blue

'cyan' 'c'[0 1 1]'#00FFFF'

Sample of the color cyan

'magenta''m'[1 0 1]'#FF00FF'

Sample of the color magenta

'yellow''y'[1 1 0]'#FFFF00'

Sample of the color yellow

'black''k'[0 0 0]'#000000'

Sample of the color black

'white''w'[1 1 1]'#FFFFFF'

Sample of the color white

'none'該当なし該当なし該当なし色なし

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]'#0072BD'

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]'#D95319'

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]'#EDB120'

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]'#7E2F8E'

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]'#77AC30'

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]'#4DBEEE'

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]'#A2142F'

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

例: 'blue'

例: [0 0 1]

例: '#0000FF'

テキスト インタープリター。次の値のいずれかとして指定します。

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

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

  • '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 マークアップを使用するには、インタープリターを 'latex' に設定します。インライン モードでは、マークアップを 1 つのドル記号 ($) で囲みます。表示モードでは、マークアップを 2 つのドル記号 ($$) で囲みます。

LaTeX モード結果
インライン

'$\int_1^{20} x^2 dx$'

Equation with LaTeX inline mode

表示

'$$\int_1^{20} x^2 dx$$'

Equation with LaTeX display mode

テキストは LaTeX の既定のフォント スタイルで表示され、FontNameFontWeightFontAngle のプロパティは無視されます。フォント スタイルを変更するには、LaTeX マークアップを使用します。

LaTeX インタープリターで使用できるテキストの最大サイズは 1200 文字です。複数行のテキストの場合は、さらに 1 行につき 10 文字ほど文字数が少なくなります。

TeX および LaTeX の使用例については、チャートのテキスト内のギリシャ文字と特殊文字を参照してください。LaTeX システムの詳細については、LaTeX プロジェクトの Web サイト (https://www.latex-project.org/) を参照してください。

出力引数

すべて折りたたむ

z 軸ラベルとして使用される text オブジェクト。ラベルの作成後にラベルのプロパティにアクセスして変更するには、h を使用します。

ヒント

  • 既定の設定では、Interactions プロパティに editInteraction が含まれているため、テキストはクリックすることで編集できます。この操作を無効にするには、text オブジェクトの Interactions プロパティを [] に設定します。

バージョン履歴

R2006a より前に導入