Label
ラベル UI コンポーネント
説明
ラベル UI コンポーネントでは、アプリ内に静的テキストを表示します。Label オブジェクトを使用して、ラベルの作成後にラベルの外観と動作を変更します。
作成
uilabel 関数を使用してアプリでラベルを作成します。
プロパティ
テキスト
ラベルのテキスト。文字ベクトル、文字ベクトルの 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'}
ラベル テキスト インタープリター。次のいずれかとして指定します。
'none'— リテラル文字を表示します。'tex'— TeX マークアップのサブセットを使用してテキストを解釈します。'latex'— LaTeX マークアップのサブセットを使用してテキストを解釈します。'html'— HTML マークアップのサブセットを使用してテキストを解釈します。
TeX マークアップ
TeX マークアップを使用して、上付き文字や下付き文字の追加、テキストへの特殊文字の挿入を行うことができます。
修飾子の効果はテキストの末尾まで適用されます。上付き文字と下付き文字は例外であり、次の 1 文字または中かっこで囲まれた文字にのみ適用されます。インタープリターを "tex" に設定した場合にサポートされる修飾子は次のとおりです。
| 修飾子 | 説明 | 例 |
|---|---|---|
^{ } | 上付き文字 | "text^{superscript}" |
_{ } | 下付き文字 | "text_{subscript}" |
\bf | 太字フォント | "\bf text" |
\it | イタリック フォント | "\it text" |
\sl | 斜体フォント (通常はイタリック フォントと同じ) | "\sl text" |
\rm | 標準フォント | "\rm text" |
\fontname{ | フォント名 — | "\fontname{Courier} text" |
\fontsize{ | フォント サイズ — | "\fontsize{15} text" |
\color{ | フォントの色 — red、green、yellow、magenta、blue、black、white、gray、darkGreen、orange、lightBlue の色のいずれかに置き換えます。 | "\color{magenta} text" |
\color[rgb]{specifier} | フォントのカスタムの色 — | "\color[rgb]{0,0.5,0.5} text" |
次の表に、"tex" インタープリターでサポートされる特殊文字を示します。
| 文字列 | 記号 | 文字列 | 記号 | 文字列 | 記号 |
|---|---|---|---|---|---|
| α |
| υ |
| ~ |
| ∠ |
| ϕ |
| ≤ |
|
|
| χ |
| ∞ |
| β |
| ψ |
| ♣ |
| γ |
| ω |
| ♦ |
| δ |
| Γ |
| ♥ |
| ϵ |
| Δ |
| ♠ |
| ζ |
| Θ |
| ↔ |
| η |
| Λ |
| ← |
| θ |
| Ξ |
| ⇐ |
| ϑ |
| Π |
| ↑ |
| ι |
| Σ |
| → |
| κ |
| ϒ |
| ⇒ |
| λ |
| Φ |
| ↓ |
| µ |
| Ψ |
| º |
| ν |
| Ω |
| ± |
| ξ |
| ∀ |
| ≥ |
| π |
| ∃ |
| ∝ |
| ρ |
| ∍ |
| ∂ |
| σ |
| ≅ |
| • |
| ς |
| ≈ |
| ÷ |
| τ |
| ℜ |
| ≠ |
| ≡ |
| ⊕ |
| ℵ |
| ℑ |
| ∪ |
| ℘ |
| ⊗ |
| ⊆ |
| ∅ |
| ∩ |
| ∈ |
| ⊇ |
| ⊃ |
| ⌈ |
| ⊂ |
| ∫ |
| · |
| ο |
| ⌋ |
| ¬ |
| ∇ |
| ⌊ |
| x |
| ... |
| ⊥ |
| √ |
| ´ |
| ∧ |
| ϖ |
| ∅ |
| ⌉ |
| 〉 |
| | |
| ∨ |
| 〈 |
| © |
LaTeX マークアップ
LaTeX マークアップを使用するには、インタープリターを 'latex' に設定します。LaTeX マークアップを使用して、数式、方程式、特殊文字を書式設定して表示します。ドル記号を使用してマークアップ テキストを囲みます。たとえば、インライン モードでは '$\int_1^{20} x^2 dx$'、表示モードでは '$$\int_1^{20} x^2 dx$$' を使用します。
テキストは LaTeX の既定のフォント スタイルで表示され、FontName、FontWeight、FontAngle のラベル プロパティは無視されます。フォント スタイルを変更するには、LaTeX マークアップを使用します。
MATLAB では、大半の標準の LaTeX 数式モード コマンドがサポートされています。詳細については、サポートされる LaTeX コマンドを参照してください。
HTML マークアップ
HTML マークアップを使用するには、インタープリターを 'html' に設定します。HTML によるフォント スタイルの設定は、等価な Label フォント プロパティをオーバーライドします。たとえば、次のコードは赤いテキストになります。
lbl = uilabel('Interpreter','html'); lbl.Text = '<p style="color: red;">Text</p>'; lbl.FontColor = 'blue';
インタープリターは HTML マークアップのサブセットをサポートします。一般的なガイドラインとして、インタープリターはテキスト関連のタグとスタイルをサポートします。サポートされないタグとスタイルは無視されます。
次の表に、サポートされる要素と要素の属性を一覧します。
| HTML 要素 | 属性 | 説明 |
|---|---|---|
a | style, target, href, title | ハイパーリンク |
abbr | style, title | 略語または頭字語 |
address | style | 連絡先情報 |
article | style | 自己完結した単独のコンテンツ |
aside | style | 主な内容に間接的に関連するコンテンツ |
b | style | 太字フォント |
bdi | style, dir | 周囲のテキストとは異なる方向で書式設定されるコンテンツ |
bdo | style, dir | 周囲のテキストとは異なる方向で書式設定されるコンテンツ |
big | style | 周囲のテキストよりフォント サイズが 1 レベル大きいテキスト (HTML5 では旧式) |
blockquote | style, cite | 拡張された引用 |
br | N/A | 改行 |
caption | style | テーブルのキャプションまたはタイトル |
center | style | 水平方向に中央揃えされたコンテンツ |
cite | style | 参照先のタイトル |
code | style | コードのフラグメント |
col | style, align, valign, span, width | テーブル内の列 |
colgroup | style, align, valign, span, width | テーブル内の列のグループ |
dd | style | 説明リストの用語または値 |
del | style, datetime | ドキュメントから削除されたテキスト |
details | style, open | '開いた' 状態に切り替えた場合にのみテキストが表示される対話型ウィジェット |
dl | style | 説明リスト |
dt | style | 説明リストの用語または値 |
em | style | 強調表示されるテキスト (通常、イタリックで表示) |
font | style, color, size, face | 指定したフォント プロパティのテキスト (HTML5 では旧式) |
footer | style | フッター |
h1. h2, h3, h4, h5, h6 | style | セクション見出し — <h1> が見出しの最上位、<h6> が最下位 |
header | style | 導入コンテンツ |
hr | style | 主題の区切り |
i | style | 周囲のコンテンツからのテキスト オフセット — 既定の設定ではイタリックとしてレンダリングされる |
ins | style, datetime | ドキュメントに挿入されたテキスト |
li | style | リスト内の項目 |
mark | style | マークアップ テキストまたは強調表示されたテキスト |
ol | style | 順序付きリスト |
p | style | 段落 |
pre | style | 書式設定済みテキスト |
s | style | 取り消し線付きのテキスト |
strike | style | 取り消し線付きのテキスト (HTML5 では旧式) |
section | style | 独立したセクション |
small | style | 周囲のテキストよりフォント サイズが 1 レベル小さいテキスト (HTML5 では旧式) |
sub | style | 下付き文字 |
sup | style | 上付き文字 |
strong | style | 重要度が高いテキスト |
table | style, width, border, align, valign | テーブル |
tbody | style, align, valign | テーブル本体 |
td | style, width, rowspan, colspan, align, valign | テーブル データ セル |
tfoot | style, align, valign | テーブル列をまとめる一連のテーブル行 |
th | style, width, rowspan, colspan, align, valign | セルのグループのヘッダーとして指定されたテーブル データ セル |
thead | style, align, valign | 列見出しを指定する一連のテーブル行 |
tr | style, rowspan, align, valign | テーブル セルの行 |
tt | style | 固定幅テキスト (HTML5 では旧式) |
u | style | 非言語的注釈を使用するテキスト — 既定の設定では下線としてレンダリングされる |
ul | style | 順序なしリスト |
これらの要素の詳細については、https://developer.mozilla.org/en-US/docs/Web/HTML/Elementを参照してください。
MATLAB コードを実行するハイパーリンクを作成するために HTML マークアップを使用するには、関数を実行するハイパーリンクの作成を参照してください。
HTML スタイル属性を使用して HTML コンテンツを書式設定できます。スタイル属性は CSS 属性とその値の文字列です。
以下の CSS 属性がサポートされています。
background-colorborder-bottomborder-bottom-colorborder-bottom-left-radiusborder-bottom-right-radiusborder-bottom-styleborder-bottom-widthborder-leftborder-left-colorborder-left-styleborder-left-widthborder-radiusborder-rightborder-right-colorborder-right-styleborder-right-widthborder-spacingborder-styleborder-topborder-top-colorborder-top-left-radiusborder-top-right-radiusborder-top-styleborder-top-widthborder-widthcolordirectionfont-familyfont-sizefont-stylefont-weightheighthiddenline-heightmarginmargin-bottommargin-leftmargin-rightmargin-topmax-heightmax-widthmin-heightmin-widthoverflowoverflow-wrapoverflow-xoverflow-ypaddingpadding-bottompadding-leftpadding-rightpadding-toptext-aligntext-anchortext-decorationtext-indenttext-overflowtext-shadowtext-transformtitletranslatewhite-spacewidth
これらの属性の詳細については、https://developer.mozilla.org/en-US/docs/Web/CSS/Referenceを参照してください。
テキストの水平方向の配置。次のいずれかとして指定します。
'right'— テキストは、Positionプロパティで指定された領域の右側に配置されます。'left'— テキストは、Positionプロパティで指定された領域の左側に配置されます。'center'— テキストは、Positionプロパティで指定された領域で水平方向の中央に配置されます。
ラベル テキストの配置を指定すると、テキストが複数行にまたがる場合に役立ちます。
テキストの垂直方向の配置。次のいずれかとして指定します。
'center'— テキストは、Positionプロパティで指定された領域で垂直方向の中央に配置されます。'top'— テキストは、Positionプロパティで指定された領域の上部に配置されます。'bottom'— テキストは、Positionプロパティで指定された領域の下部に配置されます。
ラベル テキストの配置を指定すると、テキストが複数行にまたがる場合に役立ちます。
コンポーネントの幅に合わせるための右端での折り返し。'off' または 'on'、もしくは数値または logical 0 (false) または 1 (true) として指定します。'off' の値は false と等価であり、'on' の値は true と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。
このプロパティを使用して、表示するテキストよりコンポーネントの幅が小さい場合に水平方向に切り捨てられないようにします。
'off'— テキストは右端で折り返しされません。'on'— テキストを新しい行に折り返して、各行がコンポーネントの幅に収まるようにし、単語が区切られないようにします (可能な場合)。
WordWrap プロパティを 'on' に設定しても、コンポーネントの高さがテキストのすべての行を表示するには小さすぎる場合には、テキストが垂直方向に切り捨てられるのを回避できません。
フォントと色
フォントの色。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" |
|
"green" | "g" | [0 1 0] | "#00FF00" |
|
"blue" | "b" | [0 0 1] | "#0000FF" |
|
"cyan" | "c" | [0 1 1] | "#00FFFF" |
|
"magenta" | "m" | [1 0 1] | "#FF00FF" |
|
"yellow" | "y" | [1 1 0] | "#FFFF00" |
|
"black" | "k" | [0 0 0] | "#000000" |
|
"white" | "w" | [1 1 1] | "#FFFFFF" |
|
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラー コードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラー コードに変換します。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。
R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラー コードを取得します。
背景色。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" |
|
"green" | "g" | [0 1 0] | "#00FF00" |
|
"blue" | "b" | [0 0 1] | "#0000FF" |
|
"cyan" | "c" | [0 1 1] | "#00FFFF" |
|
"magenta" | "m" | [1 0 1] | "#FF00FF" |
|
"yellow" | "y" | [1 1 0] | "#FFFF00" |
|
"black" | "k" | [0 0 0] | "#000000" |
|
"white" | "w" | [1 1 1] | "#FFFFFF" |
|
"none" | 該当なし | 該当なし | 該当なし | 色なし |
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラー コードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラー コードに変換します。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。
R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラー コードを取得します。
データ型: double | char
対話機能
ラベルの外観。'on' または 'off' もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' の値は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は、matlab.lang.OnOffSwitchState 型の on/off の logical 値として保存されます。
'on'— ラベルは通常どおりに表示されます。
'off'— ラベルはグレー表示になります。
ツールヒント。文字ベクトル、文字ベクトルの cell 配列、string 配列、または 1 次元の categorical 配列として指定します。このプロパティを使用して、実行時にユーザーがポインターをコンポーネントに合わせるとメッセージが表示されるようにします。コンポーネントが無効になっている場合でも、ツールヒントは表示されます。複数行のテキストを表示するには、文字ベクトルの cell 配列または string 配列を指定します。配列の各要素は、テキストの各行になります。このプロパティを categorical 配列として指定した場合、MATLAB はカテゴリの完全なセットではなく、配列内の値を使用します。
コンテキスト メニュー。関数 uicontextmenu を使用して作成された ContextMenu オブジェクトとして指定します。このプロパティは、コンポーネントを右クリックしたときにコンテキスト メニューを表示するために使用します。
位置
ラベルの内側の位置とサイズ。[left bottom width height] として指定します。位置の値は、親コンテナーを基準とします。すべての測定単位はピクセルです。このプロパティ値は、Position プロパティと同一です。
この プロパティ は読み取り専用です。
ラベルの外側の位置とサイズ。[left bottom width height] として返されます。位置の値は、親コンテナーを基準とします。すべての測定単位はピクセルです。このプロパティ値は、Position と同一です。
レイアウト オプション。GridLayoutOptions オブジェクトとして指定します。このプロパティは、グリッド レイアウト コンテナーの子であるコンポーネントのオプションを指定します。コンポーネントがグリッド レイアウト コンテナーの子ではない場合 (たとえば、Figure またはパネルの子である場合) は、このプロパティは空で、効果はありません。しかし、コンポーネントがグリッド レイアウト コンテナーの子である場合は、GridLayoutOptions オブジェクトの Row プロパティおよび Column プロパティを設定して、グリッドの目的の行と列にコンポーネントを配置することができます。
たとえば、次のコードはラベルを親グリッドの 3 行目の 2 列目に配置します。
g = uigridlayout([4 3]); tlabel = uilabel(g); tlabel.Layout.Row = 3; tlabel.Layout.Column = 2;
ラベルが複数の行または列にまたがるようにするには、Row または Column プロパティを 2 要素のベクトルとして指定します。たとえば、次のラベルは 2 列目から 3 列目にまたがります。
tlabel.Layout.Column = [2 3];
コールバック
コールバック実行制御
親/子
親コンテナー。Figure オブジェクトまたはその子コンテナー (Tab、Panel、ButtonGroup、GridLayout) のいずれかとして指定します。コンテナーが指定されていない場合、MATLAB は関数 uifigure を呼び出し、親コンテナーとして使用される新しい Figure オブジェクトを作成します。
識別子
この プロパティ は読み取り専用です。
グラフィックス オブジェクトのタイプ。'uilabel' として返されます。
例
既定のラベルを作成します。
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";
