StackedLineChart のプロパティ

積み上げプロットの外観と動作

StackedLineChart プロパティは、"積み上げプロット" の外観と動作を制御します。積み上げプロットでは、table または timetable の変数、または行列の列を、個別の y 軸で上下に並べてプロットできます。プロパティの値を変更することによって、積み上げプロットの特定の要素を変更できます。

プロパティのクエリと設定にドット表記を使用できます。

T = readtable("outages.csv");
s = stackedplot(T);
c = s.Color;
s.Color = "red";

テーブルデータ

すべて展開する

`SourceTable` — ソース table
table | timetable | table の cell 配列 | timetable の cell 配列

ソース table。table、timetable、table の cell 配列、または timetable の cell 配列として指定します。

関数 table を使用してワークスペース変数から table を作成できます。また、関数 readtable を使用してデータを table としてインポートできます。関数 timetable を使用してワークスペース変数から timetable を作成できます。また、関数 readtimetable を使用してデータを timetable としてインポートできます。

メモ

プロットされるデータが配列から取得される場合、プロパティは無視され、読み取り専用になります。

配列データ

すべて展開する

`XData` — x 値
ベクトル

x 値。ベクトルとして指定します。ベクトル内の要素数は YData プロパティの値の行数に等しくなければなりません。

メモ

プロットされるデータが table または timetable から取得される場合、プロパティは無視され、読み取り専用になります。

例: [1:10]

`YData` — y 値
配列

y 値。配列として指定します。関数 stackedplot は YData の値の各列を独自の y 軸でプロットします。

メモ

プロットされるデータが table または timetable から取得される場合、プロパティは無視され、読み取り専用になります。

例: [1:10;5:5:50]

積み上げプロットの表示

すべて展開する

`DisplayVariables` — "y" 軸に表示される変数
string 配列 | 数値配列 | logical 配列 | cell 配列 | `vartype` 添字

"y" 軸に表示される変数。表のインデックス方式のいずれかを使用して指定します。

メモ: 複数の table または timetable から積み上げプロットを作成する場合、DisplayVariables には string 配列、文字ベクトルの cell 配列、あるいは要素が string 配列または文字ベクトルの cell 配列である、cell 配列のみを指定できます。

インデックス方式例

インデックス方式	例
変数名: string 配列、または文字ベクトルの cell 配列。	`"A"` — `A` という名前の変数 `["A","B"]` または `{'A','B'}` — `A` および `B` という名前の 2 つの変数
変数インデックス (単一の table または timetable の場合のみ): table 内の変数の位置を参照するインデックス番号。数値のベクトル。 logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の `0` 値や `false` 値は省略できます。	`3` — table の 3 番目の変数 `[2 3]` — table の 2 番目と 3 番目の変数 `[false false true]` — 3 番目の変数
変数の型 (単一の table または timetable の場合のみ): 指定した型の変数を選択する `vartype` 添字。	`vartype("categorical")` — categorical 値を含んでいるすべての変数
入れ子の cell 配列に指定された変数: 数値配列を含む cell 配列 (単一の table または timetable の場合のみ)。 string 配列を含む cell 配列。文字ベクトルの cell 配列を含む、cell 配列。	`{[1 2] 3}` — 1 番目と 2 番目の変数が 1 本目の "y" 軸にプロットされ、3 番目の変数が 2 本目の "y" 軸にプロットされます。 `{["A","B"],"C"}` — 変数 `A` と変数 `B` が 1 本目の "y" 軸にプロットされ、変数 `C` が 2 本目の "y" 軸にプロットされます。 `{{'A','B'},'C'}` — 変数 `A` と変数 `B` が 1 本目の "y" 軸にプロットされ、変数 `C` が 2 本目の "y" 軸にプロットされます。

変数名:

string 配列、または文字ベクトルの cell 配列。

"A" — A という名前の変数
["A","B"] または {'A','B'} — A および B という名前の 2 つの変数

変数インデックス (単一の table または timetable の場合のみ):

table 内の変数の位置を参照するインデックス番号。
数値のベクトル。
logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。

3 — table の 3 番目の変数
[2 3] — table の 2 番目と 3 番目の変数
[false false true] — 3 番目の変数

変数の型 (単一の table または timetable の場合のみ):

指定した型の変数を選択する vartype 添字。

vartype("categorical") — categorical 値を含んでいるすべての変数

入れ子の cell 配列に指定された変数:

数値配列を含む cell 配列 (単一の table または timetable の場合のみ)。
string 配列を含む cell 配列。
文字ベクトルの cell 配列を含む、cell 配列。

{[1 2] 3} — 1 番目と 2 番目の変数が 1 本目の "y" 軸にプロットされ、3 番目の変数が 2 本目の "y" 軸にプロットされます。
{["A","B"],"C"} — 変数 A と変数 B が 1 本目の "y" 軸にプロットされ、変数 C が 2 本目の "y" 軸にプロットされます。
{{'A','B'},'C'} — 変数 A と変数 B が 1 本目の "y" 軸にプロットされ、変数 C が 2 本目の "y" 軸にプロットされます。

例: s.DisplayVariables = [1 3 4] は 1 番目、3 番目、および 4 番目の変数を指定します。

例: s.DisplayVariables = {["Temp1","Temp2"],"Pressure"} は入れ子にされた cell 配列を使用して Temp1 と Temp2 が同時にプロットされるように指定します。

例: s.DisplayVariables = {{1,2},5} は変数を番号で指定し、1 番目と 2 番目の変数を同時にプロットします。

`EventsVisible` — イベントの表示
`"on"` | `"off"` | on/off logical 値

イベントの表示。"on" または "off"、もしくは数値または logical 1 (true) または 0 (false) として指定します。"on" の値は true と等価であり、"off" は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

イベントは、入力 timetable に追加されたイベントテーブルから取得します。関数 stackedplot は、積み上げプロット上に垂直のラインまたは影付き領域としてイベントをプロットします。イベントテーブルの詳細については、eventtable を参照してください。

`CombineMatchingNames` — 一致する名前をもつ変数を結合するためのフラグ
`true` または `1` (既定値) | `false` または `0`

一致する名前をもつ変数を同じ "y" 軸に結合するためのフラグ。数値または logical 1 (true) または 0 (false) として指定します。このフラグを false または 0 に設定すると、同じ名前をもつが異なる入力からの変数が、異なる "y" 軸にプロットされます。

`XVariable` — "x" 値を含む table 変数
string 配列 | 文字ベクトル | 文字ベクトルの cell 配列 | 整数配列 | logical 配列

"x" 値を含む table 変数。string 配列、文字ベクトル、文字ベクトルの cell 配列、整数配列、または logical 配列として指定します。

入力が 1 つの table である場合、XVariable はその table の 1 つの変数を指定します。
入力が複数の table である場合、XVariable は、すべての table に存在する 1 つの変数、または各 table で異なる 1 つの変数のいずれかを指定できます。
たとえば、入力が tbl1,tbl2,tbl3 である場合、各 table に "x" 値を提供する X という名前の変数があれば、XVariable を "X" に指定できます。ただし、tbl1 に X1 という変数、tbl2 に X2 という変数、tbl3 に X3 という変数がある場合、XVariable は ["X1","X2","X3"] になります。

メモ

プロットされるデータが配列または timetable から取得される場合、プロパティは無視され、読み取り専用になります。

`XLimits` — x 軸の範囲の上限と下限
`[min max]` の形式の 2 要素ベクトル

x 軸の範囲の上限と下限。[min max] の形式の 2 要素ベクトルとして指定します。ここで、max は min より大きい値です。範囲は、数値、カテゴリカル値、datetime 値、または duration 値として指定できます。ただし、指定する値の型は、軸に沿った値の型と一致していなければなりません。

両方の限界値を指定することも、一方の限界値を指定して座標軸にもう一方を自動計算させることもできます。下限値および上限値を自動的に計算する場合は、それぞれ -inf または inf を使用します。

例: s.XLimits = [0 100]

例: s.XLimits = [-inf 100]

例: s.XLimits = [0 inf]

`AxesProperties` — y 軸のプロパティ
`StackedAxesProperties` オブジェクトの配列

y 軸のプロパティ。StackedAxesProperties オブジェクトの配列として指定します。AxesProperties にインデックスを付けて、積み上げプロットの 1 つの変数に対する y 軸プロパティを変更できます。詳細については、StackedAxesProperties のプロパティを参照してください。

例: s.AxesProperties(2).YLimits = [0 10] は、積み上げプロットの 2 番目のプロットの範囲を指定します。その他のプロットは変更されません。

`LineProperties` — ラインのプロパティ
`StackedLineProperties` オブジェクトの配列

ラインのプロパティ。StackedLineProperties オブジェクトの配列として指定します。LineProperties にインデックスを付けて、積み上げプロットの 1 つの変数に対するラインのプロパティを変更できます。詳細については、StackedLineProperties のプロパティを参照してください。

例: s.LineProperties(3).Color = "red" は、積み上げプロットで 3 番目のプロットのラインの色を変更します。その他のプロットは変更されません。

`GridVisible` — グリッドラインの表示
`"on"` | `"off"` | on/off logical 値

グリッドラインの表示。"on" または "off"、もしくは数値または logical 1 (true) または 0 (false) として指定します。"on" の値は true と等価であり、"off" は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

ライン

すべて展開する

`Color` — ラインの色
`[0 0.4470 0.7410]` (既定値) | RGB 3 成分 | 16 進数カラーコード | `"r"` | `"g"` | `"b"` | ...

ラインの色。RGB 3 成分、16 進数カラーコード、または 1 番目の表にリストされている色のオプションのいずれかとして指定します。

カスタム色を使用する場合は、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 ピクセル幅で表示されます。

マーカー

すべて展開する

`Marker` — マーカー記号
`"none"` (既定値) | `"o"` | `"+"` | `"*"` | `"."` | ...

マーカー記号。次の表に挙げる値のいずれかとして指定します。既定では、オブジェクトはマーカーを表示しません。マーカー記号を指定すると、各データ点または各頂点にマーカーが追加されます。

マーカー	説明	結果のマーカー
`"o"`	円
`"+"`	プラス記号
`"*"`	アスタリスク
`"."`	点
`"x"`	十字
`"_"`	水平線
`"\|"`	垂直線
`"square"`	正方形
`"diamond"`	菱形
`"^"`	上向き三角形
`"v"`	下向き三角形
`">"`	右向き三角形
`"<"`	左向き三角形
`"pentagram"`	星形五角形
`"hexagram"`	星形六角形
`"none"`	マーカーなし	該当なし

`MarkerSize` — マーカーサイズ
`6` (既定値) | 正の値

マーカーサイズ。ポイント単位の正の値として指定します。1 ポイントは 1/72 インチです。

`MarkerEdgeColor` — マーカーの輪郭の色
`"none"` | RGB 3 成分 | 16 進数カラーコード | `"r"` | `"g"` | `"b"` | ...

マーカーの輪郭の色。"none"、RGB 3 成分、16 進数カラーコード、または 1 番目の表にリストされている色のオプションのいずれかとして指定します。

カスタム色を使用する場合は、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 進数カラーコード	外観
`"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"`

例: [0.5 0.5 0.5]

例: "blue"

例: "#D2F9A7"

`MarkerFaceColor` — マーカーの塗りつぶし色
`"none"` (既定値) | RGB 3 成分 | 16 進数カラーコード | `"r"` | `"g"` | `"b"` | ...

マーカーの塗りつぶし色。"none"、RGB 3 成分、16 進数カラーコード、または 1 番目の表にリストされている色のオプションのいずれかとして指定します。

カスタム色を使用する場合は、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 進数カラーコード	外観
`"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"`

例: [0.3 0.2 0.1]

例: "green"

例: "#D2F9A7"

フォント

すべて展開する

`FontName` — フォント名
サポートされているフォント名 | `"FixedWidth"`

フォント名。サポートされているフォント名または "FixedWidth" として指定します。テキストを正しく表示し印刷するには、システムでサポートされているフォントを選択しなければなりません。既定のフォントは、オペレーティングシステムとロケールによって異なります。

どのロケールでもテキストが整って見える固定幅のフォントを使用するには、"FixedWidth" を使用します。固定幅フォントは、ルートの FixedWidthFontName プロパティによって決まります。ルートの FixedWidthFontName プロパティを設定すると、表示内容が新しいフォントを使用して直ちに更新されます。

`FontSize` — フォントサイズ
`8` (既定値) | スカラー数値

フォントサイズ。スカラー数値として指定します。フォントサイズは、タイトル、軸ラベル、目盛りラベルに影響します。また、座標軸に関連付けられているすべての凡例にも影響します。フォントサイズはポイント単位で測定されます。

例: s.FontSize = 12

ラベル

すべて展開する

`Title` — 積み上げプロットのタイトル
文字ベクトル | string スカラー | 数値スカラー | string 配列 | 数値配列 | cell 配列 | categorical 配列

積み上げプロットのタイトル。文字ベクトル、string スカラー、数値スカラー、string 配列、数値配列、cell 配列、または categorical 配列として指定します。

Title の値が配列の場合、その配列の要素はタイトルとして上下に並べて表示されます。値が cell 配列の場合、その要素は文字ベクトル、string、または数値にすることができます。

または、関数 title を使用してタイトルを追加できます。

title("My Title")

例: s.Title = "A Title";

例: s.Title = 137

例: s.Title = ["Stacked plot",string(datetime("now"))];

例: s.Title = {"Stacked plot",137};

`DisplayLabels` — y 軸のラベル
文字ベクトルの cell 配列 | string 配列

積み上げられた Y 軸の値のラベル。文字ベクトルの cell 配列または string 配列として指定します。DisplayVariables の各値に対して 1 つのラベルを指定します。既定では、これらの値は DisplayVariables の値と同じです。

DisplayVariables の値の追加、削除または並べ替えを行うと、このプロパティが適宜更新されて値とラベルのペアが維持されます。

例: s.DisplayLabels = ["Temperature","Humidity","Pressure"]

`XLabel` — "x" 軸のラベル
文字ベクトル | string スカラー | 数値スカラー | string 配列 | 数値配列 | cell 配列 | categorical 配列

"x" 軸のラベル。文字ベクトル、string スカラー、数値スカラー、string 配列、数値配列、cell 配列、または categorical 配列として指定します。

XLabel の値が配列の場合、その配列の要素は x 軸ラベルとして上下に並べて表示されます。値が cell 配列の場合、その要素は文字ベクトル、string、または数値にすることができます。

または、関数 xlabel を使用して x 軸ラベルを追加します。

xlabel("My x-Axis Label")

例: s.XLabel = "An x-axis Label";

例: s.XLabel = 137

例: s.XLabel = ["An x-axis Label",string(datetime("now"))];

例: s.XLabel = {"An x-axis Label",137};

`LegendLabels` — 凡例の入力のラベル
string 配列 | 文字ベクトルの cell 配列

凡例の入力のラベル。string 配列または文字ベクトルの cell 配列として指定します。各ラベルは入力 table または timetable に対応します。既定では、凡例のラベルは入力 table または timetable の名前です。

例: s.LegendLabels = ["Table1","Table2","Table3"]

`LegendOrientation` — 凡例のラベルの向き
`"horizontal"` (既定値) | `"vertical"`

凡例のラベルの向き。"horizontal" または "vertical" として指定します。"horizontal" の向きではラベルが凡例内で水平方向にリストされ、"vertical" の向きではラベルが凡例内で垂直方向にリストされます。

`LegendVisible` — 凡例の可視性
`"on"` | `"off"` | logical 値

凡例の可視性。"on" または "off" もしくは数値または logical 1 (true) または 0 (false) として指定します。LegendVisible が "off" の場合、凡例は表示されません。

既定値は、次のとおりです。

入力が単一の table または timetable の場合は "off"
入力が複数の table または timetable の場合は "on"

"on" の値は true と等価であり、"off" は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

位置

すべて展開する

`OuterPosition` — 外側のサイズと位置
`[0 0 1 1]` (既定値) | 4 要素ベクトル

親コンテナー (通常は Figure、パネルまたはタブ) 内のプロットの外側のサイズと位置。[left bottom width height] の形式の 4 要素ベクトルとして指定します。

left 要素と bottom 要素で、コンテナーの左下隅からプロットの左下隅までの距離を定義します。
width 要素と height 要素は、タイトル、軸ラベルなどの装飾を含めてプロットと座標軸を囲む四角形の幅と高さです。

既定値 [0 0 1 1] は、コンテナーの内側全体をカバーします。単位は、コンテナーのサイズを基準にして正規化されます。単位を変更するには、Units プロパティを設定します。

メモ

親コンテナーが TiledChartLayout オブジェクトの場合、このプロパティを設定しても効果はありません。

`InnerPosition` — 内側のサイズと位置
4 要素ベクトル

親コンテナー (通常は Figure、パネルまたはタブ) 内のプロットの内側のサイズと位置。[left bottom width height] の形式の 4 要素ベクトルとして指定します。

left 要素と bottom 要素で、コンテナーの左下隅からプロットの左下隅までの距離を定義します。
width 要素と height 要素は、タイトル、軸ラベルなどの装飾を除いてプロットと座標軸を囲む四角形の幅と高さです。

メモ

親コンテナーが TiledChartLayout オブジェクトの場合、このプロパティを設定しても効果はありません。

`Position` — 内側のサイズと位置
4 要素ベクトル

親コンテナー (通常は Figure、パネルまたはタブ) 内のプロットの内側のサイズと位置。[left bottom width height] の形式の 4 要素ベクトルとして返されます。このプロパティは、InnerPosition プロパティと等価です。

メモ

親コンテナーが TiledChartLayout オブジェクトの場合、このプロパティを設定しても効果はありません。

`PositionConstraint` — 一定に保つ位置
`"outerposition"` | `"innerposition"`

装飾の追加、削除または変更を行うときに一定に保つ位置プロパティ。次の値のいずれかとして指定します。

"outerposition" — タイトルや軸ラベルなどの装飾の追加、削除、または変更を行うときに、OuterPosition プロパティが一定に保たれます。位置の調整が必要な場合、MATLAB は InnerPosition プロパティを調整します。
"innerposition" — タイトルや軸ラベルなどの装飾の追加、削除、または変更を行うときに、InnerPosition プロパティが一定に保たれます。位置の調整が必要な場合、MATLAB は OuterPosition プロパティを調整します。

メモ

親コンテナーが TiledChartLayout オブジェクトの場合、このプロパティを設定しても効果はありません。

`Units` — 位置の単位
`"normalized"` (既定値) | `"inches"` | `"centimeters"` | `"points"` | `"pixels"` | `"characters"`

位置の単位。次の値のいずれかとして指定します。

`Units`	説明
`"normalized"` (既定)	コンテナー (通常は Figure またはパネル) を基準に正規化されます。コンテナーの左下隅は `(0,0)` に、右上隅は `(1,1)` にマッピングされます。
`"inches"`	インチ。
`"centimeters"`	センチメートル。
`"characters"`	グラフィックスルートオブジェクトの既定の uicontrol フォントに基づきます。文字の幅 = 文字 `x` の幅。文字の高さ = 2 行のテキストのベースライン間の距離。
`"points"`	タイポグラフィのポイント。1 ポイントは 1/72 インチです。
`"pixels"`	ピクセル。 R2015b 以降、Windows^® および Macintosh システムにおいて、ピクセル単位の距離はシステム解像度に依存しません。 Windows システムの 1 ピクセルは 1/96 インチです。 Macintosh システムの 1 ピクセルは 1/72 インチです。 Linux^® システムでは、ピクセルのサイズは使用しているシステムの解像度によって決まります。

オブジェクトの作成中に Name,Value のペアとして単位を指定する場合、それらの単位を使用するプロパティ (Position など) を指定する前に Units プロパティを設定しなければなりません。

`Layout` — レイアウトオプション
空の `LayoutOptions` 配列 (既定値) | `TiledChartLayoutOptions` オブジェクト | `GridLayoutOptions` オブジェクト

レイアウトオプション。TiledChartLayoutOptions オブジェクトまたは GridLayoutOptions オブジェクトとして指定します。このプロパティは、チャートがタイル表示チャートレイアウトまたはグリッドレイアウトのいずれかである場合に役立ちます。

タイル表示チャートレイアウトのグリッド内にチャートを配置するには、TiledChartLayoutOptions オブジェクトの Tile プロパティと TileSpan プロパティを設定します。たとえば、3 行 3 列のタイル表示チャートレイアウトについて考えます。レイアウトの中央にタイルのグリッドがあり、外側のエッジに沿って 4 つのタイルがあります。実際には、グリッドは非表示であり、座標軸またはチャートが入力されるまで、外側のタイルは領域を占有しません。

Diagram of a 3-by-3 tiled chart layout.

次のコードは、チャート c をグリッドの 3 番目のタイルに配置します。

c.Layout.Tile = 3;

複数のタイルにわたってチャートを広げるには、TileSpan プロパティを 2 要素ベクトルとして指定します。たとえば、次のチャートは 2 行 3 列のタイルに広がります。

c.Layout.TileSpan = [2 3];

チャートを周囲のいずれかのタイルに配置するには、Tile プロパティを "north"、"south"、"east"、または "west" として指定します。たとえば、値を "east" に設定すると、タイル内のチャートはグリッドの右側のタイルに配置されます。

c.Layout.Tile = "east";

アプリ内のレイアウトにチャートを配置するには、このプロパティを GridLayoutOptions オブジェクトとして指定します。アプリ内でのグリッドレイアウトの使い方の詳細については、uigridlayout を参照してください。

チャートがタイル表示チャートレイアウトまたはグリッドレイアウトのいずれの子でもない場合 (たとえば、Figure またはパネルの子である場合)、このプロパティは空で、効果はありません。

対話機能

すべて展開する

`Visible` — 可視性の状態
`"on"` (既定値) | on/off logical 値

可視性の状態。"on" または "off"、もしくは数値または logical 1 (true) または 0 (false) として指定します。"on" の値は true と等価であり、"off" は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

"on" — オブジェクトを表示します。
"off" — オブジェクトを削除せずに非表示にします。非表示のオブジェクトのプロパティには引き続きアクセスできます。

親/子

すべて展開する

`Parent` — 親コンテナー
`Figure` オブジェクト | `Panel` オブジェクト | `Tab` オブジェクト | `TiledChartLayout` オブジェクト | `GridLayout` オブジェクト

親コンテナー。Figure、Panel、Tab、TiledChartLayout、または GridLayout オブジェクトとして指定します。

`HandleVisibility` — オブジェクトハンドルの可視性
`"on"` (既定値) | `"off"` | `"callback"`

親の Children プロパティ内でのオブジェクトハンドルの可視性。次の値のいずれかとして指定します。

"on" — オブジェクトハンドルは常に表示されます。
"off" — オブジェクトハンドルは常に非表示です。このオプションは、他の関数による意図しない変更を防止するために役立ちます。HandleVisibility を "off" に設定すると、その関数の実行中にハンドルが一時的に非表示になります。
"callback" — オブジェクトハンドルはコールバック内から、あるいはコールバックにより呼び出される関数から参照できます。しかし、コマンドラインから呼び出される関数からは参照できません。このオプションを使用すると、コマンドラインからのオブジェクトへのアクセスがブロックされますが、コールバック関数からのアクセスは許可されます。

オブジェクトが親の Children プロパティ内にリストされない場合、オブジェクト階層の検索またはハンドルプロパティのクエリによってオブジェクトハンドルを取得する関数は、そのオブジェクトハンドルを返しません。こうした関数の例としては、関数 get、findobj、gca、gcf、gco、newplot、cla、clf、および close などが挙げられます。

非表示のオブジェクトハンドルは有効なままです。ルートの ShowHiddenHandles プロパティを "on" に設定すると、HandleVisibility プロパティの設定にかかわらず、すべてのオブジェクトハンドルがリストされます。

バージョン履歴

R2018b で導入

すべて展開する

R2020a: `ActivePositionProperty` は非推奨

R2020a 以降、ActivePositionProperty の設定または取得は推奨されていません。代わりに、PositionConstraint プロパティを使用してください。

現時点で ActivePositionProperty を削除する予定はありませんが、関数 set、get、または properties をチャートオブジェクトで呼び出す際にこのプロパティはリストされなくなりました。

コードを更新するには、以下の変更を行います。

ActivePositionProperty のすべてのインスタンスを PositionConstraint に置き換える。
"position" オプションへのすべての参照を "innerposition" オプションに置き換える。

参考

関数

stackedplot

プロパティ

StackedAxesProperties のプロパティ | StackedLineProperties のプロパティ

StackedLineChart のプロパティ

テーブル データ

SourceTable — ソース table table | timetable | table の cell 配列 | timetable の cell 配列

配列データ

XData — x 値 ベクトル

YData — y 値 配列

積み上げプロットの表示

DisplayVariables — "y" 軸に表示される変数 string 配列 | 数値配列 | logical 配列 | cell 配列 | vartype 添字

EventsVisible — イベントの表示 "on" | "off" | on/off logical 値

CombineMatchingNames — 一致する名前をもつ変数を結合するためのフラグ true または 1 (既定値) | false または 0

XVariable — "x" 値を含む table 変数 string 配列 | 文字ベクトル | 文字ベクトルの cell 配列 | 整数配列 | logical 配列

XLimits — x 軸の範囲の上限と下限 [min max] の形式の 2 要素ベクトル

AxesProperties — y 軸のプロパティ StackedAxesProperties オブジェクトの配列

LineProperties — ラインのプロパティ StackedLineProperties オブジェクトの配列

GridVisible — グリッド ラインの表示 "on" | "off" | on/off logical 値

ライン

Color — ラインの色 [0 0.4470 0.7410] (既定値) | RGB 3 成分 | 16 進数カラー コード | "r" | "g" | "b" | ...

LineStyle — ライン スタイル "-" (既定値) | "--" | ":" | "-." | "none"

LineWidth — ライン幅 0.5 (既定値) | 正の値

マーカー

Marker — マーカー記号 "none" (既定値) | "o" | "+" | "*" | "." | ...

MarkerSize — マーカー サイズ 6 (既定値) | 正の値

MarkerEdgeColor — マーカーの輪郭の色 "none" | RGB 3 成分 | 16 進数カラー コード | "r" | "g" | "b" | ...

MarkerFaceColor — マーカーの塗りつぶし色 "none" (既定値) | RGB 3 成分 | 16 進数カラー コード | "r" | "g" | "b" | ...

フォント

FontName — フォント名 サポートされているフォント名 | "FixedWidth"

FontSize — フォント サイズ 8 (既定値) | スカラー数値

ラベル

Title — 積み上げプロットのタイトル 文字ベクトル | string スカラー | 数値スカラー | string 配列 | 数値配列 | cell 配列 | categorical 配列

DisplayLabels — y 軸のラベル 文字ベクトルの cell 配列 | string 配列

XLabel — "x" 軸のラベル 文字ベクトル | string スカラー | 数値スカラー | string 配列 | 数値配列 | cell 配列 | categorical 配列

LegendLabels — 凡例の入力のラベル string 配列 | 文字ベクトルの cell 配列

LegendOrientation — 凡例のラベルの向き "horizontal" (既定値) | "vertical"

LegendVisible — 凡例の可視性 "on" | "off" | logical 値

位置

OuterPosition — 外側のサイズと位置 [0 0 1 1] (既定値) | 4 要素ベクトル

InnerPosition — 内側のサイズと位置 4 要素ベクトル

Position — 内側のサイズと位置 4 要素ベクトル

PositionConstraint — 一定に保つ位置 "outerposition" | "innerposition"

Units — 位置の単位 "normalized" (既定値) | "inches" | "centimeters" | "points" | "pixels" | "characters"

Layout — レイアウト オプション 空の LayoutOptions 配列 (既定値) | TiledChartLayoutOptions オブジェクト | GridLayoutOptions オブジェクト

対話機能

Visible — 可視性の状態 "on" (既定値) | on/off logical 値

親/子

Parent — 親コンテナー Figure オブジェクト | Panel オブジェクト | Tab オブジェクト | TiledChartLayout オブジェクト | GridLayout オブジェクト

HandleVisibility — オブジェクト ハンドルの可視性 "on" (既定値) | "off" | "callback"

バージョン履歴

R2020a: ActivePositionProperty は非推奨

参考

関数

プロパティ

トピック

テーブルデータ

`SourceTable` — ソース table
table | timetable | table の cell 配列 | timetable の cell 配列

`XData` — x 値
ベクトル

`YData` — y 値
配列

`DisplayVariables` — "y" 軸に表示される変数
string 配列 | 数値配列 | logical 配列 | cell 配列 | `vartype` 添字

`EventsVisible` — イベントの表示
`"on"` | `"off"` | on/off logical 値

`CombineMatchingNames` — 一致する名前をもつ変数を結合するためのフラグ
`true` または `1` (既定値) | `false` または `0`

`XVariable` — "x" 値を含む table 変数
string 配列 | 文字ベクトル | 文字ベクトルの cell 配列 | 整数配列 | logical 配列

`XLimits` — x 軸の範囲の上限と下限
`[min max]` の形式の 2 要素ベクトル

`AxesProperties` — y 軸のプロパティ
`StackedAxesProperties` オブジェクトの配列

`LineProperties` — ラインのプロパティ
`StackedLineProperties` オブジェクトの配列

`GridVisible` — グリッドラインの表示
`"on"` | `"off"` | on/off logical 値

`Color` — ラインの色
`[0 0.4470 0.7410]` (既定値) | RGB 3 成分 | 16 進数カラーコード | `"r"` | `"g"` | `"b"` | ...

`LineStyle` — ラインスタイル
`"-"` (既定値) | `"--"` | `":"` | `"-."` | `"none"`

`LineWidth` — ライン幅
`0.5` (既定値) | 正の値

`Marker` — マーカー記号
`"none"` (既定値) | `"o"` | `"+"` | `"*"` | `"."` | ...

`MarkerSize` — マーカーサイズ
`6` (既定値) | 正の値

`MarkerEdgeColor` — マーカーの輪郭の色
`"none"` | RGB 3 成分 | 16 進数カラーコード | `"r"` | `"g"` | `"b"` | ...

`MarkerFaceColor` — マーカーの塗りつぶし色
`"none"` (既定値) | RGB 3 成分 | 16 進数カラーコード | `"r"` | `"g"` | `"b"` | ...

`FontName` — フォント名
サポートされているフォント名 | `"FixedWidth"`

`FontSize` — フォントサイズ
`8` (既定値) | スカラー数値

`Title` — 積み上げプロットのタイトル
文字ベクトル | string スカラー | 数値スカラー | string 配列 | 数値配列 | cell 配列 | categorical 配列

`DisplayLabels` — y 軸のラベル
文字ベクトルの cell 配列 | string 配列

`XLabel` — "x" 軸のラベル
文字ベクトル | string スカラー | 数値スカラー | string 配列 | 数値配列 | cell 配列 | categorical 配列

`LegendLabels` — 凡例の入力のラベル
string 配列 | 文字ベクトルの cell 配列

`LegendOrientation` — 凡例のラベルの向き
`"horizontal"` (既定値) | `"vertical"`

`LegendVisible` — 凡例の可視性
`"on"` | `"off"` | logical 値

`OuterPosition` — 外側のサイズと位置
`[0 0 1 1]` (既定値) | 4 要素ベクトル

`InnerPosition` — 内側のサイズと位置
4 要素ベクトル

`Position` — 内側のサイズと位置
4 要素ベクトル

`PositionConstraint` — 一定に保つ位置
`"outerposition"` | `"innerposition"`

`Units` — 位置の単位
`"normalized"` (既定値) | `"inches"` | `"centimeters"` | `"points"` | `"pixels"` | `"characters"`

`Layout` — レイアウトオプション
空の `LayoutOptions` 配列 (既定値) | `TiledChartLayoutOptions` オブジェクト | `GridLayoutOptions` オブジェクト

`Visible` — 可視性の状態
`"on"` (既定値) | on/off logical 値

`Parent` — 親コンテナー
`Figure` オブジェクト | `Panel` オブジェクト | `Tab` オブジェクト | `TiledChartLayout` オブジェクト | `GridLayout` オブジェクト

`HandleVisibility` — オブジェクトハンドルの可視性
`"on"` (既定値) | `"off"` | `"callback"`

R2020a: `ActivePositionProperty` は非推奨