uilabel
ラベル コンポーネントの作成
説明
は、(テキスト lbl
= uilabel'Label'
をもつ) ラベル コンポーネントを新しい Figure ウィンドウ内に作成し、Label
オブジェクトを返します。MATLAB® は関数 uifigure
を呼び出してこの Figure を作成します。
は、1 つ以上の lbl
= uilabel(___,Name,Value
)Name,Value
のペアの引数を使用して、ラベルのプロパティを指定します。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。
例
既定のテキストをもつラベル コンポーネントの作成
fig = uifigure; lbl = uilabel(fig);
パネルにラベル コンポーネントを作成
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];
長いラベル テキストの右端での折り返し
ラベル テキストをラベルの幅に収めるよう右端で折り返します。
ラベルを作成します。ラベル テキストとサイズを指定します。
fig = uifigure;
lbl = uilabel(fig);
lbl.Text = "The data shown represents 18 months of observations.";
lbl.Position = [100 100 100 60];
テキストをラベル内で右端で折り返します。
lbl.WordWrap = "on";
ラベルのテキストの書式設定
HTML マークアップを使用して、ラベルのテキストの選択した部分の書式を設定します。
ラベルを作成し、ラベルのサイズを指定します。
fig = uifigure;
lbl = uilabel(fig,"Position",[100 100 150 32]);
HTML マークアップを使用してラベルのテキストを指定し、そのテキストを HTML として解釈するようにラベルを設定します。
lbl.Text = "<font style='color:green;'>This table</font> is <em>not complete</em>." lbl.Interpreter = "html";
式の表示
LaTeX を使用して書式設定された式を表示します。
ラベルを作成し、ラベルのサイズを指定します。
fig = uifigure;
lbl = uilabel(fig,"Position",[100 100 125 50]);
ラベルのテキストを指定し、そのテキストを LaTeX として解釈するようにラベルを設定します。
lbl.Text = "$$\frac{d}{dx} \int_a^x f(t)\;dt = f(x)$$" lbl.Interpreter = "latex";
入力引数
parent
— 親コンテナー
Figure
オブジェクト (既定値) | Tab
オブジェクト | Panel
オブジェクト | ButtonGroup
オブジェクト | GridLayout
オブジェクト
親コンテナー。関数 uifigure
を使用して作成された Figure
オブジェクト、またはその子コンテナー (Tab
、Panel
、ButtonGroup
または GridLayout
) のいずれかとして指定します。親コンテナーを指定しない場合、MATLAB は関数 uifigure
を呼び出し、親コンテナーとして機能する新しい Figure
オブジェクトを作成します。
名前と値の引数
引数のオプションのペアを Name1=Value1,...,NameN=ValueN
として指定します。ここで Name
は引数名で、Value
は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。
R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name
を引用符で囲みます。
例: uilabel("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'}
WordWrap
— コンポーネントの幅に合わせるための右端での折り返し
'off'
(既定値) | on/off logical 値
コンポーネントの幅に合わせるための右端での折り返し。'off'
または 'on'
、もしくは数値または logical 0
(false
) または 1
(true
) として指定します。'off'
の値は false
と等価であり、'on'
は true
と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState
型の on/off logical 値として格納されます。
このプロパティを使用して、表示するテキストよりコンポーネントの幅が小さい場合に水平方向に切り捨てられないようにします。
'off'
— テキストは右端で折り返しされません。'on'
— テキストを新しい行に折り返して、各行がコンポーネントの幅に収まるようにし、単語が区切られないようにします (可能な場合)。
WordWrap
プロパティを 'on'
に設定しても、コンポーネントの高さがテキストのすべての行を表示するには小さすぎる場合には、テキストが垂直方向に切り捨てられるのを回避できません。
Position
— ラベルの位置とサイズ
[100 100 31 22]
(既定値) | [left bottom width height]
親を基準にしたラベルの位置とサイズ。ベクトル [left bottom width height]
として指定します。次の表で、ベクトルの各要素について説明します。
要素 | 説明 |
---|---|
left | 親コンテナーの内側左端からラベルの外側左端までの距離 |
bottom | 親コンテナーの内側下端からラベルの外側下端までの距離 |
width | ラベルの外側の右端と左端の間の距離 |
height | ラベルの外側の上端と下端の間の距離 |
Position
の値の基準は、親コンテナーの "描画可能領域" です。描画可能領域は、コンテナーの境界線の内側にある領域で、メニュー バーやタイトルなどの装飾が占める領域は含まれません。
すべての測定単位はピクセルです。
例: [100 100 100 20]
バージョン履歴
R2016a で導入R2021a: テキストのスタイル設定および方程式の表示
Interpreter
プロパティを使用して、ラベルのテキストの HTML または LaTeX マークアップを有効にします。
詳細については、Label のプロパティを参照してください。
R2020b: ラベル テキストの折り返し
表示するテキストより UI コンポーネントの幅が小さい場合に、テキストが水平方向に切り捨てられないようにするには、WordWrap
プロパティを使用します。WordWrap
プロパティを 'on'
に設定すると、各行がコンポーネントに収まるようにテキストが新しい行に折り返されます。可能な限り、単語の途中での改行はされません。プロパティが 'off'
に設定されている場合、テキストは折り返されません。
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)