15.3.3.2 Figure Properties

Last-modified: 2025-03-15 (土) 20:55:10

15.3.3.2 図のプロパティ

figureオブジェクトのプロパティ(図を参照):

カテゴリー:
Appearance | Callback Execution | Creation/Deletion | Display | Keyboard Interaction | Mouse Interaction | Object Identification | Object Position | Parent/Children | Printing/Saving | Unused

外観
alphamap: 64行1列の倍精度浮動小数点数型の定義
図形オブジェクトにはまだ透明度が実装されていません。 alphamap未使用です。

color: colorspec、定義[1 1 1]
図の背景の色。colorspec を参照してください。

colormap: N行3列の行列、定義64行3列の倍精度浮動小数点数型
現在の軸の RGB カラー マップを含む行列。

graphicssmoothing: "off"| { "on"}
スムージング技術を使用して、ギザギザの線を目立たなくします。

name: 文字列、定義""
図のタイトル バーに表示される名前。名前は、プロパティによって決定されたタイトルの右側に表示されますnumbertitle。

numbertitle: "off"| { "on"}
"Figure"図のタイトル バーに数値の図ハンドル値を 表示します。

コールバックの実行
busyaction: "cancel"| { "queue"}
別のオブジェクトの実行中のコールバックを中断できない場合に、Octave がこのオブジェクトのコールバック プロパティの実行をどのように処理するかを定義します。これは、現在実行中のコールバック オブジェクトのinterruptibleプロパティが に設定されている場合にのみ関係します"off"。busyaction中断しているコールバック オブジェクトのプロパティは、中断しているコールバックがキューに入れられているか ( "queue"(デフォルト))、破棄されているか ( "cancel") を示します。コールバックのセクションを参照してください。

interruptible: "off"| { "on"}
このオブジェクトのコールバック関数が他のコールバックによって中断されるかどうかを指定します。デフォルトではinterruptible、、、、または関数"on"を使用するコールバックは最終的に中断されます。コールバックのセクションを参照してください。 drawnowfigurewaitforgetframepause

作成/削除
beingdeleted: { "off"} | "on"
関数がオブジェクトの削除を開始したことを示すプロパティ。 beingdeletedオブジェクトが存在しなくなるまで true に設定されます。

closerequestfcn: 文字列 | 関数ハンドル、定義"closereq"
図形が削除されたときに実行される関数。closereq関数を参照してください。

グラフィックス リスナー関数の記述方法については、「コールバック」セクションを参照してください。

createfcn: 文字列 | 関数ハンドル、定義[](0x0)
図が作成された直後に実行されるコールバック関数。関数は、ルート オブジェクトの既定のプロパティを使用して設定されます (例: set (groot, "defaultfigurecreatefcn", 'disp ("figure created!")'))。

グラフィックス リスナー関数の記述方法については、「コールバック」セクションを参照してください。

deletefcn: 文字列 | 関数ハンドル、定義[](0x0)
図が削除される直前に実行されるコールバック関数。

グラフィックス リスナー関数の記述方法については、「コールバック」セクションを参照してください。

画面
visible: "off"| { "on"}
visibleの場合"off"、図は画面上にレンダリングされません。

windowstate: "fullscreen"| "maximized"| "minimized"| { "normal"}
ウィンドウの状態調整は、図オブジェクトに対してはまだ実装されていません。 windowstate未使用です。

windowstyle: "docked"| "modal"| { "normal"}
図のウィンドウ スタイル。次のいずれかの値になります。

normal
ウィンドウが選択解除され、他のウィンドウがウィンドウの前面に表示される場合があります。

modal
ウィンドウは、閉じられるまですべての通常の図形の上に表示されたままになります。

docked
実装されていません。

表示されている図形のモードを変更すると、図形が閉じて再度開く場合があります。

キーボード操作
keypressfcn: 文字列 | 関数ハンドル、定義[](0x0)
図にフォーカスがあるときにキーストローク イベントが発生したときに実行されるコールバック関数。実際に押されたキーは、関数の 2 番目の引数 'evt' を使用して取得できます。

グラフィックス リスナー関数の記述方法については、「コールバック」セクションを参照してください。

keyreleasefcn: 文字列 | 関数ハンドル、定義[](0x0)
ではkeypressfcn、キーボード コールバック関数が呼び出されます。これらのコールバック関数は、キーが押されたときと放されたときにそれぞれ呼び出されます。関数は 2 つの入力引数で呼び出されます。最初の引数は、呼び出し元の図形のハンドルを保持します。2 番目の引数は、次のメンバーを持つイベント構造を保持します。

Character:
キーのASCII値

Key:
キーの小文字の値

Modifier:
キーとともに押された修飾子を表す文字列を含むセル配列。

グラフィックス リスナー関数の記述方法については、「コールバック」セクションを参照してください。

windowkeypressfcn: 文字列 | 関数ハンドル、定義[](0x0)
キーが押され、図形にフォーカスがあるときに実行される関数。

グラフィックス リスナー関数の記述方法については、「コールバック」セクションを参照してください。

windowkeyreleasefcn: 文字列 | 関数ハンドル、定義[](0x0)
キーが放され、図形にフォーカスがあるときに実行される関数。

グラフィックス リスナー関数の記述方法については、「コールバック」セクションを参照してください。

マウス操作
buttondownfcn: 文字列 | 関数ハンドル、定義[](0x0)
グラフィックス リスナー関数の記述方法については、「コールバック」セクションを参照してください。

contextmenu: グラフィックハンドル、定義[](0x0)
現在この図オブジェクトに関連付けられている uicontextmenu オブジェクトのグラフィックス ハンドル。

currentpoint(読み取り専用): 2要素ベクトル、定義[0; 0]
マウス イベントが発生したときにマウス ポインターが置かれていた点の座標を保持する 1 行 2 列のベクトル。X 座標と Y 座標は図のunitsプロパティによって定義された単位で表され、その原点はプロット領域の左下隅です。

設定されるイベントcurrentpointは

マウスボタンが押されました
いつも

マウスボタンが放されました
フィギュアのコールバックwindowbuttonupfcnが定義されている 場合のみ

マウスボタンを押しながらポインタを移動しました(ドラッグ)
フィギュアのコールバックwindowbuttonmotionfcnが定義されている 場合のみ

hittest: "off"| { "on"}
図がマウス イベントを処理するか、オブジェクトの祖先に渡すかを指定します。有効にすると、オブジェクトは を評価し"buttondownfcn"、uicontextmenu を表示し、最終的にルート になることで、マウス クリックに応答します"currentobject"。このプロパティは、オブジェクトが によって決定されるマウス クリックを受け入れることができる場合にのみ関連します"pickableparts"。pickablepartsプロパティを参照してください。

menubar: { "figure"} | "none"
図の上部にある図メニュー バーの表示を制御します。

pointer: { "arrow"} | "botl"| "botr"| "bottom"| "circle"| "cross"| "crosshair"| "custom"| "fleur"| "hand"| "ibeam"| "left"| "right"| "top"| "topl"| "topr"| "watch"
図のキャンバスに関連付けられたマウス ポインターの形状の名前。pointerが の場合"custom"、形状はpointershapecdataプロパティによって決定されます。

pointer図がズーム、パン、または回転モードのときは効果がありません。この場合、Octave はモードに適したポインターの形状を自動的に使用します。

pointershapecdata: 16行16列または32行32列の行列、定義: 16行16列の倍精度浮動小数点数型
カスタム ポインターを定義する m 行 m 列の行列。各要素はピクセルを定義し、要素 (1,1) は左上のピクセルを表します。値 1 は黒色、値 2 は白色、その他の値は透明としてレンダリングされます。

pointershapehotspot: 2要素ベクトル、定義[1 1]
カスタム ポインターの場合、ポインターの位置として使用される pointershapehotspotピクセルの行と列のみを定義します。pointershapecdata

resize: "off"| { "on"}
マウスを使用してウィンドウの境界と角をドラッグして図のサイズを変更できるかどうかを制御します。マウス操作が無効になっている場合resizeでも、プロパティ"off"を変更することで図のサイズを変更できます"position"。

resizefcn: 文字列 | 関数ハンドル、定義[](0x0)
resizefcnは非推奨です。sizechangedfcn代わりに を使用してください。

selected: { "off"} | "on"
プロパティは、この図が選択されているかどうかを示します。

selectionhighlight: "off"| { "on"}
selectionhighlightの場合"on"、図形の選択状態が視覚的に強調表示されます。

selectiontype: "alt"| "extend"| { "normal"} | "open"
最後のマウスクリックの選択タイプ。

selectiontype使用されたマウス ボタンとキーボード修飾子の組み合わせに応じて、異なる値になる場合があります。

normal:
左クリックします。

alt:
右クリックまたはCtrl+左クリックします。

extend:
Shift キーを押しながら左クリック、中クリック、または左クリックと右クリックの組み合わせ。

open:
左クリックをダブルクリックします。

sizechangedfcn: 文字列 | 関数ハンドル、定義[](0x0)
図のウィンドウ サイズが変更されたときにトリガーされるコールバック。

グラフィックス リスナー関数の記述方法については、「コールバック」セクションを参照してください。

toolbar: { "auto"} | "figure"| "none"
ツールバー (メニューバーの下部) とステータス バーの表示を制御します。 に設定すると"auto"、表示はプロパティの値に基づいて行われます"menubar"。

windowbuttondownfcn: 文字列 | 関数ハンドル、定義[](0x0)
windowbuttonupfcn プロパティを参照してください。

windowbuttonmotionfcn: 文字列 | 関数ハンドル、定義[](0x0)
windowbuttonupfcn プロパティを参照してください。

windowbuttonupfcn: 文字列 | 関数ハンドル、定義[](0x0)
windowbuttondownfcnおよびではwindowbuttonmotionfcn、マウス コールバック関数が呼び出されます。これらのコールバック関数は、マウス ボタンが押されたとき、ドラッグされたとき、または放されたときにそれぞれ呼び出されます。これらのコールバック関数が実行されると、currentpointプロパティはカーソルの現在の座標を保持します。

グラフィックス リスナー関数の記述方法については、「コールバック」セクションを参照してください。

windowscrollwheelfcn: 文字列 | 関数ハンドル、定義[](0x0)
ユーザーがこの図形の上でマウス ホイールを操作したときに実行される関数。この関数は 2 つの入力引数で呼び出されます。最初の引数は呼び出し元の図形のハンドルを保持します。2 番目の引数は、次のメンバーを持つイベント構造を保持します。

VerticalScrollCount:
ホイールのステップ数。通常、下にスクロールする場合は 1、上にスクロールする場合は -1 になります。

VerticalScrollAmount:
ホイール ステップでスクロールする行数。この値は常に 3 です。

EventName:
イベント名は です"WindowScrollWheel"。

グラフィックス リスナー関数の記述方法については、「コールバック」セクションを参照してください。

オブジェクトの識別
currentaxes: グラフィックハンドル、定義[](0x0)
現在の軸のグラフィックス オブジェクトへのハンドル。

currentcharacter(読み取り専用): 定義""
最後に押されたキーの追跡は、図オブジェクトにはまだ実装されていません。 currentcharacter未使用です。

currentobject(読み取り専用): グラフィックス ハンドル、定義[](0x0)
図内の最後にアクティブになったグラフィック オブジェクトへのハンドル。

integerhandle: "off"| { "on"}
次に小さい未使用の整数を図番号として割り当てます。

nextplot: { "add"} | "new"| "replace"| "replacechildren"
nextplot高レベルのプロット関数によって使用され、図にすでに存在する軸をどのように処理するかを決定します。newplot関数を参照してください。

number(読み取り専用): double
現在のフィギュアの番号。

tag: 文字列、定義""
グラフィック オブジェクトにラベルを付けるユーザー定義の文字列。

type(読み取り専用):文字列
グラフィックス オブジェクトのクラス名。 type常に です"figure"。

userdata: 任意のオクターブデータ、定義[](0x0)
グラフィック オブジェクトに関連付けるユーザー定義データ。

オブジェクトの位置
dockcontrols: "off"| { "on"}
インタラクティブな図のドッキングは、図オブジェクトにはまだ実装されていません。 dockcontrols未使用です。

innerposition: 4要素ベクトル、定義[300 200 560 420]
プロパティは プロパティ"innerposition"と同じです。 "position"

outerposition: 4要素ベクトル、定義[-1 -1 -1 -1]
上部のメニューバーと下部のステータスバーを含む図の位置とサイズを指定します。ベクトルの 4 つの要素は、図の左下隅の座標と幅と高さです。unitsプロパティを参照してください。

position: 4要素ベクトル、定義[300 200 560 420]
図キャンバスの位置とサイズを指定します。ベクトルの 4 つの要素は、図の左下隅の座標と幅と高さです。unitsプロパティを参照してください。

units: "centimeters"| "characters"| "inches"| "normalized"| { "pixels"} | "points"
位置および外側位置プロパティを計算するために使用される単位。

親/子
children(読み取り専用): グラフィックス ハンドルのベクトル、定義[](0x1)
フィギュアの子のグラフィック ハンドル。

handlevisibility: "callback"| "off"| { "on"}
handlevisibilityの場合"off"、図形のハンドルは親の"children"プロパティでは表示されません。

parent: グラフィックハンドル、定義0
親グラフィック オブジェクトのハンドル。

印刷/保存
filename: 文字列、定義""
プロット図を保存するときに使用するファイル名。

inverthardcopy: "off"| { "on"}
印刷時に図と軸の背景色を白に置き換えます。

paperorientation: "landscape"| { "portrait"}
papersize、 、 の各プロパティの値はpaperpositionによって異なります。がと の間で切り替えられると、とpaperorientationの水平値と垂直値は逆の順序になります。 papersizepaperpositionpaperorientation"portrait""landscape"

paperposition: 4要素ベクトル、定義[1.3422 3.3191 5.8156 4.3617]
[left bottom width height]印刷ページ上の図の位置とサイズ (単位) を定義するベクトルpaperunits。位置は[left bottom]ページ上の図の左下隅を定義し、サイズは によって定義されます[width height]。出力形式が暗黙的に用紙にレンダリングされない場合、widthおよび はheight画像のサイズを定義し、位置情報は無視されます。 を設定すると、 プロパティpaperpositionも に強制的にpaperpositionmode設定されます"manual"。

paperpositionmode: { "auto"} | "manual"
paperpositionmodeが に設定されている場合"auto"、paperpositionプロパティは自動的に計算されます。印刷される図は画面上の図と同じサイズになり、出力ページの中央に配置されます。paperpositionmodeを に設定しても、 プロパティ"auto"の値は変更されませんpaperposition。

papersize: 2要素ベクトル、定義[8.5000 11.0000]
[width height]印刷用紙のサイズを定義するベクトル。papersizeプロパティを、定義されている の 1 つに関連付けられておらず、 のpapertypes設定と一致しない値に設定するとpaperorientation、papertypeプロパティは値 に強制的に設定されます"<custom>"。 が、papersizeサポートされている に関連付けられておりpapertype、 と一致する値に設定されている場合paperorientation、 のpapertype値は関連付けられた値に変更されます。

papertype: "<custom>"| "a"| "a0"| "a1"| "a2"| "a3"| "a4"| "a5"| "arch-a"| "arch-b"| "arch-c"| "arch-d"| "arch-e"| "b"| "b0"| "b1"| "b2"| "b3"| "b4"| "b5"| "c"| "d"| "e"| "tabloid"| "uslegal"| { "usletter"}
印刷出力に使用する用紙の名前。プロパティとの一貫性を保ちながら設定papertypeも変更されます。 papersizepaperorientation

paperunits: "centimeters"| { "inches"} | "normalized"| "points"
プロパティを計算するために使用される単位paperposition。物理単位 (例: ) からの変換は、ルート オブジェクトのプロパティ "inches"に依存します。screenpixelsperinch

renderer: { "opengl"} | "painters"
renderermodeが の場合に印刷に使用されるレンダリング エンジン"manual"。 を設定すると、プロパティrendererも に強制的にrenderermode設定されます"manual"。

renderermode: { "auto"} | "manual"
印刷に使用するレンダリング エンジンを自動的に選択するか、rendererプロパティで指定するかを制御します。印刷機能を参照してください。

未使用
clipping: "off"| { "on"}
clipping未使用です。

pickableparts(読み取り専用): "all"| "none"| { "visible"} ¶
pickableparts未使用です。