主要内容

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

集团のプロパティ

团体オブジェクトの外観と動作

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

g = hggroup;c = g.Children;g.Visible =“关闭”;

凡例

すべて展開する

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

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

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

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

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

  • “孩子”——オブジェクトの子のみを個別の項目として凡例に含めます。

対話機能

すべて展開する

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

  • “上”- - - - - -集团オブジェクト内のすべてのオブジェクトを表示します。

  • “关”- - - - - -集团オブジェクト内のすべてのオブジェクトを非表示にします。非表示の集团オブジェクトのプロパティに引き続きアクセスできます。集团オブジェクトの看得见的プロパティを設定しても集团オブジェクト内のオブジェクトの看得见的プロパティは変更されません。

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

メモ

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

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

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

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

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

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

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

コールバック

すべて展開する

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

  • 関数ハンドル

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

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

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

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

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

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

メモ

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

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

  • 関数ハンドル。

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

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

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

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

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

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

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

  • 関数ハンドル。

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

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

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

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

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

コールバック実行制御

すべて展開する

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

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

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

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

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

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

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

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

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

メモ

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

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

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

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

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

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

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

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

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

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

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

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

  • “可见的”— 自身の易损件プロパティの値に応じて、子オブジェクトはマウス クリックをキャプチャできます。

  • “没有”——子の易损件プロパティの値にかかわらず、どの子オブジェクトもマウス クリックをキャプチャできません。

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

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

  • “关”- - - - - -集团オブジェクトのコールバックをトリガーしません。代わりに,HitTestプロパティが“上”に設定され,マウスクリックをキャプチャできる易损件プロパティ値をもつ、最も近い先祖のコールバックをトリガーします。

集团オブジェクトはマウスクリックをキャプチャしません。しかし,集团オブジェクトの子がクリックされ、子のHitTestプロパティが“关”に設定されている場合,子はクリックを集团オブジェクトに渡します。

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

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

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

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

親/子

すべて展開する

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

子。グラフィックス オブジェクトの配列として返されます。このプロパティは、子のリストの参照や子の並べ替えに使用します。子を並べ替えるには、このプロパティ自体で値の順序を並べ替えます。

孩子们プロパティを使用して子の追加や削除を行うことはできません。このリストに子を追加するには,子グラフィックスオブジェクトの父母亲プロパティにこの集团オブジェクトを設定します。

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

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

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

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

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

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

識別子

すべて展開する

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

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

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

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

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

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

すべて展開する

R2020a以降は非推奨

R2006aより前に導入