Main Content

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

ImplicitFunctionLine のプロパティ

陰関数線グラフの外観と動作

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

fp = fimplicit(@(x,y) x.^2 + y.^2 - 3) fp.LineWidth = 2

色とスタイル

すべて展開する

ラインの色。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 進数カラー コード 外観
“红色” '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'

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

  • 'auto'— 座標軸のColorOrderプロパティから色を選択することにより、MATLAB がColorプロパティ値を制御します。

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

Colorプロパティの値を手動で変更すると、MATLAB はColorModeプロパティの値を'manual'に変更します。

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

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

'--' 破線

“:” 点線

'-.' 一点鎖線

'none' ラインなし ラインなし

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

  • 'auto'— MATLAB が座標軸のLineStyleOrderプロパティからライン スタイルを選択することにより、LineStyleプロパティ値を制御します。

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

LineStyleプロパティの値を手動で変更すると、MATLAB はLineStyleModeプロパティの値を'manual'に変更します。

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

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

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

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

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

  • ImplicitFunctionLineオブジェクトのColorModeLineStyleMode、またはMarkerModeプロパティの少なくとも 1 つが'auto'に設定されている。

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

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

マーカー

すべて展開する

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

説明
'o'
'+' プラス記号
'*' アスタリスク
'.'
'x' 十字
'_' 水平線
“|” 垂直線
'square'または's' 正方形
'diamond'または'd' 菱形
'^' 上向き三角形
'v' 下向き三角形
'>' 右向き三角形
'<' 左向き三角形
'pentagram'または'p' 星形五角形
'hexagram'または'h' 星形六角形
'none' マーカーなし

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

  • 'auto'— MATLAB がオブジェクトのMarkerプロパティ値を制御します。

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

Markerプロパティの値を手動で変更すると、MATLAB はMarkerModeプロパティの値を'manual'に変更します。

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

マーカーの輪郭の色。'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 進数カラー コード 外観
“红色” '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'

マーカーの塗りつぶし色。'auto'、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。'auto'値を指定すると、MarkerEdgeColorプロパティと同じ色が使用されます。

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

関数

すべて展開する

プロット対象の関数。関数ハンドル、無名関数、シンボリック式またはシンボリック関数として指定します。

x 値のプロット区間。[xmin xmax]の形式の 2 要素ベクトルとして指定します。

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

  • 'auto'— 既定値[-5 5]を使用します。座標軸の範囲が指定されている場合は、代わりに指定の範囲に従います。

  • 'manual'— 手動で指定した値を使用します。値を指定するには、XRangeプロパティを設定します。

y 値のプロット区間。[ymin ymax]の形式の 2 要素ベクトルとして指定します。

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

  • 'auto'— 既定値[-5 5]を使用します。座標軸の範囲が指定されている場合は、代わりに指定の範囲に従います。

  • 'manual'— 手動で指定した値を使用します。値を指定するには、YRangeプロパティを設定します。

評価点の数。スカラーとして指定します。

データ

すべて展開する

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

x値。ベクトルとして返されます。XDataYDataおよびZDataは同じ長さです。

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

y値。ベクトルとして返されます。XDataYDataおよびZDataは同じ長さです。

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

z値。ゼロのベクトルとして返されます。XDataYDataおよびZDataは同じ長さです。

凡例

すべて展開する

凡例ラベルのテキスト。カスタム文字ベクトルまたは string として指定します。既定のラベルはFunctionプロパティと関数texlabelから自動生成されます。関数legendを呼び出すまで凡例は表示されません。

データ型:char|string

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

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

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

  • 'off'— 凡例にオブジェクトを含めません。

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

go.Annotation.LegendInformation.IconDisplayStyle ='off';

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

対話機能

すべて展開する

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

  • 'on'— オブジェクトを表示します。

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

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

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

メモ

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

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

メモ

PickablePartsプロパティが'none'に設定されている場合またはHitTestプロパティが'off'に設定されている場合には、このコンテキスト メニューは表示されません。

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

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

  • 'off'— 選択されていません。

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

  • 'on'Selectedプロパティが'on'に設定されているときに選択ハンドルを表示します。

  • 'off'Selectedプロパティが'on'に設定されている場合でも選択ハンドルを表示しません。

座標軸の範囲でのオブジェクトのクリップ。'on'または'off'、もしくは数値または logical1(true) または0(false) として指定します。'on'の値は true と等価であり、'off'falseと等価です。したがって、このプロパティの値を logical 値として使用できます。値はmatlab.lang.OnOffSwitchState型の on/off logical 値として格納されます。

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

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

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

コールバック

すべて展開する

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

  • 関数ハンドル

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

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

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

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

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

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

メモ

PickablePartsプロパティが'none'に設定されている場合またはHitTestプロパティが'off'に設定されている場合には,このコールバックは実行されません。

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

  • 関数ハンドル。

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

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

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

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

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

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

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

  • 関数ハンドル。

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

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

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

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

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

コールバック実行制御

すべて展開する

コールバックの割り込み。'on'または'off'、もしくは数値または logical1(true) または0(false) として指定します。'on'の値はtrueと等価であり、'off'falseと等価です。したがって、このプロパティの値を logical 値として使用できます。値はmatlab.lang.OnOffSwitchState型の on/off logical 値として格納されます。

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

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

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

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

  • 値が'on'の場合、他のコールバックがオブジェクトのコールバックに割り込むことができます。割り込みは、drawnowfigureuifiguregetframewaitforpauseコマンドなどの、MATLAB が次にキューを処理するポイントで発生します。

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

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

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

メモ

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

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

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

  • Timerオブジェクトは、Interruptibleプロパティ値にかかわらず、スケジュールに従って実行されます。

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

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

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

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

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

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

  • 'cancel'— 割り込みコールバックを実行しません。

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

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

  • 'all'— 表示状態に関係なくマウス クリックをキャプチャします。Visibleプロパティを'on'または'off'に設定でき、ImplicitFunctionLineオブジェクトの色が設定されていない部分をクリックできます。ImplicitFunctionLineオブジェクトがクリックに応答するか、先祖がクリックに応答するかは、HitTestプロパティが決定します。

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

キャプチャしたマウス クリックへの応答。'on'または'off'、もしくは数値または logical1(true) または0(false) として指定します。'on'の値は true と等価であり、'off'falseと等価です。したがって、このプロパティの値を logical 値として使用できます。値はmatlab.lang.OnOffSwitchState型の on/off logical 値として格納されます。

  • 'on'ImplicitFunctionLineオブジェクトのButtonDownFcnコールバックをトリガーします。ContextMenuプロパティが定義されている場合は、コンテキスト メニューを呼び出します。

  • 'off'ImplicitFunctionLineオブジェクトの先祖のうち、次のいずれかの条件を満たす最も近い先祖のコールバックをトリガーします。

    • HitTestプロパティが'on'に設定されている

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

メモ

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

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

削除状態。matlab.lang.OnOffSwitchState型の on/off logical 値として返されます。

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

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

親/子

すべて展開する

親。AxesGroupまたはTransformオブジェクトとして指定します。

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

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

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

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

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

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

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

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

識別子

すべて展開する

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

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

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

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

App Designer を使用している場合は、UserDataプロパティを使用する代わりに、アプリでパブリック プロパティまたはプライベート プロパティを作成してデータを共有します。詳細については、App Designer アプリ内でのデータの共有を参照してください。

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

すべて展開する

R2020a 以降は非推奨

R2016b で導入