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

uilabel

ラベル コンポーネントの作成

構文

lbl = uilabel

lbl = uilabel(parent)

lbl = uilabel(___,Name,Value)

説明

lbl = uilabel は、(テキスト 'Label' をもつ) ラベル コンポーネントを新しい Figure ウィンドウ内に作成し、Label オブジェクトを返します。MATLAB^® は関数 uifigure を呼び出してこの Figure を作成します。

lbl = uilabel(parent) は、指定された親コンテナー内にラベルを作成します。親には、関数 uifigure を使用して作成された Figure か、またはその子コンテナーのいずれかを指定できます。

lbl = uilabel(___,Name,Value) は、1 つ以上の Name,Value のペアの引数を使用して、ラベルのプロパティを指定します。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。

例

既定のテキストをもつラベル コンポーネントの作成

f = uifigure;
label = uilabel(f);

パネルにラベル コンポーネントを作成

Panel を親として指定します。

fig = uifigure;
pnl = uipanel(fig);
lbl = uilabel(pnl);

ラベル コンポーネントのプロパティの設定とアクセス

既定のラベルを作成します。

fig = uifigure;
lbl = uilabel(fig);

ラベルのテキストとフォント サイズを変更します。

lbl.Text = 'Result';
lbl.FontSize = 14;

新しいテキストを新しいフォント サイズで表示するには現在のラベルが小さすぎるため、ラベルがクリップされます。

Position プロパティ値の 3 番目と 4 番目の要素を取得して、現在のラベルのサイズを調べます。

size = lbl.Position(3:4)

size =

    31    15

新しいテキストが収まるようにラベルのサイズを変更します。

lbl.Position(3:4) = [62 22];

入力引数

parent — 親コンテナー

Figure オブジェクト (既定値) | Panel オブジェクト | Tab オブジェクト | ButtonGroup オブジェクト | GridLayout オブジェクト

親コンテナー。関数 uifigure を使用して作成された Figure オブジェクト、またはその子コンテナー (Tab、Panel、ButtonGroup または GridLayout) のいずれかとして指定します。親コンテナーを指定しない場合、MATLAB は関数 uifigure を呼び出し、親コンテナーとして機能する新しい Figure オブジェクトを作成します。

名前と値のペアの引数

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

例: 'Text','Sum:' は、ラベルに Sum: というテキストが表示されるように指定します。

以下にリストするプロパティは、利用できるプロパティの一部です。完全なリストについては、Label のプロパティ を参照してください。

'Text' — ラベルのテキスト

'Label' (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | string スカラー | string 配列 | ...

ラベルのテキスト。文字ベクトル、文字ベクトルの cell 配列、string スカラー、string 配列、または 1 次元の categorical 配列として指定します。複数行のテキストを指定する場合は文字ベクトルの cell 配列または string 配列を使用します。

あるいは、関数 sprintf を使用して、改行文字やその他の特殊文字を含む書式付きテキストを作成します。

text = sprintf('%s\n%s','Line 1','Line 2');
label = uilabel('Text',text,'Position',[100 100 100 32]);

sprintf を使用せずにテキストを 1 つの文字ベクトルとして指定した場合、MATLAB は \n などの制御シーケンスを解釈しません。

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

例: 'Threshold'

例: {'Threshold' 'Value'}

'Position' — ラベルの位置とサイズ

[100 100 31 22] (既定値) | [left bottom width height]

親を基準にしたラベルの位置とサイズ。ベクトル [left bottom width height] として指定します。次の表で、ベクトルの各要素について説明します。

要素	説明
left	親コンテナーの内側左端からラベルの外側左端までの距離
bottom	親コンテナーの内側下端からラベルの外側下端までの距離
width	ラベルの外側の右端と左端の間の距離
height	ラベルの外側の上端と下端の間の距離

Position の値の基準は、親コンテナーの "描画可能領域" です。描画可能領域は、コンテナーの境界線の内側にある領域で、メニュー バーやタイトルなどの装飾が占める領域は含まれません。

すべての測定単位はピクセルです。

例: [100 100 100 20]

参考

関数

• appdesigner | uifigure

プロパティ

• Label のプロパティ

R2016a で導入