主要内容

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

离散旋钮のプロパティ

離散型ノブの外観と動作の制御

離散型ノブは,離散集合からオプションを選択するためのUIコンポネントです。プロパティの値を変更することによって,離散型ノブの外観と動作を変更できます。ドット表記を使用して,特定のオブジェクトとプロパティを参照します。

图= ufigfig;K = uiknob(图,'discrete');k.Items ={'冻','冷','暖','热'};

ノブ

すべて展開する

値。项目またはItemsDataの配列の要素として指定します。既定では,价值项目の最初の要素になります。

价值项目の要素として指定すると,ノブのセレクタがノブの対応するラベルに設定されます。ItemsDataが空でない場合,价值ItemsDataの要素に設定しなければならず,ノブのセレクタは関連するラベルを指します。

ノブのオプション。文字ベクトルの cell 配列、string 配列、または 1 次元の categorical 配列として指定します。この配列は 2 つ以上の要素を含まなければなりません。ノブには项目の配列の要素数と同数のオプションが表示されます。オプションは時計回りの順で表示されます。このプロパティをcategorical 配列として指定した場合、MATLAB®はカテゴリの完全なセットではなく,配列内の値を使用します。

例:{‘Off’,‘慢’,‘快’}

例:{' 1 ', ' 2 ', ' 3 ', ' 4 '}

项目プロパティ値の各要素に関連付けるデタ。1行n列の数値配列または1行n列のcell配列として指定します。ItemsData値に重複する配列要素を指定できます。

ItemsData项目の配列要素数が一致しない場合,次のようになります。

  • ItemsData値が空の場合,项目のすべての要素がアプリユザに表示されます。

  • ItemsData値の要素数が项目値の要素数よりも多い場合,项目のすべての要素がアプリユザに表示され,matlabはItemsDataの余分な要素を無視します。

  • ItemsData値の要素数が项目値の要素数よりも少ない(ただし,ゼロより大きい)場合,対応するItemsData値をもemf项目の要素のみがアプリユザに表示されます。

例:{'一' '二' '三'}

例:{10 20 30 40}

フォント

すべて展開する

フォント名。システムでサポトされているフォント名として指定します。既定のフォントは,特定のオペレティングシステムとロケルによって異なります。

指定したフォントが利用できない場合,MATLABは,アプリが実行中のシステムで利用可能なフォントから最もよく一致するフォントを使用します。

例:“天线”

フォントサ邮箱ズ。正の数値として指定します。測定単位はピクセルです。既定のフォント サイズは、特定のオペレーティング システムとロケールによって異なります。

例:14

フォントの太さ。次のいずれかの値として指定します。

  • “正常”-各フォントで定義されている既定の太さ

  • “大胆”- - - - - -“正常”よりも太い文字

すべてのフォントに太字フォントがあるとは限りません。そのため,太字フォントを指定しても標準フォントの太さと変わらない場合があります。

フォントの角度。“正常”または“斜体”として指定します。このプロパティを斜体に設定すると,アプリユ。

フォントの色。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” [10 0 0] “# FF0000”

“绿色” ‘g’ [0 1 0] “# 00 ff00”

“蓝” “b” [0 0 1] “# 0000 ff”

“青色” “c” [0 1 1] “# 00飞行符”

“红色” “米” [10 0 1] “#就”

“黄色” “y” [1 1 0] “# FFFF00”

“黑” “k” [0 0 0] # 000000的

“白色” ' w ' [1,1 1] “# FFFFFF”

MATLABの多くのタイプのプロットで使用されている既定の色のRGB 3成分および16進数カラーコードを次に示します。

RGB 3成分 16進数カラコド 外観
[0 0.4470 0.7410] “# 0072 bd”

[0.8500 0.3250 0.0980] “# D95319”

[0.9290 0.6940 0.1250] “# EDB120”

[0.4940 0.1840 0.5560] “# 7 e2f8e”

[0.4660 0.6740 0.1880] “# 77 ac30”

[0.3010 0.7450 0.9330] “# 4 dbeee”

[0.6350 0.0780 0.1840] “# A2142F”

対話機能

すべて展開する

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

  • “上”-オブジェクトを表示します。

  • “关闭”-オブジェクトを削除せずに非表示にします。非表示のUIコンポコンポネントのプロパティには引き続きアクセスできます。

アプリの起動を高速化するには,起動時に表示する必要のないすべてのUIコンポネントの可见プロパティを“关闭”に設定します。

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

  • このプロパティを“上”に設定した場合,アプリユザはコンポネントを操作できます。

  • このプロパティを“关闭”に設定した場合,コンポネントはグレ表示されます。これは,アプリユーザーがコンポーネントを操作することができず,コンポーネントはコールバックをトリガーしないことを示します。

ルヒント。文字ベクトル、文字ベクトルの细胞配列,字符串配列,または1次元の直言配列として指定します。このプロパティを使用して,実行時にユーザーがポインターをコンポーネントに合わせるとメッセージが表示されるようにします。コンポネントが無効になっている場合でも,ルヒントは表示されます。複数行のテキストを表示するには,文字ベクトルの细胞配列または字符串配列を指定します。配列の各要素は,テキストの各行になります。このプロパティをcategorical 配列として指定した場合、MATLAB はカテゴリの完全なセットではなく、配列内の値を使用します。

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

位置

すべて展開する

状態マクと状態ラベルを除いたノブの位置とサ。ベクトル[左底宽高]として指定します。次の表で,ベクトルの各要素にいて説明します。

要素 説明
親コンテナの内側左端からノブの外側左端までの距離
親コンテナの内側下端からノブの外側下端までの距離
宽度 目盛りとラベルを除いたノブの外側の右端と左端の間の距離
高度 目盛りとラベルを除いたノブの外側の上端と下端の間の距離

すべての測定単位はピクセルです。縦横比の制約があるため,ノブの高さと幅を相互に独立して変更することはできません。ノブのサズを大きくするには,位置(3:4)=[宽度-高度]を使用して幅と高さを設定します。

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

例:[100 200 60 60]

状態マクと状態ラベルを除いたノブの内側の位置とサ。ベクトル[左底宽高]として指定します。位置の値の基準は親コンテナーです。すべての測定単位はピクセルです。このプロパティ値は、ノブ コンポーネントの位置と同一です。

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

状態マクと状態ラベルを含めたノブの外側の位置とサ。ベクトル[左底宽高]として返されます。位置の値の基準は親コンテナーです。すべての測定単位はピクセルです。

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

たとえば,以下のコドは,離散型ノブをその親グリッドの3行目の2列目に配置します。

G = uigridlayout([4 3]);K = uiknob(g,“离散”);k.Layout.Row = 3;k.Layout.Column = 2;

ノブが複数の行または列にまたがるようにするには,またはプロパティを2要素ベクトルとして指定します。たとえば,次のノブは2列目から3.列目にまたがります。

k.Layout.Column = [2 3];

コルバック

すべて展開する

値が変更されたときのコルバック。次の値のいずれかとして指定します。

  • 関数ハンドル。

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

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

このコルバックは,ユ。价值プロパティがプログラムにより変更される場合にはコルバックは実行されません。

このコルバックは,ユのノブ操作に関する特定の情報にアクセスできます。Matlabは,この情報をValueChangedDataオブジェクトに格納して,2番目の引数としてコルバック関数に渡します。App Designerでは,引数は事件と呼ばれます。ドット表記を使用して,オブジェクトのプロパティをクエリできます。たとえば,事件。PreviousValueはノブの直前の値を返します。ValueChangedDataオブジェクトは,文字ベクトルとして指定されているコルバック関数では使用できません。

次の表に,ValueChangedDataオブジェクトのプロパティを示します。

プロパティ
价值 アプリユザによる最新操作の後のノブの値。
PreviousValue アプリユザによる最新操作の前のノブの値。
コルバックを実行するコンポネント。
EventName “ValueChanged”

コルバックの記述の詳細にいては,App Designerでコルバックを記述するを参照してください。

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

  • 関数ハンドル。

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

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

コルバックを関数ハンドル,单元格配列,または文字ベクトルとして指定する方法の詳細にいては,App Designerでコルバックを記述するを参照してください。

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

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

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

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

  • 関数ハンドル。

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

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

コルバックを関数ハンドル,单元格配列,または文字ベクトルとして指定する方法の詳細にいては,App Designerでコルバックを記述するを参照してください。

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

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

コルバック実行制御

すべて展開する

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

このプロパティは実行中のコルバックが割り込み可能かどうかを決定します。次の2のコルバックの状態に。

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

  • “割り込み”コルバックは,実行中のコルバックです。

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

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

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

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

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

メモ

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

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

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

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

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

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

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

  • “割り込み”コルバックは,実行中のコルバックです。

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

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

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

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

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

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

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

親/子

すべて展開する

親コンテナ。関数uifigureを使用して作成された数字オブジェクト,またはその子コンテナ选项卡面板ButtonGroupまたはGridLayoutのいずれかとして指定します。コンテナが指定されていない場合,matlabは関数uifigureを呼び出し,親コンテナとして使用される新しい数字オブジェクトを作成します。

オブジェクトハンドルの可視性。“上”“回调”または“关闭”として指定します。

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

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

識別子

すべて展開する

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

グラフィックスオブジェクトのタ邮箱プ。“uidiscreteknob”として返されます。

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

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

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

参考

関数

R2016aで導入