uicontrol関数によるオブジェクトの作成

uicontrol関数を使ってコントロールオブジェクトを作成します。

uicontrol関数は複数の入力引数を取り、様々な関数、スタイル、形状、サイズのグラフィカルウィジェットを作成できます。uicontrolの入力引数を変更することで、さまざまなコントロールオブジェクトを作成できます。

次の表は、uicontrolコマンドで作成できるウィジェットタイプの詳細です。これらは、'style'引数とそれに続く各種スタイルプロパティ指定を含むuicontrolコマンドで作成されます。例えば、 uicontrol('style','pushbutton')uicontrol('style','edit') などがあります。

スタイルプロパティ 説明
pushbutton 押されることにより、ユーザー定義の操作が実行されます。
togglebutton

pushbuttonと同じように見えますが、押されたか押されていないかの状態を視覚的に示す役割を果たします。
checkbox ボタングループ内の1つまたは複数のチェックボックスの選択を提供します。
radiobutton ラジオボタンのグループから1つのボタンを選択できます。
edit テキスト情報を入力するための入力フィールドを作成します。
text uicontrolに引数として渡された定義済みのテキストを表示します。
slider

ドラッグして指定した範囲の値を選択するスライダーを作成します。
listbox 定義された項目のリストを表示し、そこから 1 つ以上の項目を選択できます。
popupmenu ポップアップメニューが表示されます。
各グラフィカルウィジェットは、複数の属性に関連付けられています。例えば、dimensionとstyleは、uicontrolオブジェクトに関連付けることができる多くの属性の1つです。有効な属性はすべて以下の表に記載されています:
スタイルプロパティ 引数 説明
units

pixels

normalized

単位は、グラフィカルオブジェクトの位置と寸法を表す測定単位です。

'pixel' 単位は0~1000の値をとり、'normalized'単位は0~1の値をとります。

position [0.6 0.16 0.4 0.4]

コントロールオブジェクトの位置とサイズを [left top width height] 形式のベクトルで指定します。例えば、normalized単位での値[0.6 0.16 0.4 0.4]は、0.6がオブジェクトの開始位置である左からの距離、0.16がオブジェクトの開始位置である上からの距離、0.4がオブジェクトの幅、0.4がオブジェクトの高さであることを示します。
value

1

-1

0

(integerまたはdouble)

スタイルプロパティの現在の値を指定します。例えば、チェックボックスやラジオボタンが選択されている場合は1、選択されていない場合は0となります。リストボックスの5番目のエントリが選択されている場合、値は '5' になります。
enable onまたはoff コントロールオブジェクトのプロパティが有効かどうかを指定します。
visible onまたはoff コントロールオブジェクトの可視性を指定します。
callback @callback_function_defined

(^この関数は2つの引数を取る必要があります)

クリックやウィジェットのアクションによって実行される関数を定義します。
string

文字列、セル、または

{'item1', 'item2'}

GUIに表示するテキストを指定します。
fontangle

regular

italic

表示されるフォントの角度を指定します。デフォルトの角度は'regular'です。
fontname

MS Shell Dlg

centuar

表示するフォントの名前を指定します。デフォルトの名前は 'MS Shell Dlg' です。
fontsize フォントサイズ数 表示されるフォントのサイズを指定します。デフォルトのサイズは8。
fontweight

normal

bold

表示されるフォントの太さを指定します。デフォルトは'normal'です。

ウィジェットの作成と呼び出しは以下のように行います:

  1. ポジションを割り当てた図のハンドルを作成します。
  2. 図にuipanelを追加し、プロット用のスペースを割り当てます。
  3. uipanelに必要なuicontrolオブジェクトを作成します。
  4. 各コントロールオブジェクトにそれぞれの属性を割り当てます。
  5. 各コントロールオブジェクトにコールバック関数を定義し、割り当てます。

次のコードを見て、作成された図形オブジェクトの位置と寸法を確認してください。位置は正規化された単位で定義されていることに注意してください。

f = figure('units','normalized','position',[0.2 0.3 0.6 0.7]);
 undock(f);


ここで、位置を [0 0 0.4 0.4]に変更し、再度コードを実行します。新しい位置引数に従って図の位置と寸法が変更されます。