linkprop
グラフィックス オブジェクトの対応するプロパティと同じ値の保持
構文
hlink = linkprop(obj_handles,'PropertyName') hlink = linkprop(obj_handles,{'PropertyName1','PropertyName2',...})
説明
異なるグラフィックス オブジェクト間で対応するプロパティと同じ値を保持するには、関数 linkprop
を使用します。
メモ
linkprop
はグラフィックス オブジェクトにのみ使用します。
hlink = linkprop(obj_handles,'
は、PropertyName
') obj_handles
で表されるハンドルのすべてのオブジェクト上の PropertyName
プロパティと同じ値を保持します。関数 linkprop
は、hlink
にリンク オブジェクトを返します。詳細については、リンク オブジェクトについてを参照してください。
hlink = linkprop(obj_handles,{'
は、PropertyName1
','PropertyName2
',...})obj_handles
で表されるハンドルのすべてのオブジェクト上で、cell 配列に渡されるすべてのプロパティに対して同じ値をそれぞれ保持します。
linkprop
が呼び出されると、MATLAB® は、すべてのリンク オブジェクトのリンクされているプロパティを直ちに更新します。リスト obj_handles
の最初のオブジェクトは、残りのオブジェクトのプロパティ値を決定します。
一連のグラフィックス オブジェクトは、これらのオブジェクトのプロパティを接続するリンク オブジェクトを一度に 1 つのみもつことができます。linkprop
を呼び出すと新しいリンク オブジェクトが 1 つ作成されます。この新しいリンク オブジェクトによって、obj_handles
で指定されたオブジェクトに関連付けられている任意の既存のリンク オブジェクトが置き換えられます。ただし、リンクするプロパティとオブジェクトはそのオブジェクトでメソッドを呼び出すことで管理できます。
リンクされたオブジェクトのリストにオブジェクトを追加するには、
addtarget
メソッドを使用します。現在リンクされているオブジェクトの新しいプロパティをリンクするには、
addprop
メソッドを使用します。オブジェクトのリンクを停止するには、
removetarget
メソッドを使用します。プロパティのリンクを停止するには、
removeprop
メソッドを使用します。
リンク オブジェクトについて
linkprop
が返すリンク オブジェクトには、さまざまなグラフィックス オブジェクトのプロパティをリンクする仕組みが格納されています。そのため、リンク オブジェクトは、(ユーザーがコマンド ラインや Figure ツールからオブジェクトを対話型で操作する場合のベース ワークスペースのように) プロパティのリンクを行う場所にある必要があります。
以下のリストは、リンク オブジェクトの参照を保持する方法を説明します。
関数からの出力引数としてリンク オブジェクトを返し、リンク オブジェクトを対話型で操作する間は、それをベース ワークスペースに保持します。
変数
hlink
をグローバルにします。オブジェクトの
UserData
プロパティまたはアプリケーションデータ内に、変数hlink
を保持します。
リンク オブジェクトの更新
リンクされたグラフィックス オブジェクトまたはプロパティのいずれかを変更する場合は、その目的のために構築されたリンク オブジェクト メソッドを使用する必要があります。これらのメソッドは、リンク オブジェクト上でのみ動作する関数です。これらを使用するには、関数 linkprop
を使用して、はじめにリンク オブジェクトを作成しなければなりません。
メソッド | 目的 |
---|---|
addtarget | 指定されたグラフィックス オブジェクトをリンク オブジェクトのターゲットに追加します。 |
removetarget | 指定されたグラフィックス オブジェクトをリンク オブジェクトのターゲットから消去します。 |
addprop | リンクされたプロパティへ指定されたプロパティを追加します。 |
removeprop | リンクされたプロパティから指定されたプロパティを消去します。 |
メソッド構文
addtarget(hlink,obj_handles) removetarget(hlink,obj_handles) addprop(hlink,'PropertyName') removeprop(hlink,'PropertyName')
メソッドの引数
hlink
— 次によって返されるリンク オブジェクト:linkprop
obj_handles
— 1 つ以上のグラフィックス オブジェクトのハンドルPropertyName
— すべてのターゲット オブジェクトに共通するプロパティ名
例
バージョン履歴
R2006a より前に導入
参考
getappdata
| ishghandle
| linkaxes
| linkdata
| setappdata