このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
ConstantLine のプロパティ
定数直線の外観と動作
定数直線とは、直交座標軸の指定された x 値または y 値を通って描画される直線です。関数 xline および yline は垂直の定数直線と水平の定数直線をそれぞれ作成します。ConstantLine プロパティ値を変更することによって、定数直線の外観と動作を変更できます。
xl = xline(4); xl.LineWidth = 2;
位置
ラベル
Label — ライン ラベル
'' (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | string 配列 | 数値配列
ライン ラベル。文字ベクトル、文字ベクトルの cell 配列、string 配列、または数値配列として指定します。複数行のラベルを作成するには、string 配列、または文字ベクトルの cell 配列を使用します。
例: 'cutoff frequency'
例: {'first line','second line'}
例: ["first line" "second line"]
上付き文字、下付き文字、ギリシャ文字、数学記号などの特殊文字を含めるには、TeX マークアップを使用します。サポートされるマークアップの一覧については、Interpreter プロパティを参照してください。
LabelHorizontalAlignment — ラベルの水平方向の配置
'right' (既定値) | 'left' | 'center'
ラインに対するラベルの水平方向の配置。次の表のいずれかのオプションとして指定します。
| オプション | 説明 | |
|---|---|---|
'right' | ラインの右側。
| |
'left' | ラインの左側。
| |
'center' | ラインの中心。垂直線では、ラベルでラインが分割されます。
| |
LabelVerticalAlignment — ラベルの垂直方向の配置
'top' (既定値) | 'middle' | 'bottom'
ラインに対するラベルの垂直方向の配置。次の表のいずれかのオプションとして指定します。
| オプション | 説明 | |
|---|---|---|
'top' | ラインの上方。
| |
'middle' | ラインの中央。水平線では、ラベルでラインが分割されます。
| |
'bottom' | ラインの下方。
| |
LabelOrientation — ラベルの向き
'aligned' (既定値) | 'horizontal'
ラベルの向き。'aligned' または 'horizontal' として指定します。例を表に示します。
| 向き | 説明 | |
|---|---|---|
'aligned' | ラベルの向きはラインの向きと同じです。
| |
'horizontal' | ラインの向きに関係なく、ラベルは水平です。
| |
テキスト インタープリター。次の値のいずれかとして指定します。
'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/) を参照してください。
色とスタイル
Color — ラインの色
[0.15 0.15 0.15] (既定値) | 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" |
|
![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)
例: 'g'
例: [0.6 0.2 0.5]
例: '#D2F9A7'
ライン スタイル。次の表にリストされたオプションのいずれかとして指定します。
| ライン スタイル | 説明 | 結果として得られる線 |
|---|---|---|
"-" | 実線 |
|
"--" | 破線 |
|
":" | 点線 |
|
"-." | 一点鎖線 |
|
"none" | ラインなし | ラインなし |
LineWidth — ライン幅
0.5 (既定値) | 正の値
ライン幅。ポイント単位の正の値として指定します。
Alpha — ラインの透明度
0.7 (既定値) | 範囲 [0,1] のスカラー
ラインの透明度。[0,1] の範囲のスカラーとして指定します。値 1 は不透明で、値 0 は完全に透明です。0 と 1 の間の値は半透明です。
SeriesIndex — シリーズ インデックス
"none" (既定値) | 正の整数
シリーズ インデックス。正の整数または "none" として指定します。このプロパティは、ConstantLine オブジェクトの色とライン スタイルを他のオブジェクトと一致するよう再割り当てするのに役立ちます。
SeriesIndex プロパティが数値の場合、MATLAB はこの数値を使用して、関数 xline または yline を呼び出すときに色とライン スタイルを割り当てるインデックスを計算します。インデックスは座標軸の ColorOrder プロパティと LineStyleOrder プロパティに格納されている配列の行を参照します。同じ SeriesIndex 数値をもつ座標軸内のオブジェクトは同じ色 (および、該当する場合は同じライン スタイル) をもちます。
SeriesIndex の値が "none" の場合は、インデックス方式に参加しない中間色の実線に対応します。
色、ライン スタイル、またはマーカーの手動設定が SeriesIndex の動作をオーバーライドする方法
色とライン スタイルを手動で制御するには、ConstantLine オブジェクトの Color および LineStyle プロパティを設定します。
オブジェクトのこれらのプロパティを手動で設定すると、MATLAB はそのオブジェクトの色とライン スタイルの自動選択を無効にし、SeriesIndex プロパティの値に関係なく選択を保持できるようにします。ColorMode および LineStyleMode プロパティは、色とライン スタイルが手動で (ユーザーにより) 設定されているか、自動的に設定されているかを示します。これらの各モード プロパティについて、値 "manual" は手動選択を示し、"auto" は自動選択を示します。
自動選択を再度有効にするには、ColorMode、LineStyleMode、または両方のプロパティを "auto" に設定し、SeriesIndex プロパティを正の整数に設定します。
場合によっては、MATLAB は SeriesIndex プロパティを 0 に設定し、色の自動選択も無効にします。
フォント
凡例
対話機能
コールバック
コールバック実行制御
親/子
識別子
バージョン履歴
R2018b で導入
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)