このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
Quiver のプロパティ
quiver グラフの外観と動作
Quiver
プロパティは、Quiver
オブジェクトの外観と動作を制御します。プロパティの値を変更することによって、quiver グラフの特定の要素を変更できます。プロパティのクエリと設定にはドット表記を使用します。
q = quiver(1:10,1:10); q.Color = 'red';
矢印
Alignment
— データ点を基準とした矢印の配置
"tail"
(既定値) | "center"
| "head"
データ点を基準とした矢印の配置。次の表のオプションのいずれかとして指定します。表内の図では、図解の目的でデータ点マーカーが示されています。既定では、マーカーは表示されません。
配置の値 | 説明 | 外観 |
---|---|---|
| 矢印の末尾がデータ点に配置されます。 |
|
| 矢印のシャフトの中心がデータ点に配置されます。 |
|
| 矢印の先頭がデータ点に配置されます。 |
|
ShowArrowHead
— 矢じりの表示
'on'
(既定値) | on/off logical 値
矢じりの表示。'on'
または 'off'
もしくは数値または logical 1
(true
) または 0
(false
) として指定します。'on'
の値は true
と等価であり、'off'
は false
と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState
型の on/off logical 値として格納されます。
'on'
— ベクトルを矢じり付きで表示します。'off'
— ベクトルを矢じりなしで表示します。
MaxHeadSize
— 矢じりの最大サイズ
0.2
(既定値) | スカラー
矢じりの最大サイズ。矢印の長さを単位基準としたスカラー値として指定します。
例: 0.1
データ型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
ScaleFactor
— 矢印のスケール係数
スカラー
R2024a 以降
この プロパティ は読み取り専用です。
矢印のスケール係数。スカラーとして返されます。この値は、MATLAB® でプロット内の矢印のスケーリングに使用されます。AutoScale
プロパティが "off"
の場合、このプロパティの値は 1
になります。
ScaleFactor
プロパティは、矢印と座標軸の他のグラフィックス オブジェクトの間のスケールを維持するのに便利です。たとえば、矢印の先頭にマーカーを配置できます。
% Plot three arrows x = [1 2 3]; y = [0 1.3 1]; u = [1.5 -2 1]; v = [1 1.5 3]; q = quiver(x,y,u,v); hold on % Place markers at the tips of the arrows xp = x + q.ScaleFactor*u; yp = y + q.ScaleFactor*v; scatter(xp,yp,"*r")
ScaleFactor
と AutoScaleFactor
の違い
quiver オブジェクトには、矢印の長さを決定するプロパティが 2 つあります。ScaleFactor
と AutoScaleFactor
です。AutoScaleFactor
の値は設定可能ですが、AutoScale
プロパティが "on"
に設定されている場合しか矢印の長さに影響しません。一方、ScaleFactor
の値は読み取り専用です。
プロパティ | 矢印の長さを決定する上での役割 |
---|---|
|
|
| 自動スケーリングや |
AutoScaleFactor
— 自動スケール係数
0.9
(既定値) | スカラー
自動スケール係数。スカラーとして指定します。自動スケール係数は、AutoScale
プロパティが "on"
の場合に矢印の大きさを調整する乗数です。たとえば、値が 2
の場合は矢印の長さが 2 倍になり、値が 0.5
の場合は矢印の長さが半分になります。
メモ
このプロパティは、
AutoScale
プロパティが"off"
に設定されている場合は効果はありません。AutoScaleFactor
プロパティを調整するとScaleFactor
プロパティが更新されます。
AutoScale
— 自動スケール係数を使用
'on'
(既定値) | on/off logical 値
自動スケール係数を使用して矢印の長さを調整します。'on'
または 'off'
もしくは数値または logical 1
(true
) または 0
(false
) として指定します。'on'
の値は true
と等価であり、'off'
は false
と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState
型の on/off logical 値として格納されます。
'on'
—AutoScaleFactor
の値を 2 番目の乗数として使用して、グリッドで定義された座標データ内に収まるように矢印の長さをスケーリングし、矢印がオーバーラップしないようにします。'off'
— 矢印の長さをスケーリングしません。
AlignVertexCenters
— 垂直および水平のラインのシャープ化
'off'
(既定値) | on/off logical 値
垂直および水平のラインのシャープ化。'on'
または 'off'
、もしくは数値または logical 1
(true
) または 0
(false
) として指定します。'on'
の値は true と等価であり、'off'
は false
と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState
型の on/off logical 値として格納されます。
値 | 説明 | 外観 |
---|---|---|
'on' | 垂直および水平のラインをシャープ化して不均一な外観を取り除きます。 |
|
'off' | 垂直および水平のラインをシャープ化しません。均一でない太さや色でラインが表示される場合があります。 |
|
関連付けられている Figure の GraphicsSmoothing
プロパティが 'on'
に設定されていて Renderer
プロパティが 'opengl'
に設定されている場合、Figure のプロットには平滑化技法が適用されます。場合によってはこの平滑化技法が原因で、垂直および水平のラインが均一でない太さや色で表示されることがあります。この不均一な外観を取り除くために AlignVertexCenters
プロパティを使用します。
メモ
この機能をサポートするグラフィックス カードがなければなりません。この機能がサポートされているかどうかを確認するには、関数 rendererinfo
を呼び出します。サポートされている場合、rendererinfo
は info.Details.SupportsAlignVertexCenters
に 1
の値を返します。
色とスタイル
Color
— 矢印の色
[0 0 1]
(既定値) | 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]
ColorMode
— Color
の設定方法を制御
"auto"
(既定値) | "manual"
Color
プロパティの設定方法を制御します。次のいずれかの値として指定します。
"auto"
— MATLAB がQuiver
オブジェクトのSeriesIndex
プロパティと座標軸のColorOrder
プロパティを使用して、Color
プロパティ値を制御します。"manual"
—Quiver
オブジェクトを作成するときに、Color
プロパティ値を直接設定するか、関数の引数として間接的に設定します。
Color
プロパティの値を手動で変更すると、MATLAB は ColorMode
プロパティの値を "manual"
に変更します。
LineStyle
— 矢印の軸のスタイル
"-"
(既定値) | "--"
| ":"
| "-."
| "none"
矢印の軸のスタイル。次の表に挙げるライン スタイルのいずれかとして指定します。
ライン スタイル | 説明 | 結果として得られる線 |
---|---|---|
"-" | 実線 |
|
"--" | 破線 |
|
":" | 点線 |
|
"-." | 一点鎖線 |
|
"none" | ラインなし | ラインなし |
LineStyleMode
— LineStyle
の設定方法を制御
"auto"
(既定値) | "manual"
LineStyle
プロパティの設定方法を制御します。次のいずれかの値として指定します。
"auto"
—Quiver
オブジェクトのSeriesIndex
プロパティと座標軸のLineStyleOrder
プロパティを使用することにより、MATLAB がLineStyle
プロパティ値を制御します。"manual"
—Quiver
オブジェクトを作成するときに、LineStyle
プロパティ値を直接設定するか、関数の引数として間接的に設定します。
LineStyle
プロパティの値を手動で変更すると、MATLAB は LineStyleMode
プロパティの値を "manual"
に変更します。
LineWidth
— 矢印の軸と矢じりの幅
0.5
(既定値) | スカラー数値
矢印の軸と矢じりの幅。ポイント単位の 0 より大きいスカラー数値として指定します。1 ポイントは 1/72
インチです。既定値は 0.5
ポイントです。
例: 0.75
SeriesIndex
— シリーズ インデックス
正の整数 (既定値) | "none"
シリーズ インデックス。正の整数または "none"
として指定します。このプロパティは、Quiver
オブジェクトの色、ライン スタイル、またはマーカーを他のオブジェクトと一致するよう再割り当てするのに役立ちます。
既定では、SeriesIndex
プロパティは Quiver
オブジェクトが作成された順番に対応する数値で、1
から始まります。MATLAB は、この数値を使用して、プロット関数を呼び出すときに色、ライン スタイル、またはマーカーを自動的に割り当てるためのインデックスを計算します。インデックスは座標軸の ColorOrder
プロパティと LineStyleOrder
プロパティに格納されている配列の行を参照します。同じ SeriesIndex
数値をもつ座標軸内のオブジェクトは同じ色 (および、該当する場合は同じライン スタイルとマーカー) ももちます。
SeriesIndex
の値が "none"
の場合は、インデックス方式に参加しない中間色の実線に対応します。
色、ライン スタイル、またはマーカーの手動設定が SeriesIndex
の動作をオーバーライドする方法
色、ライン スタイル、マーカーを手動で制御するには、Quiver
オブジェクトの Color
、LineStyle
、Marker
プロパティを設定します。
オブジェクトのこれらのプロパティを手動で設定すると、MATLAB はそのオブジェクトの色、ライン スタイル、マーカーの自動選択を無効にし、SeriesIndex
プロパティの値に関係なく選択を保持できるようにします。ColorMode
、LineStyleMode
、MarkerMode
プロパティは、色、ライン スタイル、マーカーが手動で (ユーザーにより) 設定されているか、自動的に設定されているかを示します。これらの各モード プロパティについて、値 "manual"
は手動選択を示し、値 "auto"
は自動選択を示します。
自動選択を再度有効にするには、ColorMode
、LineStyleMode
、MarkerMode
、または 3 つのプロパティすべてを "auto"
に設定し、SeriesIndex
プロパティを正の整数に設定します。
場合によっては、MATLAB は SeriesIndex
プロパティを 0
に設定し、自動選択も無効にします。
マーカー
Marker
— マーカー記号
"none"
(既定値) | "o"
| "+"
| "*"
| "."
| ...
マーカー記号。次の表に挙げる値のいずれかとして指定します。既定では、オブジェクトはマーカーを表示しません。マーカー記号を指定すると、各データ点または各頂点にマーカーが追加されます。
マーカー | 説明 | 結果のマーカー |
---|---|---|
"o" | 円 |
|
"+" | プラス記号 |
|
"*" | アスタリスク |
|
"." | 点 |
|
"x" | 十字 |
|
"_" | 水平線 |
|
"|" | 垂直線 |
|
"square" | 正方形 |
|
"diamond" | 菱形 |
|
"^" | 上向き三角形 |
|
"v" | 下向き三角形 |
|
">" | 右向き三角形 |
|
"<" | 左向き三角形 |
|
"pentagram" | 星形五角形 |
|
"hexagram" | 星形六角形 |
|
"none" | マーカーなし | 該当なし |
MarkerMode
— Marker
の設定方法を制御
"auto"
(既定値) | "manual"
Marker
プロパティの設定方法を制御します。次のいずれかの値として指定します。
"auto"
—Quiver
オブジェクトのSeriesIndex
プロパティと座標軸のLineStyleOrder
プロパティを使用することにより、MATLAB がオブジェクトのMarker
プロパティ値を制御します。"manual"
—Quiver
オブジェクトを作成するときに、Marker
プロパティ値を直接設定するか、関数の引数として間接的に設定します。
Marker
プロパティの値を手動で変更すると、MATLAB は MarkerMode
プロパティの値を "manual"
に変更します。
MarkerSize
— マーカー サイズ
6
(既定値) | 正の値
マーカー サイズ。ポイント単位の正の値として指定します。1 ポイントは 1/72 インチです。
MarkerEdgeColor
— マーカーの輪郭の色
"auto"
(既定値) | RGB 3 成分 | 16 進数カラー コード | "r"
| "g"
| "b"
| ...
マーカーの輪郭の色。"auto"
、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。既定値 "auto"
では、Color
プロパティと同じ色が使用されます。
カスタム色を使用する場合は、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" |
MarkerFaceColor
— マーカーの塗りつぶし色
"none"
(既定値) | "auto"
| RGB 3 成分 | 16 進数カラー コード | "r"
| "g"
| "b"
| ...
マーカーの塗りつぶし色。"auto"
、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。"auto"
オプションは親座標軸の Color
プロパティと同じ色を使用します。"auto"
を指定し、座標軸のプロット ボックスが非表示の場合、マーカーの塗りつぶし色は Figure の色です。
カスタム色を使用する場合は、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" |
データ
UData
— ベクトルの x 方向の長さ
ベクトル | 行列
ベクトルの x 方向の長さ。ベクトルまたは行列として指定します。プロパティ UData
、VData
、WData
の組み合わせで、quiver グラフに矢印として表示されるベクトルの成分を指定します。
例: 1:10
UDataSource
— UData
にリンクされている変数
''
(既定値) | 文字ベクトル | string
UData
にリンクされている変数。MATLAB ワークスペースの変数名を含む文字ベクトルまたは string として指定します。MATLAB はベース ワークスペース内の変数を評価して UData
を生成します。
既定ではリンクされている変数はないため、この値は空の文字ベクトル ''
です。変数をリンクしても MATLAB は UData
の値をすぐに更新しません。データ値の更新を強制するには、関数 refreshdata
を使用します。
メモ
1 つのデータ ソース プロパティを異なる次元のデータを含む変数に変更すると、すべてのデータ ソース プロパティを適切な値に変更するまでは、関数が警告を生成し、グラフが描画されない可能性があります。
VData
— ベクトルの y 方向の長さ
ベクトル | 行列
ベクトルの y 方向の長さ。ベクトルまたは行列として指定します。プロパティ UData
、VData
、WData
の組み合わせで、quiver グラフに矢印として表示されるベクトルの成分を指定します。
例: 1:10
VDataSource
— VData
にリンクされている変数
''
(既定値) | 文字ベクトル | string
VData
にリンクされている変数。MATLAB ワークスペースの変数名を含む文字ベクトルまたは string として指定します。MATLAB はベース ワークスペース内の変数を評価して VData
を生成します。
既定ではリンクされている変数がないため、この値は文字ベクトル ''
です。変数をリンクしても MATLAB は VData
の値をすぐに更新しません。データ値の更新を強制するには、関数 refreshdata
を使用します。
メモ
1 つのデータ ソース プロパティを異なる次元のデータを含む変数に変更すると、すべてのデータ ソース プロパティを適切な値に変更するまでは、関数が警告を生成し、グラフが描画されない可能性があります。
WData
— ベクトルの z 方向の長さ
ベクトル | 行列
ベクトルの z 方向の長さ。ベクトルまたは行列として指定します。プロパティ UData
、VData
、WData
の組み合わせで、quiver グラフに矢印として表示されるベクトルの成分を指定します。2 次元の quiver グラフの場合、WData
は空の配列になります。
例: 1:10
WDataSource
— WData
にリンクされている変数
''
(既定値) | 文字ベクトル | string
WData
にリンクされている変数。MATLAB ワークスペースの変数名を含む文字ベクトルまたは string として指定します。MATLAB はベース ワークスペース内の変数を評価して WData
を生成します。
既定ではリンクされている変数はないため、この値は空の文字ベクトル ''
です。変数をリンクしても MATLAB は WData
の値をすぐに更新しません。データ値の更新を強制するには、関数 refreshdata
を使用します。
メモ
1 つのデータ ソース プロパティを異なる次元のデータを含む変数に変更すると、すべてのデータ ソース プロパティを適切な値に変更するまでは、関数が警告を生成し、グラフが描画されない可能性があります。
XData
— x 座標
ベクトル | 行列
x 座標。ベクトルまたは行列として指定します。x 座標は、関数 quiver
の入力引数 X
に基づきます。X
を指定しない場合、quiver
は UData
のインデックスを x 座標として使用します。XData
のサイズは YData
と等しくなければなりません。
このプロパティを設定すると、対応するモード プロパティが manual モードに設定されます。
例: 1:10
XDataMode
— XData
の選択モード
'auto'
| 'manual'
XData
の選択モード。次の値のいずれかとして指定します。
'auto'
— 値を自動で選択します。'manual'
— 手動で指定した値を使用します。値を設定するには、XData
プロパティを設定するか関数の入力引数X
を使用します。
XDataSource
— XData
にリンクされている変数
''
(既定値) | 文字ベクトル | string
XData
にリンクされている変数。MATLAB ワークスペースの変数名を含む文字ベクトルまたは string として指定します。MATLAB はベース ワークスペース内の変数を評価して XData
を生成します。
既定ではリンクされている変数はないため、この値は空の文字ベクトル ''
です。変数をリンクしても MATLAB は XData
の値をすぐに更新しません。データ値の更新を強制するには、関数 refreshdata
を使用します。
メモ
1 つのデータ ソース プロパティを異なる次元のデータを含む変数に変更すると、すべてのデータ ソース プロパティを適切な値に変更するまでは、関数が警告を生成し、グラフが描画されない可能性があります。
例: 'x'
YData
— y 座標
ベクトル | 行列
y 座標。ベクトルまたは行列として指定します。y 座標は、関数 quiver
の入力引数 Y
に基づきます。Y
を指定しない場合、quiver
は VData
のインデックスを y 座標として使用します。YData
のサイズは XData
と等しくなければなりません。
このプロパティを設定すると、対応するモード プロパティが manual モードに設定されます。
例: 1:10
YDataMode
— YData
の選択モード
'auto'
| 'manual'
YData
の選択モード。次の値のいずれかとして指定します。
'auto'
— 値を自動で選択します。'manual'
— 手動で指定した値を使用します。値を設定するには、YData
プロパティを設定するか関数の入力引数Y
を使用します。
YDataSource
— YData
にリンクされている変数
''
(既定値) | 文字ベクトル | string
YData
にリンクされている変数。MATLAB ワークスペースの変数名を含む文字ベクトルまたは string として指定します。MATLAB はベース ワークスペース内の変数を評価して YData
を生成します。
既定ではリンクされている変数はないため、この値は空の文字ベクトル ''
です。変数をリンクしても MATLAB は YData
の値をすぐに更新しません。データ値の更新を強制するには、関数 refreshdata
を使用します。
メモ
1 つのデータ ソース プロパティを異なる次元のデータを含む変数に変更すると、すべてのデータ ソース プロパティを適切な値に変更するまでは、関数が警告を生成し、グラフが描画されない可能性があります。
例: 'y'
ZData
— z 座標
ベクトル | 行列
z 座標。ベクトルまたは行列として指定します。z 座標は、関数 quiver3
の入力引数 Z
に基づきます。2 次元の quiver グラフの場合、ZData
は空の配列になります。3 次元の quiver グラフの場合、ZData
のサイズは XData
および YData
と等しくなければなりません。
例: 1:10
ZDataSource
— ZData
にリンクされている変数
''
(既定値) | 文字ベクトル | string
ZData
にリンクされている変数。MATLAB ワークスペースの変数名を含む文字ベクトルまたは string として指定します。MATLAB はベース ワークスペース内の変数を評価して ZData
を生成します。
既定ではリンクされている変数はないため、この値は空の文字ベクトル ''
です。変数をリンクしても MATLAB は ZData
の値をすぐに更新しません。データ値の更新を強制するには、関数 refreshdata
を使用します。
メモ
1 つのデータ ソース プロパティを異なる次元のデータを含む変数に変更すると、すべてのデータ ソース プロパティを適切な値に変更するまでは、関数が警告を生成し、グラフが描画されない可能性があります。
例: 'z'
凡例
DisplayName
— 凡例ラベル
''
(既定値) | 文字ベクトル | string スカラー
凡例ラベル。文字ベクトルまたは string スカラーとして指定します。legend
コマンドを呼び出すまで、凡例は表示されません。テキストを指定しない場合、legend
は 'dataN'
形式を使用してラベルを設定します。
Annotation
— 凡例にオブジェクトを含める
Annotation
オブジェクト
凡例にオブジェクトを含めるかどうか。Annotation
オブジェクトとして指定します。Annotation
オブジェクトの基となる IconDisplayStyle
プロパティを次のいずれかの値に設定します。
"on"
— 凡例にオブジェクトを含めます (既定)。"off"
— 凡例にオブジェクトを含めません。
たとえば、obj
という Quiver
オブジェクトを凡例から除外するには、IconDisplayStyle
プロパティを "off"
に設定します。
obj.Annotation.LegendInformation.IconDisplayStyle = "off";
あるいは、関数 legend
を使用して、凡例内の項目を制御することもできます。最初の入力引数を、含めるグラフィックス オブジェクトのベクトルとして指定します。最初の入力引数に既存のグラフィックス オブジェクトを指定しない場合、それは凡例に表示されません。ただし、凡例が作成された後に座標軸に追加されたグラフィックス オブジェクトは凡例には表示されません。追加の項目を避けるには、すべてのプロットを作成した後に凡例を作成することを考慮してください。
対話機能
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"
— オブジェクトを削除せずに非表示にします。非表示のオブジェクトのプロパティには引き続きアクセスできます。
DataTipTemplate
— データ ヒントの内容
DataTipTemplate
オブジェクト
データ ヒントの内容。DataTipTemplate
オブジェクトとして指定します。基となる DataTipTemplate
オブジェクトのプロパティを変更することにより、データ ヒントに表示される内容を制御できます。プロパティの一覧については、DataTipTemplate のプロパティ を参照してください。
データ ヒントの変更の例については、カスタム データ ヒントの作成を参照してください。
メモ
DataTipTemplate
オブジェクトは findobj
または findall
によって返されず、copyobj
によってコピーされません。
ContextMenu
— コンテキスト メニュー
空の GraphicsPlaceholder
配列 (既定値) | ContextMenu
オブジェクト
コンテキスト メニュー。ContextMenu
オブジェクトとして指定します。このプロパティは、オブジェクトを右クリックしたときにコンテキスト メニューを表示するために使用します。関数 uicontextmenu
を使用して、コンテキスト メニューを作成します。
メモ
PickableParts
プロパティが 'none'
に設定されている場合または HitTest
プロパティが 'off'
に設定されている場合には、このコンテキスト メニューは表示されません。
Selected
— 選択状態
'off'
(既定値) | on/off logical 値
選択状態。'on'
または 'off'
、もしくは数値または logical 1
(true
) または 0
(false
) として指定します。'on'
の値は true と等価であり、'off'
は false
と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState
型の on/off logical 値として格納されます。
'on'
— 選択されています。プロット編集モードでオブジェクトをクリックした場合、MATLAB はSelected
プロパティを'on'
に設定します。SelectionHighlight
プロパティも'on'
に設定されている場合、MATLAB はオブジェクトの周囲に選択ハンドルを表示します。'off'
— 選択されていません。
SelectionHighlight
— 選択ハンドルの表示
'on'
(既定値) | on/off logical 値
選択時の選択ハンドルの表示。'on'
または 'off'
、もしくは数値または logical 1
(true
) または 0
(false
) として指定します。'on'
の値は true と等価であり、'off'
は false
と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState
型の on/off logical 値として格納されます。
'on'
—Selected
プロパティが'on'
に設定されているときに選択ハンドルを表示します。'off'
—Selected
プロパティが'on'
に設定されている場合でも選択ハンドルを表示しません。
Clipping
— 座標軸の範囲でのオブジェクトのクリップ
'on'
(既定値) | on/off logical 値
座標軸の範囲でのオブジェクトのクリップ。'on'
または 'off'
、もしくは数値または logical 1
(true
) または 0
(false
) として指定します。'on'
の値は true と等価であり、'off'
は false
と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState
型の on/off logical 値として格納されます。
'on'
の値は座標軸の範囲外になるオブジェクトの部分をクリップします。'off'
の値は座標軸の範囲外に表示される部分があってもオブジェクト全体を表示します。プロットの作成、hold on
の設定、座標軸のスケーリングの固定を行ってから、元のプロットよりも大きくなるようにオブジェクトを作成した場合、オブジェクトの一部が座標軸の範囲の外に表示されることがあります。
オブジェクトを含む座標軸の Clipping
プロパティは 'on'
に設定しなければなりません。そうしない場合、このプロパティの効果はありません。クリップ動作の詳細については、座標軸の Clipping
プロパティを参照してください。
コールバック
ButtonDownFcn
— マウスクリック コールバック
''
(既定値) | 関数ハンドル | cell 配列 | 文字ベクトル
マウスクリック コールバック。次の値のいずれかとして指定します。
関数ハンドル
関数ハンドルと追加の引数を含む cell 配列
ベース ワークスペース内で評価される有効な MATLAB コマンドまたは MATLAB 関数の文字ベクトル (非推奨)
このプロパティは、オブジェクトをクリックしたときにコードを実行するために使用します。関数ハンドルを使用してこのプロパティを指定した場合、MATLAB はコールバックを実行するときに次の 2 つの引数をコールバック関数に渡します。
クリックしたオブジェクト — コールバック関数内から、クリックしたオブジェクトのプロパティにアクセスします。
イベント データ — 空の引数です。この引数が使用されないことを示すために、関数定義の中でこの引数をチルダ文字 (
~
) に置換します。
関数ハンドルを使用してコールバック関数を定義する方法についての詳細は、グラフィックス オブジェクトのコールバックの作成を参照してください。
メモ
PickableParts
プロパティが 'none'
に設定されている場合または HitTest
プロパティが 'off'
に設定されている場合には、このコールバックは実行されません。
CreateFcn
— 作成関数
''
(既定値) | 関数ハンドル | cell 配列 | 文字ベクトル
オブジェクト作成関数。次の値のいずれかとして指定します。
関数ハンドル。
最初の要素が関数ハンドルである cell 配列。cell 配列内のその後の要素はコールバック関数に渡される引数です。
有効な MATLAB 式を含む文字ベクトル (非推奨)。MATLAB は、この式をベース ワークスペースで評価します。
コールバックを関数ハンドル、cell 配列、または文字ベクトルとして指定する方法の詳細については、グラフィックス オブジェクトのコールバックの作成を参照してください。
このプロパティは、MATLAB がオブジェクトを作成するときに実行されるコールバック関数を指定します。MATLAB は CreateFcn
コールバックを実行する前に、すべてのプロパティ値を初期化します。CreateFcn
プロパティを指定しない場合、MATLAB は既定の作成関数を実行します。
既存のコンポーネントに CreateFcn
プロパティを設定しても効果はありません。
このプロパティを関数ハンドルまたは cell 配列として指定した場合、コールバック関数の最初の引数を使用して、作成中のオブジェクトにアクセスできます。それ以外の場合は、関数 gcbo
を使用してオブジェクトにアクセスします。
DeleteFcn
— 削除関数
''
(既定値) | 関数ハンドル | cell 配列 | 文字ベクトル
オブジェクト削除関数。次の値のいずれかとして指定します。
関数ハンドル。
最初の要素が関数ハンドルである cell 配列。cell 配列内のその後の要素はコールバック関数に渡される引数です。
有効な MATLAB 式を含む文字ベクトル (非推奨)。MATLAB は、この式をベース ワークスペースで評価します。
コールバックを関数ハンドル、cell 配列、または文字ベクトルとして指定する方法の詳細については、グラフィックス オブジェクトのコールバックの作成を参照してください。
このプロパティは、MATLAB がオブジェクトを削除するときに実行されるコールバック関数を指定します。MATLAB は、オブジェクトのプロパティを破棄する前に DeleteFcn
コールバックを実行します。DeleteFcn
プロパティを指定しない場合、MATLAB は既定の削除関数を実行します。
このプロパティを関数ハンドルまたは cell 配列として指定した場合、コールバック関数の最初の引数を使用して、削除されるオブジェクトにアクセスできます。それ以外の場合は、関数 gcbo
を使用してオブジェクトにアクセスします。
コールバック実行制御
Interruptible
— コールバックの割り込み
'on'
(既定値) | on/off logical 値
コールバックの割り込み。'on'
または 'off'
、もしくは数値または logical 1
(true
) または 0
(false
) として指定します。'on'
の値は true
と等価であり、'off'
は false
と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState
型の on/off logical 値として格納されます。
このプロパティは実行中のコールバックが割り込み可能かどうかを決定します。次の 2 つのコールバックの状態について考慮する必要があります。
"実行中" コールバックは、現在実行しているコールバックです。
"割り込み" コールバックは、実行中のコールバックに割り込もうとするコールバックです。
MATLAB は、コールバック キューを処理するコマンドを実行するたびにコールバックの割り込み動作を判別します。これらのコマンドには、drawnow
、figure
、uifigure
、getframe
、waitfor
、pause
があります。
実行中コールバックにこれらのコマンドが含まれていない場合、割り込みは発生しません。MATLAB は、実行中コールバックの実行を先に終了させ、その後に割り込みコールバックを実行します。
実行中コールバックにこれらのいずれかのコマンドが含まれている場合、実行中コールバックを所有するオブジェクトの Interruptible
プロパティに応じて割り込みが発生するかどうかが決まります。
Interruptible
の値が'off'
の場合、割り込みは発生しません。代わりに、割り込みコールバックを所有するオブジェクトのBusyAction
プロパティに応じて、割り込みコールバックが破棄されるかコールバック キューに追加されるかが決まります。Interruptible
の値が'on'
の場合、割り込みが発生します。MATLAB は、コールバック キューの次回処理時に、実行中コールバックの実行を停止し、割り込みコールバックを実行します。割り込みコールバックが完了した後、MATLAB は実行中だったコールバックの実行を再開します。
メモ
コールバックの割り込みと実行は、以下の状況では動作が異なります。
割り込みコールバックが
DeleteFcn
、CloseRequestFcn
またはSizeChangedFcn
コールバックの場合、Interruptible
プロパティの値にかかわらず割り込みが発生します。実行中のコールバックが関数
waitfor
を現在実行している場合、Interruptible
プロパティの値にかかわらず割り込みが発生します。割り込みコールバックが
Timer
オブジェクトで所有されている場合、Interruptible
プロパティの値にかかわらずスケジュールに従ってコールバックが実行されます。
BusyAction
— コールバック キューイング
'queue'
(既定値) | 'cancel'
コールバック キューイング。'queue'
または 'cancel'
として指定します。BusyAction
プロパティは MATLAB による割り込みコールバックの実行の処理方法を決定します。次の 2 つのコールバックの状態について考慮する必要があります。
"実行中" コールバックは、現在実行しているコールバックです。
"割り込み" コールバックは、実行中のコールバックに割り込もうとするコールバックです。
BusyAction
プロパティによってコールバック キューイングの動作が決まるのは、次の両方の条件を満たす場合のみです。
これらの条件に当てはまる場合、割り込みコールバックを所有するオブジェクトの BusyAction
プロパティに応じて MATLAB による割り込みコールバックの処理方法が決まります。BusyAction
プロパティは次の値を取ることができます。
'queue'
— 割り込みコールバックをキューに入れ、実行中のコールバックが終了した後に処理されるようにします。'cancel'
— 割り込みコールバックを実行しません。
PickableParts
— マウス クリック キャプチャ機能
'visible'
(既定値) | 'none'
マウス クリック キャプチャ機能。次の値の 1 つとして指定します。
'visible'
— 表示されている場合にマウス クリックをキャプチャします。Visible
プロパティが'on'
に設定されていなければならず、Quiver
オブジェクトの色が定義されている部分をクリックしなければなりません。関連付けられている色のプロパティが'none'
に設定されている部分をクリックすることはできません。プロットにマーカーが含まれている場合は、エッジまたは塗りつぶしのいずれかに色が定義されている場合にマーカー全体がクリック可能になります。Quiver
オブジェクトがクリックに応答するか、先祖がクリックに応答するかは、HitTest
プロパティが決定します。'none'
— マウス クリックをキャプチャしません。Quiver
オブジェクトをクリックすると、Figure ウィンドウの現在のビュー内でその下にあるオブジェクトにクリックが渡されます。Quiver
オブジェクトのHitTest
プロパティの効果はありません。
HitTest
— キャプチャしたマウス クリックへの応答
'on'
(既定値) | on/off logical 値
キャプチャしたマウス クリックへの応答。'on'
または 'off'
、もしくは数値または logical 1
(true
) または 0
(false
) として指定します。'on'
の値は true と等価であり、'off'
は false
と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState
型の on/off logical 値として格納されます。
'on'
—Quiver
オブジェクトのButtonDownFcn
コールバックをトリガーします。ContextMenu
プロパティが定義されている場合は、コンテキスト メニューを呼び出します。'off'
—Quiver
オブジェクトの先祖のうち、次のいずれかの条件を満たす最も近い先祖のコールバックをトリガーします。HitTest
プロパティが'on'
に設定されているPickableParts
プロパティが、先祖によるマウス クリックのキャプチャを有効にする値に設定されている
メモ
PickableParts
プロパティは、Quiver
オブジェクトがマウス クリックをキャプチャできるかどうかを決定します。キャプチャできない場合、HitTest
プロパティは無効です。
BeingDeleted
— 削除状態
on/off logical 値
この プロパティ は読み取り専用です。
削除状態。matlab.lang.OnOffSwitchState
型の on/off logical 値として返されます。
MATLAB は、DeleteFcn
コールバックが実行を開始すると、BeingDeleted
プロパティを 'on'
に設定します。コンポーネント オブジェクトが存在しなくなるまで BeingDeleted
プロパティは 'on'
に設定されたままです。
クエリや変更の前にオブジェクトが削除されようとしていないか確認するために BeingDeleted
プロパティの値をチェックします。
親/子
Parent
— 親
Axes
オブジェクト | Group
オブジェクト | Transform
オブジェクト
親。Axes
、Group
または Transform
オブジェクトとして指定します。
Children
— 子
空の GraphicsPlaceholder
配列 | DataTip
オブジェクト配列
子。空の GraphicsPlaceholder
配列、または DataTip
オブジェクト配列として返されます。このプロパティを使用して、チャートにプロットされるデータ ヒントのリストを表示します。
Children
プロパティを使用して子の追加や削除を行うことはできません。このリストに子を追加するには、DataTip
オブジェクトの Parent
プロパティをチャート オブジェクトに設定します。
HandleVisibility
— オブジェクト ハンドルの可視性
"on"
(既定値) | "off"
| "callback"
親の Children
プロパティ内でのオブジェクト ハンドルの可視性。次の値のいずれかとして指定します。
"on"
— オブジェクト ハンドルは常に表示されます。"off"
— オブジェクト ハンドルは常に非表示です。このオプションは、他の関数による意図しない変更を防止するために役立ちます。HandleVisibility
を"off"
に設定すると、その関数の実行中にハンドルが一時的に非表示になります。"callback"
— オブジェクト ハンドルはコールバック内から、あるいはコールバックにより呼び出される関数から参照できます。しかし、コマンド ラインから呼び出される関数からは参照できません。このオプションを使用すると、コマンド ラインからのオブジェクトへのアクセスがブロックされますが、コールバック関数からのアクセスは許可されます。
オブジェクトが親の Children
プロパティ内にリストされない場合、オブジェクト階層の検索またはハンドル プロパティのクエリによってオブジェクト ハンドルを取得する関数は、そのオブジェクト ハンドルを返しません。こうした関数の例としては、関数 get
、findobj
、gca
、gcf
、gco
、newplot
、cla
、clf
、および close
などが挙げられます。
非表示のオブジェクト ハンドルは有効なままです。ルートの ShowHiddenHandles
プロパティを "on"
に設定すると、HandleVisibility
プロパティの設定にかかわらず、すべてのオブジェクト ハンドルがリストされます。
識別子
Type
— グラフィックス オブジェクトのタイプ
'quiver'
この プロパティ は読み取り専用です。
グラフィックス オブジェクトのタイプ。'quiver'
として返されます。プロット階層内にある特定のタイプのすべてのオブジェクトを検出するためにこのプロパティを使用できます。たとえば findobj
を使用してタイプを検索します。
Tag
— オブジェクト識別子
''
(既定値) | 文字ベクトル | string スカラー
オブジェクト識別子。文字ベクトルまたは string スカラーとして指定します。オブジェクトの識別子として機能する一意の Tag
値を指定できます。コードの他の部分からオブジェクトにアクセスする必要がある場合、関数 findobj
を使用して Tag
値に基づいてオブジェクトを検索できます。
UserData
— ユーザー データ
[]
(既定値) | 配列
ユーザー データ。任意の MATLAB 配列として指定します。たとえば、スカラー、ベクトル、行列、cell 配列、文字配列、table、または構造体を指定できます。このプロパティを使用して、任意のデータをオブジェクトに保存します。
App Designer を使用している場合は、UserData
プロパティを使用する代わりに、アプリでパブリック プロパティまたはプライベート プロパティを作成してデータを共有します。詳細については、App Designer アプリ内でのデータの共有を参照してください。
バージョン履歴
R2006a より前に導入R2024a: ScaleFactor
プロパティを使用した矢印の長さの計算
矢印の長さのスケーリングに MATLAB で使用される値にアクセスするには、矢印プロットの ScaleFactor
プロパティをクエリします。
R2023b: SeriesIndex="none"
を使用した色とライン スタイルの自動選択のオプトアウト
SeriesIndex
プロパティを "none"
に設定して、Quiver
オブジェクトの色とライン スタイルの自動選択をオプトアウトします。"none"
を指定すると、Quiver
オブジェクトはマーカーなしの実線のライン スタイルと中間色をもちます。
自動選択を再度有効にするには、SeriesIndex
プロパティを正の整数に設定します。
R2022a: Alignment
プロパティを使用した矢印とデータ点の配置の制御
Quiver
オブジェクトの Alignment
プロパティを設定して、矢印をデータ点に対してどのように配置するかを制御します。
R2020a: SeriesIndex
プロパティによる色とライン スタイルの自動選択の制御
Quiver
オブジェクトの SeriesIndex
プロパティを設定し、オブジェクトの色、ライン スタイル、マーカー記号がどのように変化するかを制御します。このプロパティの値を変更することは、座標軸内の異なるオブジェクトの色、ライン スタイル、マーカーを一致させる場合に便利です。
R2020a: UIContextMenu
プロパティは非推奨
UIContextMenu
プロパティの設定や取得は推奨されていません。代わりに、ContextMenu
プロパティを使用してください。これは、UIContextMenu
プロパティと同じタイプの入力を受け入れ、同じように動作します。
UIContextMenu
プロパティを削除する予定はありませんが、関数 set
、get
、または properties
を Quiver
オブジェクトで呼び出す際にリストされなくなりました。
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)