最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

uifigure

App Designer でのアプリ設計用の Figure の作成

構文

f = uifigure

f = uifigure(Name,Value)

説明

f = uifigure はユーザー インターフェイス作成用の Figure を作成し、Figure オブジェクトを返します。これは、App Designer で使用されるタイプの Figure です。

f = uifigure(Name,Value) は、1 つ以上の Name,Value のペアの引数を使用して、Figure のプロパティを指定します。

例

既定の UI Figure を作成

f = uifigure;

プロパティの設定とアクセス

指定したタイトルをもつ UI figure を作成します。

f= uifigure('Name','Plotted Results');

Position プロパティの値を取得します。

p = f.Position

ans =

   680   678   560   420

UI Figure を閉じる際に確認する CloseRequestFcn のコードを記述

ユーザーがウィンドウを閉じようとしたときにモーダルの [Confirmation] ダイアログ ボックスを開くように、CloseRequestFcn コールバックのコードを記述します。

次のコードをコピーして MATLAB^® エディターに貼り付けてから、closeFig を実行します。

function closeFig
f = uifigure('Position',[100 100 350 275],...
    'CloseRequestFcn',@(f, event)my_closereq(f));
end
function my_closereq(f)
selection = questdlg('Close the figure window?',...
    'Confirmation',...
    'Yes','No','Yes');
switch selection,
    case 'Yes',
        delete(f)
    case 'No'
        return
end
end

Figure の閉じるボタンをクリックします。[Confirmation] ダイアログ ボックスが開きます。

入力引数

名前と値のペアの引数

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

例: 'Name','My App' は UI figure のタイトルとして My App を指定します。

以下にリストするプロパティは、利用できるプロパティの一部です。完全なリストについては、UI Figure のプロパティ を参照してください。

'Name' — 名前

'' (既定値) | 文字ベクトル | string スカラー

Figure の名前。文字ベクトルまたは string スカラーとして指定します。

例: uifigure('Name','Results') は、Figure の名前を 'Results' に設定します。

'Position' — UI figure の位置とサイズ。境界とタイトル バーは除外します。

[left bottom width height]

UI figure の位置とサイズ。境界とタイトル バーは除外します。[left bottom width height] の形式の 4 要素ベクトルとして指定します。

次の表で、ベクトルの各要素について説明します。

要素	説明
left	プライマリ ディスプレイの左端から UI figure ウィンドウの内側左端までの距離です。この値は、複数のモニターのあるシステム上では負の値になる場合もあります。
bottom	プライマリ ディスプレイの下端から UI figure ウィンドウの内側下端までの距離です。この値は、複数のモニターのあるシステム上では負の値になる場合もあります。
width	UI figure の内側の左右の端の間の距離です。
height	UI figure の内側の上下の端の間の距離です。

制限

• 現在、関数 uifigure で作成した Figure オブジェクトは、関数 print、rotate3d、pan または zoom に渡すことができません。その試行をした場合、MATLAB はエラーをスローします。uifigure で作成するプロットで pan、zoom および rotate3d による操作を使用するには、最初の引数に座標軸を指定し、2 番目の引数に 'on'、'off' またはスケール係数 (zoom の場合) を指定します。詳細については、App Designer でのグラフィックスの表示を参照してください。

参考

関数

• appdesigner | scroll | uibuttongroup | uipanel | uitab

プロパティ

• UI Figure のプロパティ

R2016a で導入