主要内容

このページの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。

行のプロパティ

チャートラインの外観と動作

プロパティは,オブジェクトの外観と動作を制御します。プロパティの値を変更することによって、線グラフの一部の特性を変更できます。プロパティのクエリと設定にはドット表記を使用します。

p =情节(1:10);c = p.Color;p.Color =“红色”;

すべて展開する

ラインの色。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進数が続く文字ベクトルまたは字符串スカラーです。これらの値では大文字小文字は区別されません。したがって,カラーコード“# FF8800”“# ff8800”“# F80”,および“# f80”は等価です。

あるいは,名前を使用して一部の一般的な色を指定できます。次の表に,名前の付いた色オプション,等価のRGB 3成分,および16進数カラーコードを示します。

色名 省略名 RGB 3成分 16進数カラーコード 外観
“红色” “r” (1 0 0) “# FF0000”

“绿色” ‘g’ (0 1 0) “# 00 ff00”

“蓝” “b” (0 0 1) “# 0000 ff”

“青色” “c” (0 1 1) “# 00飞行符”

“红色” “米” (1 0 1) “#就”

“黄色” “y” (1 1 0) “# FFFF00”

“黑” “k” (0 0 0) # 000000的

“白色” ' w ' (1 1 1) “# FFFFFF”

“没有” 該当なし 該当なし 該当なし 色なし

MATLAB®の多くのタイプのプロットで使用されている既定の色のRGB 3成分および16進数カラーコードを次に示します。

RGB 3成分 16進数カラーコード 外観
[0 0.4470 - 0.7410) “# 0072 bd”

(0.8500 0.3250 0.0980) “# D95319”

(0.9290 0.6940 0.1250) “# EDB120”

(0.4940 0.1840 0.5560) “# 7 e2f8e”

(0.4660 0.6740 0.1880) “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

(0.6350 0.0780 0.1840) “# A2142F”

例:“蓝”

例:(0 0 1)

例:“# 0000 ff”

颜色プロパティの設定方法を制御します。次のいずれかの値として指定します。

  • “汽车”——座標軸のColorOrderプロパティから色を選択することにより,MATLABが颜色プロパティ値を制御します。

  • “手动”——ユーザーがオブジェクトの颜色プロパティの値を直接設定するか,プロット関数を呼び出すときにLineSpec引数に色を含めることにより,颜色プロパティの値を手動で制御します。

颜色プロパティの値を手動で変更すると,MATLABはColorModeプロパティの値を“手动”に変更します。

ラインスタイル。次の表にリストされたオプションのいずれかとして指定します。

ラインスタイル 説明 結果として得られる線
“- - -” 実線

“——” 破線

“:” 点線

“-”。 一点鎖線

“没有” ラインなし ラインなし

线型プロパティの設定方法を制御します。次のいずれかの値として指定します。

  • “汽车”——MATLABが座標軸のLineStyleOrderプロパティからラインスタイルを選択することにより,线型プロパティ値を制御します。

  • “手动”——ユーザーがオブジェクトの线型プロパティの値を直接設定するか,プロット関数を呼び出すときにLineSpec引数を指定することにより,线型プロパティの値を手動で制御します。

线型プロパティの値を手動で変更すると,MATLABはLineStyleModeプロパティの値を“手动”に変更します。

ライン幅。ポイント単位の正の値として指定します。1ポイントは1/72インチです。ラインがマーカーをもつ場合,ライン幅はマーカーエッジにも影響します。

ライン幅をピクセルの幅より細くすることはできません。システムでライン幅をピクセルの幅より細い値に設定すると,ラインは1ピクセル幅で表示されます。

シリーズインデックス。0または正の整数として指定します。このプロパティは,いくつかのオブジェクトの色,ラインスタイル,またはマーカーを,互いに一致するよう再割り当てするのに役立ちます。既定では,オブジェクトのSeriesIndexプロパティは,1から始まる,作成順に対応する数値です。

MATLABはこの数値を使用して,プロット関数を呼び出すときに,色,ラインスタイル,またはマーカーを割り当てるインデックスを計算します。インデックスは座標軸のColorOrderプロパティとLineStyleOrderプロパティに格納されている配列の行を参照します。

MATLABは,そのSeriesIndexを変更するか,座標軸のColorOrderプロパティまたはLineStyleOrderプロパティを変更する際に,オブジェクトの色,ラインスタイル,またはマーカーを自動的に更新します。ただし,変更が有効になるには,以下の条件に該当しなければなりません。

  • オブジェクトのColorModeLineStyleMode,またはMarkerModeプロパティの少なくとも1つが“汽车”に設定されている。

  • オブジェクトのSeriesIndexプロパティが0より大きい。

  • 轴オブジェクトのNextSeriesIndexプロパティが0より大きい。

ラインの角のスタイル。“圆”“斜”“倒角”のいずれかに指定します。次の表に,各値によって指定される外観を示します。

“圆” “斜” “倒角”

图の渲染器プロパティが“画家”ではなくopengl的に設定されている場合,“圆”オプションの外観は異なる場合があります。

垂直および水平のラインのシャープ化。“上”または“关闭”,もしくは数値または逻辑1真正的)または0)として指定します。“上”の値は真正と等価であり,“关闭”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の开/关逻辑値として格納されます。

  • “上”——垂直および水平のラインをシャープ化して不均一な外観を取り除きます。

  • “关闭”——垂直または水平のラインをシャープ化しません。均一でない太さや色でラインが表示される場合があります。

関連付けられている图のGraphicsSmoothingプロパティが“上”に設定されていて渲染器プロパティがopengl的に設定されている場合,图のプロットには平滑化技法が適用されます。場合によってはこの平滑化技法が原因で,垂直および水平のラインが均一でない太さや色で表示されることがあります。この不均一な外観を取り除くためにAlignVertexCentersプロパティを使用します。

メモ

この機能をサポートするグラフィックスカードがなければなりません。この機能がサポートされているかどうかを確認するには,関数rendererinfoを呼び出します。サポートされている場合、rendererinfoinfo.Details.金宝appSupportsAlignVertexCenters1の値を返します。

マーカー

すべて展開する

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

説明
“o”
“+” プラス記号
‘*’ アスタリスク
“。”
“x” 十字
“_” 水平線
“|” 垂直線
“广场”または“年代” 正方形
“钻石”または' d ' 菱形
“^” 上向き三角形
“v” 下向き三角形
“>” 右向き三角形
“<” 左向き三角形
五角星形的または“p” 星形五角形
“卦”または“h” 星形六角形
“没有” マーカーなし

标记プロパティの設定方法を制御します。次のいずれかの値として指定します。

  • “汽车”——MATLABがオブジェクトの标记プロパティ値を制御します。

  • “手动”——ユーザーがオブジェクトの标记プロパティの値を直接設定するか,プロット関数を呼び出すときにLineSpec引数にマーカーを含めることにより,标记プロパティの値を手動で制御します。

标记プロパティの値を手動で変更すると,MATLABはMarkerModeプロパティの値を“手动”に変更します。

マーカーを表示するデータ点のインデックス。正の整数のベクトルとして指定します。インデックスを指定しない場合,MATLABはすべてのデータ点でマーカーを表示します。

メモ

マーカーを表示するには,マーカー記号も指定しなければなりません。

例:情节(x, y,“o”,“MarkerIndices”,[1 5 10])は1番目5番目、10番目のデータ点に円形のマーカーを表示します。

例:情节(x, y,‘- x’,‘MarkerIndices’,1:3:长度(y))は3つのデータ点ごとにX印のマーカーを表示します。

例:情节(x, y,“标记”,“广场”,“MarkerIndices”,5)は5番目のデータ点に1つの四角形のマーカーを表示します。

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

マーカーの輪郭の色。“汽车”RGB 3成分,16進数カラーコード,色名,または省略名として指定します。既定値の“汽车”は,颜色プロパティと同じ色を使用します。

カスタム色を使用する場合は,RGB 3成分または16進数カラーコードを指定します。

  • RGB 3成分は,色の赤,緑,青成分の強度を指定する3成分の行ベクトルです。強度値は[0, 1]の範囲でなければなりません。たとえば(0.4 0.6 0.7)のようになります。

  • 16進数カラーコードは,ハッシュ記号()で始まり3桁または6桁の0からFまでの範囲の16進数が続く文字ベクトルまたは字符串スカラーです。これらの値では大文字小文字は区別されません。したがって,カラーコード“# FF8800”“# ff8800”“# F80”,および“# f80”は等価です。

あるいは,名前を使用して一部の一般的な色を指定できます。次の表に,名前の付いた色オプション,等価のRGB 3成分,および16進数カラーコードを示します。

色名 省略名 RGB 3成分 16進数カラーコード 外観
“红色” “r” (1 0 0) “# FF0000”

“绿色” ‘g’ (0 1 0) “# 00 ff00”

“蓝” “b” (0 0 1) “# 0000 ff”

“青色” “c” (0 1 1) “# 00飞行符”

“红色” “米” (1 0 1) “#就”

“黄色” “y” (1 1 0) “# FFFF00”

“黑” “k” (0 0 0) # 000000的

“白色” ' w ' (1 1 1) “# FFFFFF”

“没有” 該当なし 該当なし 該当なし 色なし

MATLABの多くのタイプのプロットで使用されている既定の色のRGB 3成分および16進数カラーコードを次に示します。

RGB 3成分 16進数カラーコード 外観
[0 0.4470 - 0.7410) “# 0072 bd”

(0.8500 0.3250 0.0980) “# D95319”

(0.9290 0.6940 0.1250) “# EDB120”

(0.4940 0.1840 0.5560) “# 7 e2f8e”

(0.4660 0.6740 0.1880) “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

(0.6350 0.0780 0.1840) “# A2142F”

マーカーの塗りつぶし色。“汽车”RGB 3成分,16進数カラーコード,色名,または省略名として指定します。“汽车”オプションは親の座標軸の颜色プロパティと同じ色を使用します。“汽车”を指定し,座標軸のプロットボックスが非表示の場合,マーカーの塗りつぶし色は图の色です。

カスタム色を使用する場合は,RGB 3成分または16進数カラーコードを指定します。

  • RGB 3成分は,色の赤,緑,青成分の強度を指定する3成分の行ベクトルです。強度値は[0, 1]の範囲でなければなりません。たとえば(0.4 0.6 0.7)のようになります。

  • 16進数カラーコードは,ハッシュ記号()で始まり3桁または6桁の0からFまでの範囲の16進数が続く文字ベクトルまたは字符串スカラーです。これらの値では大文字小文字は区別されません。したがって,カラーコード“# FF8800”“# ff8800”“# F80”,および“# f80”は等価です。

あるいは,名前を使用して一部の一般的な色を指定できます。次の表に,名前の付いた色オプション,等価のRGB 3成分,および16進数カラーコードを示します。

色名 省略名 RGB 3成分 16進数カラーコード 外観
“红色” “r” (1 0 0) “# FF0000”

“绿色” ‘g’ (0 1 0) “# 00 ff00”

“蓝” “b” (0 0 1) “# 0000 ff”

“青色” “c” (0 1 1) “# 00飞行符”

“红色” “米” (1 0 1) “#就”

“黄色” “y” (1 1 0) “# FFFF00”

“黑” “k” (0 0 0) # 000000的

“白色” ' w ' (1 1 1) “# FFFFFF”

“没有” 該当なし 該当なし 該当なし 色なし

MATLABの多くのタイプのプロットで使用されている既定の色のRGB 3成分および16進数カラーコードを次に示します。

RGB 3成分 16進数カラーコード 外観
[0 0.4470 - 0.7410) “# 0072 bd”

(0.8500 0.3250 0.0980) “# D95319”

(0.9290 0.6940 0.1250) “# EDB120”

(0.4940 0.1840 0.5560) “# 7 e2f8e”

(0.4660 0.6740 0.1880) “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

(0.6350 0.0780 0.1840) “# A2142F”

直交座標データ

すべて展開する

x値。ベクトルとして指定します。

  • 2次元ラインプロットでは,x値を指定しないと,MATLABはYDataのインデックスをプロットのx値として使用します。XDataYDataの長さは同じでなければなりません。

  • 3次元ラインプロットでは,x値を指定しないと,MATLABはZDataのインデックスをプロットのx値として使用します。XDataYDataZDataの長さは同じでなければなりません。

例:[1:10]

データ型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|持续时间

XDataの選択モード。次の値のいずれかとして指定します。

  • “汽车”- - - - - -YData(3次元プロットの場合はZData)の値のインデックスを使用します。

  • “手动”——手動で指定した値を使用します。値を指定するには,XDataプロパティを設定するか,プロット関数の入力引数Xを指定します。

XDataにリンクされている変数。MATLABワークスペースの変数名を含む文字ベクトルまたは string として指定します。MATLAB はベース ワークスペース内の変数を評価してXDataを生成します。

既定ではリンクされている変数はないため,この値は空の文字ベクトル''です。変数をリンクしてもMATLABはXDataの値をすぐに更新しません。データ値の更新を強制するには,関数refreshdataを使用します。

メモ

1つのデータソースプロパティを異なる次元のデータを含む変数に変更すると,すべてのデータソースプロパティを適切な値に変更するまでは,関数が警告を生成し,グラフが描画されない可能性があります。

例:“x”

y値。ベクトルとして指定します。2次元ラインプロットでは,XDataYDataの長さは同じでなければなりません。3次元ラインプロットでは,XDataYDataおよびZDataの長さは同じでなければなりません。

例:[1:10]

データ型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|持续时间

YDataにリンクされている変数。MATLABワークスペースの変数名を含む文字ベクトルまたは string として指定します。MATLAB はベース ワークスペース内の変数を評価してYDataを生成します。

既定ではリンクされている変数はないため,この値は空の文字ベクトル''です。変数をリンクしてもMATLABはYDataの値をすぐに更新しません。データ値の更新を強制するには,関数refreshdataを使用します。

メモ

1つのデータソースプロパティを異なる次元のデータを含む変数に変更すると,すべてのデータソースプロパティを適切な値に変更するまでは,関数が警告を生成し,グラフが描画されない可能性があります。

例:“y”

3次元ラインプロットのz値。ベクトルとして指定します。XDataYDataおよびZDataの長さは同じでなければなりません。

例:[1:10]

データ型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|持续时间

ZDataにリンクされている変数。MATLABワークスペースの変数名を含む文字ベクトルまたは string として指定します。MATLAB はベース ワークスペース内の変数を評価してZDataを生成します。

既定ではリンクされている変数はないため,この値は空の文字ベクトル''です。変数をリンクしてもMATLABはZDataの値をすぐに更新しません。データ値の更新を強制するには,関数refreshdataを使用します。

メモ

1つのデータソースプロパティを異なる次元のデータを含む変数に変更すると,すべてのデータソースプロパティを適切な値に変更するまでは,関数が警告を生成し,グラフが描画されない可能性があります。

例:“z”

極座標データ

すべて展開する

角度の値。ベクトルとして指定します。ThetaDataRDataは同じ長さのベクトルでなければなりません。

このプロパティは,極座標軸のラインにのみ適用されます。

ThetaDataプロパティ値の選択モード。次の値のいずれかとして指定します。

  • “汽车”——値を自動で選択します。

  • “手动”——指定された値を使用します。値を指定するには,ThetaDataプロパティを設定するか,プロット関数の入力引数θを指定します。

このプロパティは,極座標軸のラインにのみ適用されます。

ThetaDataにリンクされている変数。MATLABワークスペースの変数名を含む文字ベクトルとして指定します。MATLAB はベース ワークスペース内の変数を評価してRDataを生成します。

既定ではリンクされている変数はないため,この値は空の文字ベクトル''です。変数をリンクしてもMATLABはThetaDataの値をすぐに更新しません。データ値の更新を強制するには,関数refreshdataを使用します。

メモ

1つのデータソースプロパティを異なる次元のデータを含む変数に変更すると,すべてのデータソースプロパティを適切な値に変更するまでは,関数が警告を生成し,グラフが描画されない可能性があります。

このプロパティは,極座標軸のラインにのみ適用されます。

半径の値。ベクトルとして指定します。ThetaDataRDataは同じ長さのベクトルでなければなりません。

このプロパティは,極座標軸のラインにのみ適用されます。

RDataにリンクされている変数。MATLABワークスペースの変数名を含む文字ベクトルとして指定します。MATLAB はベース ワークスペース内の変数を評価してRDataを生成します。

既定ではリンクされている変数はないため,この値は空の文字ベクトル''です。変数をリンクしてもMATLABはRDataの値をすぐに更新しません。データ値の更新を強制するには,関数refreshdataを使用します。

メモ

1つのデータソースプロパティを異なる次元のデータを含む変数に変更すると,すべてのデータソースプロパティを適切な値に変更するまでは,関数が警告を生成し,グラフが描画されない可能性があります。

このプロパティは,極座標軸のラインにのみ適用されます。

地理座標データ

すべて展開する

緯度の値。ベクトルとして指定します。LatitudeDataLongitudeDataは同じ長さのベクトルでなければなりません。

このプロパティは,地理座標軸のラインにのみ適用されます。

LatitudeDataにリンクされている変数。MATLABワークスペースの変数名を含む文字ベクトルとして指定します。MATLAB はベース ワークスペース内の変数を評価してLatitudeDataを生成します。

既定ではリンクされている変数はないため,この値は空の文字ベクトル''です。変数をリンクしてもMATLABはLatitudeDataの値をすぐに更新しません。データ値の更新を強制するには,関数refreshdataを使用します。

メモ

1つのデータソースプロパティを異なる次元のデータを含む変数に変更すると,すべてのデータソースプロパティを適切な値に変更するまでは,関数が警告を生成し,グラフが描画されない可能性があります。

このプロパティは,地理座標軸のラインにのみ適用されます。

経度の値。ベクトルとして指定します。LongitudeDataLatitudeDataは同じ長さのベクトルでなければなりません。

このプロパティは,地理座標軸のラインにのみ適用されます。

LongitudeDataにリンクされている変数。MATLABワークスペースの変数名を含む文字ベクトルとして指定します。MATLAB はベース ワークスペース内の変数を評価してLongitudeDataを生成します。

既定ではリンクされている変数はないため,この値は空の文字ベクトル''です。変数をリンクしてもMATLABはLongitudeDataの値をすぐに更新しません。データ値の更新を強制するには,関数refreshdataを使用します。

メモ

1つのデータソースプロパティを異なる次元のデータを含む変数に変更すると,すべてのデータソースプロパティを適切な値に変更するまでは,関数が警告を生成し,グラフが描画されない可能性があります。

このプロパティは,地理座標軸のラインにのみ適用されます。

凡例

すべて展開する

凡例ラベル。文字ベクトルまたは字符串スカラーとして指定します。传说コマンドを呼び出すまで,凡例は表示されません。テキストを指定しない場合,传说“dataN”形式を使用してラベルを設定します。

このプロパティは読み取り専用です。

凡例にオブジェクトを含めるか除外するかの制御。注释オブジェクトとして返されます。基となるIconDisplayStyleプロパティを次のいずれかの値に設定します。

  • “上”——凡例にオブジェクトを含めます(既定)。

  • “关闭”——凡例にオブジェクトを含めません。

たとえば,グラフィックスオブジェクトを凡例から除外するには,IconDisplayStyleプロパティを“关闭”に設定します。

go.Annotation.LegendInformation.IconDisplayStyle =“关闭”

あるいは,関数传说を使用して,凡例内の項目を制御することもできます。最初の入力引数を,含めるグラフィックスオブジェクトのベクトルとして指定します。最初の入力引数に既存のグラフィックスオブジェクトを指定しない場合,それは凡例に表示されません。ただし,凡例が作成された後に座標軸に追加されたグラフィックスオブジェクトは凡例には表示されません。追加の項目を避けるには,すべてのプロットを作成した後に凡例を作成することを考慮してください。

対話機能

すべて展開する

可視性の状態。“上”または“关闭”,もしくは数値または逻辑1真正的)または0)として指定します。“上”の値は真正的と等価であり,“关闭”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の开/关逻辑値として格納されます。

  • “上”——オブジェクトを表示します。

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

データヒントの内容。DataTipTemplateオブジェクトとして指定します。基となるDataTipTemplateオブジェクトのプロパティを変更することにより,データヒントに表示される内容を制御できます。プロパティの一覧については,DataTipTemplateのプロパティを参照してください。

データヒントの変更の例については,カスタムデータヒントの作成を参照してください。

メモ

DataTipTemplateオブジェクトはfindobjまたはfindallによって返されず,copyobjによってコピーされません。

コンテキストメニュー。快捷菜单オブジェクトとして指定します。このプロパティは,オブジェクトを右クリックしたときにコンテキストメニューを表示するために使用します。関数uicontextmenuを使用して,コンテキストメニューを作成します。

メモ

PickablePartsプロパティが“没有”に設定されている場合またはHitTestプロパティが“关闭”に設定されている場合には,このコンテキストメニューは表示されません。

選択状態。“上”または“关闭”,もしくは数値または逻辑1真正的)または0)として指定します。“上”の値は真正と等価であり,“关闭”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の开/关逻辑値として格納されます。

  • “上”——選択されています。プロット編集モードでオブジェクトをクリックした場合,MATLABは选择プロパティを“上”に設定します。SelectionHighlightプロパティも“上”に設定されている場合,MATLABはオブジェクトの周囲に選択ハンドルを表示します。

  • “关闭”——選択されていません。

選択時の選択ハンドルの表示。“上”または“关闭”,もしくは数値または逻辑1真正的)または0)として指定します。“上”の値は真正と等価であり,“关闭”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の开/关逻辑値として格納されます。

  • “上”- - - - - -选择プロパティが“上”に設定されているときに選択ハンドルを表示します。

  • “关闭”- - - - - -选择プロパティが“上”に設定されている場合でも選択ハンドルを表示しません。

座標軸の範囲でのオブジェクトのクリップ。“上”または“关闭”,もしくは数値または逻辑1真正的)または0)として指定します。“上”の値は真正と等価であり,“关闭”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の开/关逻辑値として格納されます。

  • “上”の値は座標軸の範囲外になるオブジェクトの部分をクリップします。

  • “关闭”の値は座標軸の範囲外に表示される部分があってもオブジェクト全体を表示します。プロットの作成,抓住の設定,座標軸のスケーリングの固定を行ってから,元のプロットよりも大きくなるようにオブジェクトを作成した場合,オブジェクトの一部が座標軸の範囲の外に表示されることがあります。

オブジェクトを含む座標軸の剪裁プロパティは“上”に設定しなければなりません。そうしない場合,このプロパティの効果はありません。クリップ動作の詳細については,座標軸の剪裁プロパティを参照してください。

コールバック

すべて展開する

マウスクリックコールバック。次の値のいずれかとして指定します。

  • 関数ハンドル

  • 関数ハンドルと追加の引数を含む细胞配列

  • ベースワークスペース内で評価される有効なMATLABコマンドまたはMATLAB関数の文字ベクトル(非推奨)

このプロパティは,オブジェクトをクリックしたときにコードを実行するために使用します。関数ハンドルを使用してこのプロパティを指定した場合、MATLAB はコールバックを実行するときに次の 2 つの引数をコールバック関数に渡します。

  • クリックしたオブジェクト——コールバック関数内から,クリックしたオブジェクトのプロパティにアクセスします。

  • イベントデータ——空の引数です。この引数が使用されないことを示すために,関数定義の中でこの引数をチルダ文字()に置換します。

関数ハンドルを使用してコールバック関数を定義する方法についての詳細は,コールバック定義を参照してください。

メモ

PickablePartsプロパティが“没有”に設定されている場合またはHitTestプロパティが“关闭”に設定されている場合には,このコールバックは実行されません。

オブジェクト作成関数。次の値のいずれかとして指定します。

  • 関数ハンドル。

  • 最初の要素が関数ハンドルである细胞配列。细胞配列内のその後の要素はコールバック関数に渡される引数です。

  • 有効なMATLAB式を含む文字ベクトル(非推奨)。MATLABは,この式をベース ワークスペースで評価します。

コールバックを関数ハンドル,细胞配列,または文字ベクトルとして指定する方法の詳細については,コールバック定義を参照してください。

このプロパティは,MATLABがオブジェクトを作成するときに実行されるコールバック関数を指定します。MATLABはCreateFcnコールバックを実行する前に,すべてのプロパティ値を初期化します。CreateFcnプロパティを指定しない場合,MATLABは既定の作成関数を実行します。

既存のコンポーネントにCreateFcnプロパティを設定しても効果はありません。

このプロパティを関数ハンドルまたは细胞配列として指定した場合,コールバック関数の最初の引数を使用して,作成中のオブジェクトにアクセスできます。それ以外の場合は,関数gcboを使用してオブジェクトにアクセスします。

オブジェクト削除関数。次の値のいずれかとして指定します。

  • 関数ハンドル。

  • 最初の要素が関数ハンドルである细胞配列。细胞配列内のその後の要素はコールバック関数に渡される引数です。

  • 有効なMATLAB式を含む文字ベクトル(非推奨)。MATLABは,この式をベース ワークスペースで評価します。

コールバックを関数ハンドル,细胞配列,または文字ベクトルとして指定する方法の詳細については,コールバック定義を参照してください。

このプロパティは,MATLABがオブジェクトを削除するときに実行されるコールバック関数を指定します。MATLABは,オブジェクトのプロパティを破棄する前にDeleteFcnコールバックを実行します。DeleteFcnプロパティを指定しない場合,MATLABは既定の削除関数を実行します。

このプロパティを関数ハンドルまたは细胞配列として指定した場合,コールバック関数の最初の引数を使用して,削除されるオブジェクトにアクセスできます。それ以外の場合は,関数gcboを使用してオブジェクトにアクセスします。

コールバック実行制御

すべて展開する

コールバックの割り込み。“上”または“关闭”,もしくは数値または逻辑1真正的)または0)として指定します。“上”の値は真正的と等価であり,“关闭”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の开/关逻辑値として格納されます。

このプロパティは実行中のコールバックが割り込み可能かどうかを決定します。2次のつのコールバックの状態について考慮する必要があります。

  • "実行中"コールバックは,現在実行しているコールバックです。

  • “割り込み”コールバックは,実行中のコールバックに割り込もうとするコールバックです。

MATLABがコールバックを呼び出すたびに,そのコールバックは実行中のコールバック(がある場合)に割り込もうとします。実行中のコールバックを所有するオブジェクトの可中断プロパティが,割り込み可能かどうかを決定します。

  • 値が“上”の場合,他のコールバックがオブジェクトのコールバックに割り込むことができます。割り込みは,drawnow数字uifiguregetframe等待暂停コマンドなどの,MATLABが次にキューを処理するポイントで発生します。

    • 実行中のコールバックにこれらのいずれかのコマンドが含まれている場合,MATLABはそのポイントでコールバックの実行を停止し,割り込みコールバックを実行します。割り込みコールバックが完了すると,MATLABは実行中だったコールバックの実行を再開します。

    • 実行中のコールバックにこれらのコマンドが含まれていない場合,MATLABはそのコールバックの実行を割り込みなしで完了します。

  • 値が“关闭”の場合,割り込みの試行はすべてブロックされます。割り込みコールバックを所有するオブジェクトのBusyActionプロパティが,その割り込みコールバックを破棄するかキューに入れるかを決定します。

メモ

コールバックの割り込みと実行は,以下の状況では動作が異なります。

  • 割り込みコールバックがDeleteFcnCloseRequestFcnまたはSizeChangedFcnの各コールバックの場合,可中断プロパティの値にかかわらず割り込みが発生します。

  • 実行中のコールバックが関数等待を現在実行している場合,可中断プロパティの値にかかわらず割り込みが発生します。

  • 计时器オブジェクトは,可中断プロパティ値にかかわらず,スケジュールに従って実行されます。

MATLABは,割り込みが発生したときにプロパティの状態や表示を保存しません。たとえば,gcaコマンドやgcfコマンドから返されたオブジェクトは,別のコールバックを実行するときに変更されている可能性があります。

コールバックキューイング。“队列”または“取消”として指定します。BusyActionプロパティはMATLABによる割り込みコールバックの実行の処理方法を決定します。2次のつのコールバックの状態について考慮する必要があります。

  • "実行中"コールバックは,現在実行しているコールバックです。

  • “割り込み”コールバックは,実行中のコールバックに割り込もうとするコールバックです。

MATLABがコールバックを呼び出すたびに,そのコールバックは実行中のコールバックに割り込もうとします。実行中のコールバックを所有するオブジェクトの可中断プロパティが,割り込みを許可するかどうかを決定します。割り込みが許可されない場合は,割り込みコールバックを所有するオブジェクトのBusyActionプロパティが,そのコールバックを破棄するかキューに入れるかを決定します。BusyActionプロパティは次の値を取ることができます。

  • “队列”——割り込みコールバックをキューに入れ,実行中のコールバックが終了した後に処理されるようにします。

  • “取消”——割り込みコールバックを実行しません。

マウスクリックキャプチャ機能。第1次の値のつとして指定します。

  • “可见”——表示されている場合にマウスクリックをキャプチャします。可见プロパティが“上”に設定されていなければならず,オブジェクトの色が定義されている部分をクリックしなければなりません。関連付けられている色のプロパティが“没有”に設定されている部分をクリックすることはできません。プロットにマーカーが含まれている場合は,エッジまたは塗りつぶしのいずれかに色が定義されている場合にマーカー全体がクリック可能になります。オブジェクトがクリックに応答するか,先祖がクリックに応答するかは,HitTestプロパティが決定します。

  • “所有”——表示状態に関係なくマウスクリックをキャプチャします。可见プロパティを“上”または“关闭”に設定でき,オブジェクトの色が設定されていない部分をクリックできます。オブジェクトがクリックに応答するか,先祖がクリックに応答するかは,HitTestプロパティが決定します。

  • “没有”——マウスクリックをキャプチャしません。オブジェクトをクリックすると,图ウィンドウの現在のビュー内でその下にあるオブジェクトまでクリックが渡されます。HitTestプロパティは無効になります。

キャプチャしたマウスクリックへの応答。“上”または“关闭”,もしくは数値または逻辑1真正的)または0)として指定します。“上”の値は真正と等価であり,“关闭”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の开/关逻辑値として格納されます。

  • “上”- - - - - -オブジェクトのButtonDownFcnコールバックをトリガーします。快捷菜单プロパティが定義されている場合は,コンテキストメニューを呼び出します。

  • “关闭”- - - - - -オブジェクトの先祖のうち,次のいずれかの条件を満たす最も近い先祖のコールバックをトリガーします。

    • HitTestプロパティが“上”に設定されている

    • PickablePartsプロパティが,先祖によるマウスクリックのキャプチャを有効にする値に設定されている

メモ

PickablePartsプロパティは,オブジェクトがマウスクリックをキャプチャできるかどうかを決定します。キャプチャできない場合,HitTestプロパティは無効です。

このプロパティは読み取り専用です。

削除状態。matlab.lang.OnOffSwitchState型の开/关逻辑値として返されます。

MATLABは,DeleteFcnコールバックが実行を開始すると,BeingDeletedプロパティを“上”に設定します。コンポーネントオブジェクトが存在しなくなるまでBeingDeletedプロパティは“上”に設定されたままです。

クエリや変更の前にオブジェクトが削除されようとしていないか確認するためにBeingDeletedプロパティの値をチェックします。

親/子

すべて展開する

親。PolarAxes集团または变换オブジェクトとして指定します。

子。空のGraphicsPlaceholder配列,またはDataTipオブジェクト配列として返されます。このプロパティを使用して,チャートにプロットされるデータヒントのリストを表示します。

孩子们プロパティを使用して子の追加や削除を行うことはできません。このリストに子を追加するには,DataTipオブジェクトのプロパティをチャートオブジェクトに設定します。

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

  • “上”——オブジェクトハンドルは常に表示されます。

  • “关闭”——オブジェクトハンドルは常に非表示です。このオプションは,他の関数による意図しない変更を防止するために役立ちます。HandleVisibility“关闭”に設定すると,その関数の実行中にハンドルが一時的に非表示になります。

  • “回调”——オブジェクトハンドルはコールバック内から,あるいはコールバックにより呼び出される関数から参照できます。しかし,コマンドラインから呼び出される関数からは参照できません。このオプションを使用すると,コマンドラインからのオブジェクトへのアクセスがブロックされますが,コールバック関数からのアクセスは許可されます。

オブジェクトが親の孩子们プロパティ内にリストされない場合,オブジェクト階層の検索またはハンドルプロパティのクエリによってオブジェクトハンドルを取得する関数は,そのオブジェクトハンドルを返しません。こうした関数の例としては,関数得到findobjgcagcfgconewplotclf,および关闭などが挙げられます。

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

識別子

すべて展開する

このプロパティは読み取り専用です。

グラフィックスオブジェクトのタイプ。“行”として返されます。プロット階層内にある特定のタイプのすべてのオブジェクトを検出するためにこのプロパティを使用できます。たとえばfindobjを使用してタイプを検索します。

オブジェクト識別子。文字ベクトルまたは字符串スカラーとして指定します。オブジェクトの識別子として機能する一意の标签値を指定できます。コードの他の部分からオブジェクトにアクセスする必要がある場合,関数findobjを使用して标签値に基づいてオブジェクトを検索できます。

ユーザーデータ。任意のMATLAB配列として指定します。たとえば,スカラー、ベクトル、行列、cell 配列、文字配列、table、または構造体を指定できます。このプロパティを使用して、任意のデータをオブジェクトに保存します。

程序设计师を使用している場合は,用户数据プロパティを使用する代わりに,アプリでパブリックプロパティまたはプライベートプロパティを作成してデータを共有します。詳細については,程序设计师アプリ内でのデータの共有を参照してください。

互換性についての考慮事項

すべて展開する

R2020a以降は非推奨

R2006aより前に導入