このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
Text のプロパティ
座標軸テキストの外観と動作
Text プロパティは、Text オブジェクトの外観と動作を制御します。プロパティの値を変更することによって、テキストの特定の要素を変更できます。プロパティのクエリと設定にはドット表記を使用します。
t = text(0.5,0.5,'text here'); s = t.FontSize; t.FontSize = 12;
テキスト
テキストの色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。既定値 [0 0 0] は、黒に相当します。
カスタム色を使用する場合は、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" | 該当なし | 該当なし | 該当なし | 色なし |
MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。
| RGB 3 成分 | 16 進数カラー コード | 外観 |
|---|---|---|
[0 0.4470 0.7410] | "#0072BD" |
|
[0.8500 0.3250 0.0980] | "#D95319" |
|
[0.9290 0.6940 0.1250] | "#EDB120" |
|
[0.4940 0.1840 0.5560] | "#7E2F8E" |
|
[0.4660 0.6740 0.1880] | "#77AC30" |
|
[0.3010 0.7450 0.9330] | "#4DBEEE" |
|
[0.6350 0.0780 0.1840] | "#A2142F" |
|
![Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue](colororder1.png)
![Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange](colororder2.png)
![Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow](colororder3.png)
![Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple](colororder4.png)
![Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green](colororder5.png)
![Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue](colororder6.png)
![Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red](colororder7.png)
例: '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{ | フォント名 — | '\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' に設定します。インライン モードでは、マークアップを 1 つのドル記号 ($) で囲みます。表示モードでは、マークアップを 2 つのドル記号 ($$) で囲みます。
| LaTeX モード | 例 | 結果 |
|---|---|---|
| インライン |
'$\int_1^{20} x^2 dx$' |
|
| 表示 |
'$$\int_1^{20} x^2 dx$$' |
|
テキストは LaTeX の既定のフォント スタイルで表示され、FontName、FontWeight、FontAngle のプロパティは無視されます。フォント スタイルを変更するには、LaTeX マークアップを使用します。
LaTeX インタープリターで使用できるテキストの最大サイズは 1200 文字です。複数行のテキストの場合は、さらに 1 行につき 10 文字ほど文字数が少なくなります。
TeX および LaTeX の使用例については、チャートのテキスト内のギリシャ文字と特殊文字を参照してください。LaTeX システムの詳細については、LaTeX プロジェクトの Web サイト (https://www.latex-project.org/) を参照してください。
SeriesIndex — シリーズ インデックス
"none" (既定値) | 正の整数
R2023b 以降
シリーズ インデックス。正の整数または "none" として指定します。このプロパティは、フォントの色を、他のオブジェクトの色と一致するよう再割り当てするのに役立ちます。
SeriesIndex の値が数値の場合、MATLAB はその数値を使用して、text、title、xlabel などの関数を呼び出してグラフ内にテキストを作成するときに色を割り当てるインデックスを計算します。このインデックスは、座標軸の ColorOrder プロパティに格納されている配列の行を表します。同じ SeriesIndex 数値をもつ座標軸内のオブジェクトは同じ色をもちます。
SeriesIndex の値が "none" の場合は、インデックス方式に参加しない中間色に対応します。
手動の色割り当てにより SeriesIndex の動作をオーバーライドする方法
フォントの色を手動で制御するには、Text オブジェクトの Color プロパティを色名や RGB 3 成分などのカラー値に設定します。
フォントの色を手動で設定すると、MATLAB はそのオブジェクトの色の自動選択を使用せず、SeriesIndex プロパティの値に関係なく色を保持できるようにします。ColorMode プロパティは、色が手動で (ユーザーにより) 設定されているか、自動的に設定されているかを示します。値 "manual" は手動選択を示し、値 "auto" は自動選択を示します。
自動選択を有効にするには、SeriesIndex プロパティを正の整数に設定し、ColorMode プロパティを "auto" に設定します。
場合によっては、MATLAB は SeriesIndex プロパティを 0 に設定し、色の自動選択も無効にします。
フォント
テキスト ボックス
Rotation — テキストの方向
度単位のスカラー値
テキストの方向。度単位のスカラー値として指定します。回転値 0 度は、テキストを水平にします。垂直テキストの場合、このプロパティを 90 または -90 に設定します。正の角度はテキストを反時計回りに回転させます。負の角度はテキストを時計回りに回転させます。
データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
EdgeColor — ボックスの外枠の色
'none' (既定値) | RGB 3 成分 | 16 進数カラー コード | 'r' | 'g' | 'b' | ...
ボックスの外枠の色。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" | 該当なし | 該当なし | 該当なし | 色なし |
MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。
| RGB 3 成分 | 16 進数カラー コード | 外観 |
|---|---|---|
[0 0.4470 0.7410] | "#0072BD" |
|
[0.8500 0.3250 0.0980] | "#D95319" |
|
[0.9290 0.6940 0.1250] | "#EDB120" |
|
[0.4940 0.1840 0.5560] | "#7E2F8E" |
|
[0.4660 0.6740 0.1880] | "#77AC30" |
|
[0.3010 0.7450 0.9330] | "#4DBEEE" |
|
[0.6350 0.0780 0.1840] | "#A2142F" |
|
例: 'blue'
例: [0 0 1]
例: '#0000FF'
BackgroundColor — テキスト ボックスの背景色
'none' (既定値) | RGB 3 成分 | 16 進数カラー コード | 'r' | 'g' | 'b' | ...
テキスト ボックスの背景色。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" | 該当なし | 該当なし | 該当なし | 色なし |
MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。
| RGB 3 成分 | 16 進数カラー コード | 外観 |
|---|---|---|
[0 0.4470 0.7410] | "#0072BD" |
|
[0.8500 0.3250 0.0980] | "#D95319" |
|
[0.9290 0.6940 0.1250] | "#EDB120" |
|
[0.4940 0.1840 0.5560] | "#7E2F8E" |
|
[0.4660 0.6740 0.1880] | "#77AC30" |
|
[0.3010 0.7450 0.9330] | "#4DBEEE" |
|
[0.6350 0.0780 0.1840] | "#A2142F" |
|
例: 'blue'
例: [0 0 1]
例: '#0000FF'
LineStyle — ボックスの外枠のライン スタイル
'-' (既定値) | '--' | ':' | '-.' | 'none'
ボックスの外枠のライン スタイル。次の表のいずれかのオプションを指定します。
| ライン スタイル | 説明 | 結果として得られる線 |
|---|---|---|
"-" | 実線 |
|
"--" | 破線 |
|
":" | 点線 |
|
"-." | 一点鎖線 |
|
"none" | ラインなし | ラインなし |
LineWidth — ボックスの外枠の幅
0.5 (既定値) | スカラー数値
ボックスの外枠の幅。ポイント単位のスカラー数値として指定します。1 ポイントは 1/72 インチです。
例: 1.5
データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
Margin — テキスト ボックス内のテキスト周囲の余白
3 (既定値) | スカラー数値
テキスト ボックス内のテキスト周囲の余白。ポイント単位のスカラー数値として指定します。
MATLAB は、Extent プロパティ値に Margin プロパティ値を加えた値を使用してテキスト ボックスのサイズを決定します。
例: 8
データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
Clipping — 座標軸のプロット ボックスへのクリップ
'off' (既定値) | on/off logical 値
座標軸のプロット ボックスへのテキストのクリップ。'on' または 'off' として、もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。
'on'— テキストを座標軸のプロット ボックスにクリップします。座標軸の
ClippingStyleプロパティが既定の'3dbox'に設定される場合、MATLAB は、テキストの配置に応じてテキスト全体を表示するか、あるいはテキストを何も表示しないかのいずれかになります。テキストのPositionプロパティで定義されたポイントが座標軸の内側に位置する場合、MATLAB はテキスト全体を表示します。ポイントが座標軸の外側に位置する場合、MATLAB は何も表示しません。座標軸の
ClippingStyleプロパティが'rectangle'に設定される場合、MATLAB は座標軸のプロット ボックスの内側に位置するテキスト部分を表示し、座標軸のプロット ボックスの外側に位置するテキスト部分は表示しません。
'off'— テキストをクリップしません。部分的に座標軸のプロット ボックスの外に表示される場合があります。
メモ
関連付けられている座標軸の Clipping プロパティが既定の 'on' の場合、個々のオブジェクトがそれぞれのクリップ動作を制御します。座標軸の Clipping プロパティが 'off' に設定される場合、MATLAB は個々のオブジェクトの Clipping プロパティに関係なく、座標軸のどのオブジェクトもクリップしません。
位置
Extent — テキストを囲む四角形のサイズと位置
4 要素ベクトル
この プロパティ は読み取り専用です。
テキストを囲む四角形のサイズと位置。余白を含みません。[left bottom width height] の形式の 4 要素ベクトルとして返されます。最初の 2 つの要素 left と bottom は、四角形の左下隅の位置を定義します。最後の 2 つの要素 width と height は、四角形の大きさを定義します。
既定では、範囲の値はデータ単位で定義されます。単位を変更するには、Units プロパティを使用します。
例: [0.5 0.5 0.4 0.2]
Position プロパティの x 値を基準にしたテキストの水平方向の整列。次の表のいずれかの値を指定します。垂直線は、テキストに対する x 値の位置を示します。
| 値 | 結果 |
|---|---|
'left' (既定) |
|
'center' |
|
'right' |
|
Position プロパティの y 値を基準にしたテキストの垂直方向の整列。次の表のいずれかの値を指定します。水平線は、テキストに対する y 値の位置を示します。
| 値 | 結果 |
|---|---|
'middle' |
|
'top' |
|
'cap' |
|
'bottom' |
|
'baseline' |
|
AffectAutoLimits — アンカー ポイントの座標軸の範囲への組み込み
"off" (既定値) | on/off logical 値
R2023b 以降
Text オブジェクトのアンカー ポイントを座標軸の範囲の自動選択に含めます。"on" または "off"、もしくは数値または logical 1 (true) または 0 (false) として指定します。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。
Position プロパティがアンカー ポイントの位置を定義します。
このプロパティを "on" に設定すると、テキストの位置の特定および微調整に役立ちます。アンカー ポイントを範囲の自動選択から除外するには、このプロパティを "off" に設定します。
対話機能
コールバック
コールバック実行制御
親/子
識別子
バージョン履歴
R2006a より前に導入
You can also select a web site from the following list:
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)