ドキュメンテーション センター

  • 評価版
  • 製品アップデート

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

zlabel

構文

  • zlabel(str)
  • zlabel(str,Name,Value)
  • zlabel(axes_handle,___)
  • h = zlabel(___)

説明

zlabel(str) は、現在の座標軸の z 軸に文字列 str でラベルを付けます。すべての座標軸は、事前定義された z 軸ラベルを 1 つもっています。zlabel コマンドを再度使用すると、古いラベルが新しいラベルに置き換えられます。

zlabel(str,Name,Value) は、さらに 1 つまたは複数の Name,Value のペア引数を使って、テキスト オブジェクト プロパティを指定します。

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

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

すべて展開する

文字列による z 軸のラベル付け

figure
surf(peaks)
zlabel('Height')

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

数値入力による z 軸のラベル付け

figure
surf(peaks)
zlabel(123)

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

複数行ラベルの作成

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

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

ラベルの作成とフォント プロパティの設定

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

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

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

特定の軸の z 軸にラベルを付ける

2 つのサブプロットを作成し、Axes オブジェクトのハンドル s(1)s(2) を返します。

figure
s(1) = subplot(2,1,1);
surf(peaks(30))
s(2) = subplot(2,1,2);
surf(peaks(45))

軸ハンドル s(1) および s(2) を参照することにより、各プロットの z 軸にラベルを付けます。

zlabel(s(1),'Height1')
zlabel(s(2),'Height2')

z 軸にラベルを付けてオブジェクト ハンドルを返す

z 軸にラベルを付けて、ラベルとして使用されるテキスト オブジェクトのハンドルを返します。

figure
surf(peaks)
str = 'Population Change';
h = zlabel(str);

MATLAB は、オブジェクト ハンドルを出力変数 h に返します。

オブジェクト ハンドルを使用して、ラベルの色を赤に設定します。

set(h,’Color’,’red’)

入力引数

すべて展開する

str - z 軸ラベルとして表示するテキスト文字列

z 軸ラベルとして表示するテキスト。文字列または文字列を返す関数の名前として指定します。

例: 'myLabel'

axes_handle - Axes のハンドルハンドル

Axes ハンドル。Axes オブジェクトへの参照です。現在の座標軸のハンドルを取得するには、関数 gca を使用します。たとえば、axes_handle = gca; のようにします。

名前/値のペアの引数

オプションの Name,Value 引数のペアをコンマ区切りで指定します。ここで、Name は引数名で、Value は対応する値です。Name は単一引用符 (' ') で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数個の名前と値のペアの引数を、任意の順番で指定できます。

例: 'Color','red','FontSize',12 は z 軸ラベルを赤色の 12 ポイント フォントで追加します。

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

'Color' - テキストの色[0 0 0] (黒) (既定の設定) | 3 要素の RGB ベクトル | 文字列

テキストの色。'Color' と 3 要素の RGB ベクトルのコンマ区切りペアまたは色の省略名または完全名を含む文字列として指定します。RGB ベクトルは、色の赤、緑、青成分の強度を指定する 3 要素の行ベクトルです。強度値は [0 1] の範囲でなければなりません。

以下の表は、定義済み色と対応する RGB 値を表しています。

RGB 値

省略名

完全名

[1 1 0]

y

yellow

[1 0 1]

m

magenta

[0 1 1]

c

cyan

[1 0 0]

r

red

[0 1 0]

g

green

[0 0 1]

b

blue

[1 1 1]

w

white

[0 0 0]

k

black

例: 'Color',[0 1 0]

例: 'Color','green'

'FontAngle' - 文字の傾斜'normal' (既定の設定) | 'italic' | 'oblique'

コンマ区切りの 'FontAngle' と次のいずれかの値とのペアとして指定する、文字の傾斜。'normal''italic' または 'oblique'。MATLAB は、FontAngle プロパティを使用して特定のシステムで使用可能なフォントを選択します。一般的に、このプロパティを italicoblique に設定すると、イタリックのフォントを選択します。

例: 'FontAngle','italic'

'FontName' - フォント名'Helvetica' (既定の設定) | 文字列 | 'FixedWidth'

フォント名。'FontName' と文字列で構成されるコンマ区切りペアとして指定します。文字列では、テキスト オブジェクトに使うフォント名を指定します。適切に表示したり、印刷するためには、このプロパティはユーザーのシステムがサポートするフォントでなければなりません。

どのロケールでもテキストが整って見えるように、固定幅のフォントを使用する場合は、大文字と小文字が区別される文字列 'FixedWidth' を使用します。これは、固定幅のフォントの名前をハード コードするために必要な処理を無視します。そのため、ASCII 文字エンコードを使用しないシステム上で、適切にテキスト プロパティを表示できない場合があります。

例: 'FontName','Courier'

'FontSize' - フォント サイズ10 ポイント (既定の設定) | スカラー

フォント サイズ。'FontSize' と、FontUnits プロパティで指定した単位のスカラーで構成されるコンマ区切りペアとして指定します。FontUnits の既定値は points です。

例: 'FontSize',12.5

'FontUnits' - フォント サイズの単位'points' (既定の設定) | 'normalized' | 'inches' | 'centimeters' | 'pixels'

フォント サイズの単位。'FontUnits' および次の文字列値のいずれかで構成されるコンマ区切りペアとして指定します。

  • 'points'

  • 'normalized'

  • 'inches'

  • 'centimeters'

  • 'pixels'

FontUnits の値が 'normalized' の場合、MATLAB は、FontSize の値を親軸の高さの分数として解釈します。軸のサイズを変更すると、MATLAB はこれに応じて画面の FontSize を変更します。pointsinchescentimeters および pixels は絶対単位です。1 ポイント = 1/72 インチ

    メモ:   FontSizeFontUnits の両方を設定する場合は、指定した FontSize を MATLAB が正しく解釈できるように、最初に FontUnits プロパティを設定しなければなりません。たとえば、フォント サイズを 0.3 インチに設定する場合は、'FontUnits','inches','FontSize',0.3 を引数リストで呼び出します。

'FontWeight' - テキスト文字の重み'normal' (既定の設定) | 'bold' | 'light' | 'demi'

テキスト文字の重み。'FontWeight' および次の文字列のいずれかで構成されるコンマ区切りペアとして指定します。

  • 'normal'

  • 'bold'

  • 'light'

  • 'demi'

MATLAB は、FontWeight プロパティを使用して、ユーザーのシステムで使用可能なフォントの型を選択します。一般に、このプロパティを 'bold''demi' に設定すると、MATLAB は太字フォントを使用します。

例: 'FontWeight','bold'

'Interpreter' - 文字の解釈'tex' (既定の設定) | 'latex' | 'none'

文字の解釈。'Interpreter' と次の文字列のいずれかで構成されるコンマ区切りペアとして指定します。

インタープリターの値結果
'tex'標準 TeX マークアップ言語のサブセットをサポートします。サポートされている TeX 命令のリストについては、String プロパティを参照してください。
'latex'LaTeX マークアップ言語の基本サブセットをサポートします。
'none'すべての文字をリテラル文字として解釈します。

例: 'Interpreter','latex'

出力引数

すべて展開する

h - z 軸ラベルとして使用されるテキスト オブジェクトのハンドルスカラー

z 軸ラベルとして使用されるテキスト オブジェクトのハンドル。スカラーとして返されます。一意識別子です。この識別子を使ってラベルのプロパティのクエリと変更を行うことができます。

参考

| | | |

この情報は役に立ちましたか?