主要内容

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

uicontrol

ユーザーインターフェイスコントロールの作成

この関数は,関数数字,または指导を使用して作成されたアプリでのみ使用します。程序设计师はアプリ構築のための推奨環境です。詳細については,指导の移行策を参照してください。

説明

c = uicontrolはプッシュボタン(既定のユーザーインターフェイスコントロール)を現在の图内に作成し,UIControlオブジェクトを返します。数字が存在しない場合は、MATLAB®が関数数字を呼び出して图を作成します。

c = uicontrol (名称,值は1つ以上の名前と値のペアの引数を使用して,指定されたプロパティ値をもつユーザーインターフェイスコントロールを作成します。たとえば,“风格”,“复选框”はチェックボックスを作成します。

c = uicontrol (は,現在の图に既定で作成するのではなく,指定した親に既定のユーザーインターフェイスコントロールを作成します。

c = uicontrol (名称,值は,ユーザーインターフェイスコントロールの親と,1つ以上の名前と値のペアの引数を指定します。

uicontrol (cは,事前定義のユーザーインターフェイスコントロールにフォーカスを移します。

すべて折りたたむ

名前と値のペアの引数“风格”“radiobutton”として指定することで,ラジオボタンを作成します。名前と値のペアの引数“字符串”の値を指定することで,そのラジオボタンにラベルを付けます。

c = uicontrol (“风格”“radiobutton”“字符串”选项1的);

图とその内部に配置されたパネルを作成します。続いて,そのパネルを親に指定し“风格”“滑块”に指定して関数uicontrolを呼び出すことで,パネル内にスライダーを作成します。次に,スライダーの价值プロパティを0.5に設定します。

f =图;p = uipanel (f,“位置”,[0.1 0.1 0.35 0.65]);c = uicontrol (p,“风格”“滑块”);c.Value = 0.5;

クリックすると選択肢のリストが表示されるポップアップメニューを作成します。コールバック関数を使用して,ユーザーの選択したリスト項目を決定し,MATLABコマンドウィンドウに選択内容を表示します。

mytemps.mとしてこのコードを保存します。このコードにより3つのリスト項目を含むポップアップメニューをもった图ウィンドウが作成されます。続いて,コールバック関数を使用してポップアップメニューの价值プロパティと字符串プロパティがクエリされ,選択した項目がコマンドラインに表示されます。

函数Mytemps f = figure;c = uicontrol (f,“风格”“popupmenu”);c.头寸= [20 75 60 20];c.String = {“摄氏度”“开”“华”};c.Callback = @selection;函数select (src,event) val = c.Value;str = c.String;str {val};disp ([的选择:str {val}]);结束结束

プログラムを実行して,图とそのコンテンツを生成します。

mytemps

別のメニュー項目を選択して,選択内容を変更します。たとえば,ポップアップ メニューで [Kelvin] を選択すると、コマンド ラインには选择:开尔文というテキストが表示されます。

クリックするとデータがプロットされるプッシュボタンを作成します。

pushbuttonPlot.mとしてこのコードを保存します。このコードにより,座標軸とプッシュボタンの含まれる图ウィンドウが作成されます。ボタンをクリックするたびにコールバック関数が実行され,正規分布した5つの乱数の棒グラフがプロットされます。

函数pushbuttonPlot = figure;ax =轴(f);斧子。单位=“像素”;斧子。Position = [75 75 325 280] c = uicontrol;c.String =“阴谋数据”;c.Callback = @plotButtonPushed;函数plotButtonPushed (src、事件)栏(randn(1、5));结束结束

pushbuttonPlotを実行し,プッシュボタンをクリックします。MATLABがデータをプロットします。

編集可能なテキストフィールドを作成し,その関数ハンドルを関数uicontrolに渡すことによってフォーカスします。このアクションにより,編集可能なテキストフィールド内でカーソルがアクティブになり,点滅します。

c = uicontrol (“风格”“编辑”);uicontrol (c);

入力引数

すべて折りたたむ

親オブジェクト。関数数字を使用して作成された数字オブジェクト,またはその子コンテナー(面板ButtonGroup,または选项卡オブジェクト)のいずれかとして指定します。この引数を使用して,ユーザーインターフェイスコントロールを作成する際に親コンテナーを指定します。

ユーザーインターフェイスコントロールオブジェクト。UIControlオブジェクトとして指定します。この引数を使用して,フォーカス対象とする事前定義のユーザーインターフェイスコントロールを指定します。

例:uicontrol (c)

名前と値のペアの引数

オプションの名称,值の引数ペアをコンマ区切りで指定します。的名字は引数名で,价值は対応する値です。的名字は引用符で囲まなければなりません。Name1, Value1,…,的家のように,複数の名前と値のペアの引数を任意の順序で指定できます。

例:uicontrol(“风格”,“复选框”)は,ユーザーインターフェイスコントロールのスタイルとしてチェックボックスを指定します。

メモ

ここでは,プロパティの一部だけを紹介しています。完全な一覧については,UIControlのプロパティを参照してください。

UIControlオブジェクトのスタイル。次の表の値として指定します。

风格プロパティ値 説明
“按钮” 按钮 マウスボタンが離されるまで,押し下げられたままになるボタン。
“togglebutton”

选择开关按钮
清除开关按钮

プッシュボタンと似た外観をもつ,オンまたはオフの状態を視覚的に示すボタン。
“复选框”

选中复选框
清除复选框

独自にオンまたはオフにすることが可能なオプション。
“radiobutton”

选择单选按钮
清除单选按钮

グループの一部を形成して,オンにするとグループ内の他のオプションがオフになるよう意図されたオプション。


ラジオボタンのセットの相互に排他的な動作を実装するには,それらのラジオボタンを1つのuibuttongroup内に配置します。

“编辑”

可编辑的文本框,显示“输入搜索词”

編集可能なテキストフィールド。


複数行のテキストを有効にするには,马克斯最小值のプロパティを不等式性质> 1になるように設定します。

“文本”

静态文本框,表示“选择下面的项目:”

スタティックテキストフィールド。スタティックテキストを使用して,他のユーザーインターフェイスコントロールにラベルを付け,ユーザーに情報を提供し,あるいはスライダーに関連付けられた値を示します。


スタティックテキストをマウスクリックに応答させるには,启用プロパティを“不活跃”に設定し,ButtonDownFcnコールバックを使って応答をコーディングします。

“滑块”

滑块与拇指在最左边的位置

ユーザーが横または縦のバーに沿って動かす”つまみ”ボタン。バーに沿ったボタンの位置は,指定範囲内の値を示します。

列表框的

列表框中有三个项目

ユーザーが1つ以上の項目を選択できる項目のリスト。ポップアップメニューとは異なり,リストボックスはクリックされても展開しません。


項目の複数選択を可能にするには,马克斯最小值のプロパティを不等式性质> 1になるように設定します。リストボックスで複数項目を選択できる場合に動作を遅らせるために,[完了]プッシュボタンをリストボックスに関連付けることができます。その後,そのボタンのコールバックを使用して,リストボックスの价值プロパティを評価します。

“popupmenu”

弹出菜单有三个项目

選択肢のリストを表示するために展開されるポップアップメニュー(別名ドロップダウンメニュー)。ポップアップメニューは閉じられると,現在の選択を示します。いくつかの相互排他的な選択肢を提示する場合に,ポップアップメニューを使用します。

“帧” “帧”オプションは推奨されません。フレームの代わりに,uipanelまたはuibuttongroupを使用してください。引导はそれらを含むUIのフレームを引き続きサポートしますが,フレームのコンポーネントは,指导レイアウトエディターのコンポーネントパレットに表示されません。

表示するテキスト。文字ベクトル、文字ベクトルの细胞配列、字符串配列、categorical 配列、またはパイプ区切りの行ベクトルとして指定します。风格プロパティは,使用できる配列形式を決定します。

风格プロパティ サポートされる配列形式
“按钮”

文字ベクトル


文字ベクトルの细胞配列


字符串配列


绝对配列

选项1的


{'选项1}


”选项1”


分类({'选项1 '})

“togglebutton”
“复选框”
“radiobutton”
“编辑”
“文本”
列表框的

文字ベクトル


文字ベクトルの细胞配列


字符串配列


绝对配列


パイプ区切りの行ベクトル

“一个”


{“一”、“两个”,“三”}


(“一”“二”“三”)


分类({‘一个’,‘2’,‘三’})


‘1 | 2 | 3

“popupmenu”

メモ

プッシュボタン,トグルボタン,チェックボックス,またはラジオボタンについて细胞配列または直言配列を指定した場合,MATLABは配列内の最初の要素のみを表示します。

位置とサイズ。[左下角宽度高度]の形式の4要素ベクトルとして指定します。既定の測定単位はピクセルです。次の表では,ベクトルの各要素を説明します。

要素 説明
親コンテナーの内側左端からユーザーインターフェイスコントロールの外側左端までの距離。
親コンテナーの内側下端からユーザーインターフェイスコントロールの外側下端までの距離。
宽度 ユーザーインターフェイスコントロールの外側の右端と左端の間の距離。
高度 ユーザーインターフェイスコントロールの外側の上端と下端の間の距離。

位置の値の基準は,親コンテナーの描画可能領域です。描画可能領域は,コンテナーの境界線の内側にある領域で,タイトルが占める領域は含まれません。親コンテナーが图である場合は,メニューバーとツールバーも描画可能領域には含まれません。

現在の値。数値として指定します。特定のユーザー インターフェイス コントロールのステータスをクエリまたは変更するために使用します。次の表では、特定のUIControlスタイルと関連する价值プロパティを説明します。

风格プロパティ 价值プロパティの説明
“togglebutton”
  • オン:马克斯プロパティの値。

  • オフ:最小值プロパティの値。

“复选框”
  • オン:马克斯プロパティの値。

  • オフ:最小值プロパティの値。

“radiobutton”
  • オン:马克斯プロパティの値。

  • オフ:最小值プロパティの値。

“滑块” スライダーバーに沿ったつまみの位置に関連付けられた値。
列表框的 リストボックスで選択された項目に対応する配列インデックス。値1(既定)はリストの最初の項目に対応しています。複数の項目が選択されている場合,价值プロパティは行インデックスをベクトルとして保存します。
“popupmenu” ポップアップメニューで選択された項目に対応する配列インデックス。値1(既定)はポップアップメニューの最初の項目に対応しています。
R2006aより前に導入