このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。
陰関数線グラフの外観と動作
ImplicitFunctionLine
プロパティは、ImplicitFunctionLine
オブジェクトの外観と動作を制御します。プロパティの値を変更することによって、線グラフの一部の特性を変更できます。ドット表記を使用して、特定のオブジェクトとプロパティを参照できます。
fp = fimplicit(@(x,y) x.^2 + y.^2 - 3) fp.LineWidth = 2
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 進数カラー コード | 外観 |
---|---|---|---|---|
“红色” |
'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'
ColorMode
—Color
の設定方法を制御'auto'
(既定値) |'manual'
Color
プロパティの設定方法を制御します。次のいずれかの値として指定します。
'auto'
— 座標軸のColorOrder
プロパティから色を選択することにより、MATLAB がColor
プロパティ値を制御します。
'manual'
— ユーザーがオブジェクトのColor
プロパティの値を直接設定するか、プロット関数を呼び出すときにLineSpec
引数に色を含めることにより、Color
プロパティの値を手動で制御します。
Color
プロパティの値を手動で変更すると、MATLAB はColorMode
プロパティの値を'manual'
に変更します。
LineStyle
—ライン スタイル“- - -”
(既定値) |'--'
|“:”
|'-.'
|'none'
ライン スタイル。次の表にリストされたオプションのいずれかとして指定します。
ライン スタイル | 説明 | 結果として得られる線 |
---|---|---|
“- - -” |
実線 |
|
'--' |
破線 |
|
“:” |
点線 |
|
'-.' |
一点鎖線 |
|
'none' |
ラインなし | ラインなし |
LineStyleMode
—LineStyle
の設定方法を制御'auto'
(既定値) |'manual'
LineStyle
プロパティの設定方法を制御します。次のいずれかの値として指定します。
'auto'
— MATLAB が座標軸のLineStyleOrder
プロパティからライン スタイルを選択することにより、LineStyle
プロパティ値を制御します。
'manual'
— ユーザーがオブジェクトのLineStyle
プロパティの値を直接設定するか、プロット関数を呼び出すときにLineSpec
引数を指定することにより、LineStyle
プロパティの値を手動で制御します。
LineStyle
プロパティの値を手動で変更すると、MATLAB はLineStyleMode
プロパティの値を'manual'
に変更します。
LineWidth
—ライン幅0.5
(既定値) |正の値ライン幅。ポイント単位の正の値として指定します。1 ポイントは 1/72 インチです。ラインがマーカーをもつ場合、ライン幅はマーカー エッジにも影響します。
ライン幅をピクセルの幅より細くすることはできません。システムでライン幅をピクセルの幅より細い値に設定すると、ラインは 1 ピクセル幅で表示されます。
SeriesIndex
—シリーズ インデックスシリーズ インデックス。0
または正の整数として指定します。このプロパティは、いくつかのImplicitFunctionLine
オブジェクトの色、ライン スタイル、またはマーカーを、互いに一致するよう再割り当てするのに役立ちます。既定では、ImplicitFunctionLine
オブジェクトのSeriesIndex
プロパティは、1
から始まる、作成順に対応する数値です。
MATLAB はこの数値を使用して、プロット関数を呼び出すときに、色、ライン スタイル、またはマーカーを割り当てるインデックスを計算します。インデックスは座標軸のColorOrder
プロパティとLineStyleOrder
プロパティに格納されている配列の行を参照します。
MATLAB は、そのSeriesIndex
を変更するか、座標軸のColorOrder
プロパティまたはLineStyleOrder
プロパティを変更する際に、ImplicitFunctionLine
オブジェクトの色、ライン スタイル、またはマーカーを自動的に更新します。ただし、変更が有効になるには、以下の条件に該当しなければなりません。
ImplicitFunctionLine
オブジェクトのColorMode
、LineStyleMode
、またはMarkerMode
プロパティの少なくとも 1 つが'auto'
に設定されている。
ImplicitFunctionLine
オブジェクトのSeriesIndex
プロパティが0
より大きい。
axes オブジェクトのNextSeriesIndex
プロパティが0
より大きい。
Marker
—マーカー記号'none'
(既定値) |'o'
|'+'
|'*'
|'.'
| ...マーカー記号。次の表に挙げる値のいずれかとして指定します。既定では、オブジェクトはマーカーを表示しません。マーカー記号を指定すると、各データ点または各頂点にマーカーが追加されます。
値 | 説明 |
---|---|
'o' |
円 |
'+' |
プラス記号 |
'*' |
アスタリスク |
'.' |
点 |
'x' |
十字 |
'_' |
水平線 |
“|” |
垂直線 |
'square' または's' |
正方形 |
'diamond' または'd' |
菱形 |
'^' |
上向き三角形 |
'v' |
下向き三角形 |
'>' |
右向き三角形 |
'<' |
左向き三角形 |
'pentagram' または'p' |
星形五角形 |
'hexagram' または'h' |
星形六角形 |
'none' |
マーカーなし |
MarkerMode
—Marker
の設定方法を制御'auto'
(既定値) |'manual'
Marker
プロパティの設定方法を制御します。次のいずれかの値として指定します。
'auto'
— MATLAB がオブジェクトのMarker
プロパティ値を制御します。
'manual'
— ユーザーがオブジェクトのMarker
プロパティの値を直接設定するか、プロット関数を呼び出すときにLineSpec
引数にマーカーを含めることにより、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 進数カラー コード | 外観 |
---|---|---|---|---|
“红色” |
'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'
値を指定すると、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'
Function
—プロット対象の関数プロット対象の関数。関数ハンドル、無名関数、シンボリック式またはシンボリック関数として指定します。
XRange
—x 値のプロット区間[–5 5]
(既定値) |[xmin xmax]
の形式の 2 要素ベクトルx 値のプロット区間。[xmin xmax]
の形式の 2 要素ベクトルとして指定します。
XRangeMode
—XRange
の選択モード'auto'
(既定値) |'manual'
XRange
の選択モード。次の値のいずれかとして指定します。
'auto'
— 既定値[-5 5]
を使用します。座標軸の範囲が指定されている場合は、代わりに指定の範囲に従います。
'manual'
— 手動で指定した値を使用します。値を指定するには、XRange
プロパティを設定します。
YRange
—y 値のプロット区間[–5 5]
(既定値) |[ymin ymax]
の形式の 2 要素ベクトルy 値のプロット区間。[ymin ymax]
の形式の 2 要素ベクトルとして指定します。
YRangeMode
—YRange
の選択モード'auto'
(既定値) |'manual'
YRange
の選択モード。次の値のいずれかとして指定します。
'auto'
— 既定値[-5 5]
を使用します。座標軸の範囲が指定されている場合は、代わりに指定の範囲に従います。
'manual'
— 手動で指定した値を使用します。値を指定するには、YRange
プロパティを設定します。
MeshDensity
—評価点の数151
(既定値) |スカラー評価点の数。スカラーとして指定します。
XData
—x 値このプロパティは読み取り専用です。
x値。ベクトルとして返されます。XData
、YData
およびZData
は同じ長さです。
YData
—y 値このプロパティは読み取り専用です。
y値。ベクトルとして返されます。XData
、YData
およびZData
は同じ長さです。
ZData
—z 値このプロパティは読み取り専用です。
z値。ゼロのベクトルとして返されます。XData
、YData
およびZData
は同じ長さです。
DisplayName
—凡例ラベルのテキスト凡例ラベルのテキスト。カスタム文字ベクトルまたは string として指定します。既定のラベルはFunction
プロパティと関数texlabel
から自動生成されます。関数legend
を呼び出すまで凡例は表示されません。
データ型:char
|string
Annotation
—凡例にオブジェクトを含めるか除外するかの制御Annotation
オブジェクトこのプロパティは読み取り専用です。
凡例にオブジェクトを含めるか除外するかの制御。Annotation
オブジェクトとして返されます。基となるIconDisplayStyle
プロパティを次のいずれかの値に設定します。
'on'
— 凡例にオブジェクトを含めます (既定)。
'off'
— 凡例にオブジェクトを含めません。
たとえば、グラフィックス オブジェクトgo
を凡例から除外するには、IconDisplayStyle
プロパティを'off'
に設定します。
go.Annotation.LegendInformation.IconDisplayStyle ='off';
あるいは、関数legend
を使用して、凡例内の項目を制御することもできます。最初の入力引数を、含めるグラフィックス オブジェクトのベクトルとして指定します。最初の入力引数に既存のグラフィックス オブジェクトを指定しない場合、それは凡例に表示されません。ただし、凡例が作成された後に座標軸に追加されたグラフィックス オブジェクトは凡例には表示されません。追加の項目を避けるには、すべてのプロットを作成した後に凡例を作成することを考慮してください。
Visible
—可視性の状態'on'
(既定値) |on/off logical 値可視性の状態。'on'
または'off'
、もしくは数値または logical1
(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'
、もしくは数値または logical1
(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'
、もしくは数値または logical1
(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'
、もしくは数値または logical1
(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'
、もしくは数値または logical1
(true
) または0
(false
) として指定します。'on'
の値はtrue
と等価であり、'off'
はfalse
と等価です。したがって、このプロパティの値を logical 値として使用できます。値はmatlab.lang.OnOffSwitchState
型の on/off logical 値として格納されます。
このプロパティは実行中のコールバックが割り込み可能かどうかを決定します。次の 2 つのコールバックの状態について考慮する必要があります。
"実行中"コールバックは、現在実行しているコールバックです。
"割り込み"コールバックは、実行中のコールバックに割り込もうとするコールバックです。
MATLAB がコールバックを呼び出すたびに、そのコールバックは実行中のコールバック (がある場合) に割り込もうとします。実行中のコールバックを所有するオブジェクトのInterruptible
プロパティが、割り込み可能かどうかを決定します。
値が'on'
の場合、他のコールバックがオブジェクトのコールバックに割り込むことができます。割り込みは、drawnow
、figure
、uifigure
、getframe
、waitfor
、pause
コマンドなどの、MATLAB が次にキューを処理するポイントで発生します。
実行中のコールバックにこれらのいずれかのコマンドが含まれている場合、MATLAB はそのポイントでコールバックの実行を停止し、割り込みコールバックを実行します。割り込みコールバックが完了すると、MATLAB は実行中だったコールバックの実行を再開します。
実行中のコールバックにこれらのコマンドが含まれていない場合、MATLAB はそのコールバックの実行を割り込みなしで完了します。
値が'off'
の場合、割り込みの試行はすべてブロックされます。割り込みコールバックを所有するオブジェクトのBusyAction
プロパティが、その割り込みコールバックを破棄するかキューに入れるかを決定します。
メモ
コールバックの割り込みと実行は、以下の状況では動作が異なります。
割り込みコールバックがDeleteFcn
、CloseRequestFcn
またはSizeChangedFcn
の各コールバックの場合、Interruptible
プロパティの値にかかわらず割り込みが発生します。
実行中のコールバックが関数waitfor
を現在実行している場合、Interruptible
プロパティの値にかかわらず割り込みが発生します。
Timer
オブジェクトは、Interruptible
プロパティ値にかかわらず、スケジュールに従って実行されます。
MATLAB は、割り込みが発生したときにプロパティの状態や表示を保存しません。たとえば、gca
コマンドやgcf
コマンドから返されたオブジェクトは、別のコールバックを実行するときに変更されている可能性があります。
BusyAction
—コールバック キューイング'queue'
(既定値) |'cancel'
コールバック キューイング。'queue'
または'cancel'
として指定します。BusyAction
プロパティは MATLAB による割り込みコールバックの実行の処理方法を決定します。次の 2 つのコールバックの状態について考慮する必要があります。
"実行中"コールバックは、現在実行しているコールバックです。
"割り込み"コールバックは、実行中のコールバックに割り込もうとするコールバックです。
MATLAB がコールバックを呼び出すたびに、そのコールバックは実行中のコールバックに割り込もうとします。実行中のコールバックを所有するオブジェクトのInterruptible
プロパティが、割り込みを許可するかどうかを決定します。割り込みが許可されない場合は、割り込みコールバックを所有するオブジェクトのBusyAction
プロパティが、そのコールバックを破棄するかキューに入れるかを決定します。BusyAction
プロパティは次の値を取ることができます。
'queue'
— 割り込みコールバックをキューに入れ、実行中のコールバックが終了した後に処理されるようにします。
'cancel'
— 割り込みコールバックを実行しません。
PickableParts
—マウス クリック キャプチャ機能'visible'
(既定値) |'all'
|'none'
マウス クリック キャプチャ機能。次の値の 1 つとして指定します。
'visible'
— 表示されている場合にマウス クリックをキャプチャします。Visible
プロパティが'on'
に設定されていなければならず、ImplicitFunctionLine
オブジェクトの色が定義されている部分をクリックしなければなりません。関連付けられている色のプロパティが'none'
に設定されている部分をクリックすることはできません。プロットにマーカーが含まれている場合は、エッジまたは塗りつぶしのいずれかに色が定義されている場合にマーカー全体がクリック可能になります。ImplicitFunctionLine
オブジェクトがクリックに応答するか、先祖がクリックに応答するかは、HitTest
プロパティが決定します。
'all'
— 表示状態に関係なくマウス クリックをキャプチャします。Visible
プロパティを'on'
または'off'
に設定でき、ImplicitFunctionLine
オブジェクトの色が設定されていない部分をクリックできます。ImplicitFunctionLine
オブジェクトがクリックに応答するか、先祖がクリックに応答するかは、HitTest
プロパティが決定します。
'none'
— マウス クリックをキャプチャしません。ImplicitFunctionLine
オブジェクトをクリックすると、Figure ウィンドウの現在のビュー内でその下にあるオブジェクトまでクリックが渡されます。HitTest
プロパティは無効になります。
HitTest
—キャプチャしたマウス クリックへの応答'on'
(既定値) |on/off logical 値キャプチャしたマウス クリックへの応答。'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
プロパティは無効です。
BeingDeleted
—削除状態このプロパティは読み取り専用です。
削除状態。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
—グラフィックス オブジェクトのタイプ'implicitfunctionline'
このプロパティは読み取り専用です。
グラフィックス オブジェクトのタイプ。'implicitfunctionline'
として返されます。プロット階層内にある特定のタイプのすべてのオブジェクトを検出するためにこのプロパティを使用できます。たとえばfindobj
を使用してタイプを検索します。
Tag
—オブジェクト識別子''
(既定値) |文字ベクトル|string スカラーオブジェクト識別子。文字ベクトルまたは string スカラーとして指定します。オブジェクトの識別子として機能する一意のTag
値を指定できます。コードの他の部分からオブジェクトにアクセスする必要がある場合、関数findobj
を使用してTag
値に基づいてオブジェクトを検索できます。
UserData
—ユーザー データ[]
(既定値) |配列ユーザー データ。任意の MATLAB 配列として指定します。たとえば、スカラー、ベクトル、行列、cell 配列、文字配列、table、または構造体を指定できます。このプロパティを使用して、任意のデータをオブジェクトに保存します。
App Designer を使用している場合は、UserData
プロパティを使用する代わりに、アプリでパブリック プロパティまたはプライベート プロパティを作成してデータを共有します。詳細については、App Designer アプリ内でのデータの共有を参照してください。
UIContextMenu
プロパティは非推奨R2020a 以降は非推奨
R2020a 以降、UIContextMenu
プロパティの設定または取得は推奨されていません。代わりに、ContextMenu
プロパティを使用してください。これは、UIContextMenu
プロパティと同じタイプの入力を受け入れ、同じように動作します。
現時点でUIContextMenu
プロパティを削除する予定はありませんが、関数set
、get
、またはproperties
をImplicitFunctionLine
オブジェクトで呼び出す際にリストされなくなりました。
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
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:.
Selectweb siteYou can also select a web site from the following list:
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.