このページは機械翻訳を使用して翻訳されました。最新版の英語を参照するには、ここをクリックします。

TurnCoordinator のプロパティ

ターンコーディネーターの外観と動作を制御する

このページをすべて展開する

ターン コーディネーターは、ターン コーディネーターを表すコンポーネントです。プロパティは、ターン コーディネーターの外観と動作を制御します。ドット表記を使用して、特定のオブジェクトとプロパティを参照します。

f = uifigure;
turn = uiaeroturn(f);
turn.Turn = 100;

ターンコーディネーターは、ターンコーディネーターと傾斜計の測定値を表示します。これらの測定値は、旋回が協調的であるか、滑っているか、横滑りしているかを判断するのに役立ちます。旋回は、旋回のローリングとヨーイングを組み合わせた協調旋回です。方向指示器信号は、ゲージ内で飛行機を度単位で回転させます。傾斜計はゲージ内のボールを度単位で回転させます。これらの信号を組み合わせると、飛行機が旋回するときに滑ったり横滑りしたりすることが分かります。傾斜角度の値は ±20 度に制限されます。スリップ値は ±15 度に制限されます。

旋回傾斜計

すべて展開する

スリップ値。任意の有限およびスカラー数値として指定されます。スリップ値は傾斜計ボールの方向を制御します。負の値はボールを右に移動し、正の値はボールを左に移動します (度単位)。この値は +/-15 度を超えることはできません。15 度を超えると、ゲージは最小値または最大値に固定されます。

例: 10

依存関係

この値を指定すると、Value ベクトルの 2 番目の要素が変更されます。逆に、Value ベクトルの 2 番目の要素を変更すると、Slip の値も変更されます。

データ型: double

回転速度の値。度単位の有限およびスカラー数値として指定されます。ゲージ内の航空機シンボルの傾斜度として旋回速度の値を入力します。標準速度ターンマークは±15度の角度にあります。傾斜角度の値は ±20 度に制限されます。

例: 10

依存関係

この値を指定すると、Value ベクトルの最初の要素が変更されます。逆に、Value ベクトルの最初の要素を変更すると、Turn の値も変更されます。

データ型: double

回転とスリップの値はベクトル ([Turn Slip]) として指定されます。

  • 旋回率の値は、航空機シンボルの傾きの度合いによって航空機の方向の変化率を示します。

  • スリップ値は傾斜計ボールの方向を制御します。負の値を指定するとボールは右に移動し、正の値を指定するとボールは左に移動します。

例: [15 0] は、協調された標準速度ターンを示します。

依存関係

  • Turn 値を指定すると、Value ベクトルの最初の要素が変更されます。逆に、Value ベクトルの最初の要素を変更すると、Turn の値も変更されます。

  • Slip 値を指定すると、Value ベクトルの 2 番目の要素が変更されます。逆に、Value ベクトルの 2 番目の要素を変更すると、Slip の値も変更されます。

データ型: double

対話機能

すべて展開する

ターンコーディネーターの可視性。'on' または 'off'、あるいは数値または論理値の 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' は false と等価です。したがって、このプロパティの値を logical 値として使用できます。この値は、matlab.lang.OnOffSwitchState 型の on/off の logical 値として格納されます。Visible プロパティは、ターンコーディネーターを画面に表示するかどうかを決定します。Visible プロパティが 'off' に設定されている場合、ターン コーディネーター全体は非表示になりますが、そのプロパティを指定してアクセスすることは可能です。

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

ターンコーディネーターの動作状態。'on' または 'off'、あるいは数値または論理の 1 (true) または 0 (false) として指定されます。'on' の値は true と等価であり、'off' は false と等価です。したがって、このプロパティの値を logical 値として使用できます。この値は、matlab.lang.OnOffSwitchState 型の on/off の logical 値として格納されます。

  • このプロパティを 'on' に設定すると、ターン コーディネーターの外観によって、ターン コーディネーターが動作中であることが示されます。

  • このプロパティを 'off' に設定すると、ターン コーディネーターの外観が淡色表示になり、ターン コーディネーターが動作していないことが示されます。

位置

すべて展開する

親コンテナーに対するターンコーディネーターの位置とサイズ。ベクトル [left bottom width height] として指定されます。次の表で、ベクトルの各要素について説明します。

要素説明
left親コンテナの内側の左端からターンコーディネータを囲む仮想ボックスの外側の左端までの距離
bottom親コンテナの内側の下端から、ターンコーディネータを囲む仮想ボックスの外側の下端までの距離
widthターンコーディネーターの右外縁と左外縁の間の距離
heightターンコーディネーターの上部と下部の外側の端の間の距離

すべての測定単位はピクセルです。

Position の値の基準は、親コンテナーの "描画可能領域" です。描画可能領域は、コンテナーの境界線の内側にある領域で、メニュー バーやタイトルなどの装飾が占める領域は含まれません。

例: [200 120 120 120]

ターンコーディネーターの内部位置とサイズ。[left bottom width height] として指定されます。位置の値の基準は親コンテナーです。すべての測定単位はピクセルです。このプロパティ値は、Position プロパティと同一です。

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

ターンコーディネーターの外側の位置とサイズが [left bottom width height] として返されます。位置の値の基準は親コンテナーです。すべての測定単位はピクセルです。このプロパティ値は、Position プロパティと同一です。

レイアウト オプション。GridLayoutOptions オブジェクトとして指定します。このプロパティは、グリッド レイアウト コンテナーの子であるコンポーネントのオプションを指定します。コンポーネントがグリッド レイアウト コンテナーの子ではない場合 (たとえば、Figure またはパネルの子である場合) は、このプロパティは空で、効果はありません。しかし、コンポーネントがグリッド レイアウト コンテナーの子である場合は、GridLayoutOptions オブジェクトの Row プロパティおよび Column プロパティを設定して、グリッドの目的の行と列にコンポーネントを配置することができます。

たとえば、このコードは、ターン コーディネーターを親グリッドの 3 行目と 2 列目に配置します。

g = uigridlayout([4 3]);
gauge = uiaeroturn(g);
gauge.Layout.Row = 3;
gauge.Layout.Column = 2;

ターンコーディネーターを複数の行または列にまたがらせるには、Row または Column プロパティを 2 要素のベクトルとして指定します。たとえば、次のターンコーディネータは列 2 から 3 までをカバーします。

gauge.Layout.Column = [2 3];

コールバック

すべて展開する

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

  • 関数ハンドル。

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

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

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

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

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

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

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

  • 関数ハンドル。

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

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

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

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

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

コールバック実行制御

すべて展開する

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

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

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

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

MATLAB は、コールバック キューを処理するコマンドを実行するたびにコールバックの割り込み動作を判別します。これらのコマンドには、drawnow、figure、uifigure、getframe、waitfor、pause があります。

実行中コールバックにこれらのコマンドが含まれていない場合、割り込みは発生しません。MATLAB は、実行中コールバックの実行を先に終了させ、その後に割り込みコールバックを実行します。

実行中コールバックにこれらのいずれかのコマンドが含まれている場合、実行中コールバックを所有するオブジェクトの Interruptible プロパティに応じて割り込みが発生するかどうかが決まります。

  • Interruptible の値が 'off' の場合、割り込みは発生しません。代わりに、割り込みコールバックを所有するオブジェクトの BusyAction プロパティに応じて、割り込みコールバックが破棄されるかコールバック キューに追加されるかが決まります。

  • Interruptible の値が 'on' の場合、割り込みが発生します。MATLAB は、コールバック キューの次回処理時に、実行中コールバックの実行を停止し、割り込みコールバックを実行します。割り込みコールバックが完了した後、MATLAB は実行中だったコールバックの実行を再開します。

メモ

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

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

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

  • 割り込みコールバックが Timer オブジェクトで所有されている場合、Interruptible プロパティの値にかかわらずスケジュールに従ってコールバックが実行されます。

メモ

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

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

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

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

BusyAction プロパティによってコールバック キューイングの動作が決まるのは、次の両方の条件を満たす場合のみです。

  • 実行中コールバックに drawnow、figure、uifigure、getframe、waitfor、pause などのコールバック キューを処理するコマンドが含まれている。

  • 実行中コールバックを所有するオブジェクトの Interruptible プロパティの値が 'off' である。

これらの条件に当てはまる場合、割り込みコールバックを所有するオブジェクトの BusyAction プロパティに応じて MATLAB による割り込みコールバックの処理方法が決まります。BusyAction プロパティは次の値を取ることができます。

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

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

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

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

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

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

親/子

すべて展開する

親コンテナー。関数 uifigure を使用して作成された Figure オブジェクト、またはその子コンテナー (Tab、Panel、ButtonGroup または GridLayout) のいずれかとして指定します。コンテナーが指定されていない場合、MATLAB は関数 uifigure を呼び出し、親コンテナーとして使用される新しい Figure オブジェクトを作成します。

オブジェクト ハンドルの可視性。'on'、'callback' または 'off' として指定します。

このプロパティは、オブジェクトの親がもつ子のリストにおけるそのオブジェクトの可視性を制御します。オブジェクトがその親オブジェクトのリストで、子として可視できない場合、オブジェクト階層の検索またはプロパティのクエリによってオブジェクトを取得する関数は、そのオブジェクトを返しません。これらの関数には、get、findobj、clf および close が含まれます。オブジェクトは参照できない場合も有効です。オブジェクトにアクセスできる場合は、そのプロパティを設定および取得して、それをオブジェクトに作用する任意の関数に渡すことができます。

HandleVisibility の値説明
'on' オブジェクトは常に参照できます。
'callback'オブジェクトはコールバック内から、あるいはコールバックにより呼び出される関数から参照できます。しかし、コマンド ラインから呼び出される関数からは参照できません。このオプションを使用すると、コマンド ラインからのオブジェクトへのアクセスがブロックされますが、コールバック関数からのアクセスは許可されます。
'off'オブジェクトは常に参照できません。このオプションは、他の関数による UI の意図しない変更を防止するために役立ちます。HandleVisibility を 'off' に設定すると、その関数の実行中にオブジェクトが一時的に非表示になります。

識別子

すべて展開する

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

グラフィックス オブジェクトのタイプ。'uiaeroturn' として返されます。

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

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

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

バージョン履歴

R2018b で導入

参考

トピック