App Designer での複数のウィンドウをもつアプリの作成

複数ウィンドウのアプリは、データを共有する 2 つ以上のアプリで構成されます。アプリ間でデータを共有する方法は、設計によって異なります。一般的な設計の 1 つは、2 つのアプリ (メインのアプリと 1 つのダイアログボックス) を使用するものです。通常、メインのアプリにはダイアログボックスを開くボタンがあります。ユーザーがダイアログボックスを閉じると、ダイアログボックスによってユーザーの選択内容がメインウィンドウに送信され、計算の実行および UI の更新が行われます。

A main app window and a dialog box window with a double-sided arrow between the two

これらのアプリは、異なるタイミングに異なる方法で情報を共有します。

ダイアログボックスが開かれると、メインのアプリは入力引数を使用してダイアログボックスのアプリを呼び出すことによって、ダイアログボックスに情報を渡します。
ダイアログボックスアプリでユーザーが [OK] ボタンをクリックすると、入力引数を使用してメインアプリのパブリック関数を呼び出すことによって、ダイアログボックスからメインアプリに情報が返されます。

プロセスの概要

前のセクションで説明したアプリを作成するには、2 つの別個のアプリ (メインアプリとダイアログボックスアプリ) を作成しなければなりません。次に、以下の高いレベルのタスクを実行します。各タスクには複数の手順が含まれます。

ダイアログボックスへの情報の送信 — 入力引数を受け入れるダイアログボックスアプリに StartupFcn コールバックを記述します。入力引数の 1 つがメインアプリオブジェクトでなければなりません。次に、メインアプリで、入力引数を使用してダイアログボックスアプリを呼び出します。
メインアプリへの情報の返送 — ダイアログボックスのユーザーの選択に基づいて UI を更新するメインアプリにパブリック関数を記述します。パブリック関数であるため、ダイアログボックスアプリで呼び出して値を渡すことができます。
ウィンドウを閉じるときの管理 — Windows が終了したときに保守タスクを実行する両方のアプリに CloseRequest コールバックを記述します。

このプロセスのすべてのステップの実装を確認するには、ダイアログボックスを開くプロットアプリを参照してください。

アプリを Web アプリとして展開する場合 (MATLAB^® Compiler™ が必要)、複数のアプリウィンドウを作成することはサポートされません。代わりに、複数のタブをもつ単一ウィンドウのアプリを作成することを検討してください。詳細については、Web アプリの制限とサポートされていない機能 (MATLAB Compiler)を参照してください。

ダイアログボックスへの情報の送信

メインアプリからダイアログボックスアプリに値を渡すには、次の手順を実行します。

ダイアログボックスアプリで、コールバック関数 StartupFcn の入力引数を定義します。[コードビュー] の [エディター] タブで、[アプリの入力引数] をクリックします。[アプリの詳細] ダイアログボックスで、入力引数の変数名のコンマ区切りのリストを入力します。以下の入力を指定します。
- メインアプリ — メインアプリの関数とプロパティをダイアログボックスアプリのコード内から参照できるように、メインアプリオブジェクトをダイアログボックスアプリに渡します。
- 追加のデータ — ダイアログボックスアプリからアクセスする必要がある、メインアプリで定義された追加データを渡します。
[OK] をクリックします。
ダイアログボックスアプリで、メインアプリオブジェクトを保存するコードを追加します。
1. 最初に、メインアプリを保存するプロパティを定義します。[コードビュー] の [エディター] タブで、[プロパティ] 、 [プライベートプロパティ] を選択します。次に、properties ブロックのプロパティ名を CallingApp に変更します。
  properties (Access = private) CallingApp % Main app end
2. その後、コールバック関数 CallingApp で、StartupFcn プロパティにメインアプリオブジェクトを保存するコードを追加します。
  function StartupFcn(app,caller,sz,c) % Store main app object app.CallingApp = caller; % Process sz and c inputs % ... end
  StartupFcn コールバックの完全にコード化された例については、ダイアログボックスを開くプロットアプリを参照してください。
メインアプリで、コールバック内からダイアログボックスアプリを呼び出してダイアログボックスを作成します。
1. 最初に、ダイアログボックスアプリを保存するプロパティを定義します。メインアプリで、[コードビュー] の [エディター] タブで、[プロパティ] 、 [プライベートプロパティ] を選択します。次に、properties ブロックで、プロパティ名を DialogApp に変更します。
  properties (Access = private) DialogApp % Dialog box app end
2. その後、[Options] ボタンのコールバック関数を追加します。このコールバックは、ユーザーが複数のダイアログボックスを開かないように [Options] ボタンを無効にします。次に、ダイアログボックスに渡す値を取得し、入力引数と出力引数を持つダイアログボックスアプリを呼び出します。出力引数は、ダイアログボックスの app オブジェクトです。
  function OptionsButtonPushed(app,event) % Disable Plot Options button while dialog is open app.OptionsButton.Enable = "off"; % Get sample size and colormap % ... % Call dialog box with input values app.DialogApp = DialogAppExample(app,szvalue,cvalue); end
  コールバックの完全にコード化された例については、ダイアログボックスを開くプロットアプリを参照してください。

メインアプリへの情報の返送

次の手順を実行して、ユーザーの選択内容をダイアログボックスアプリからメインアプリに返します。

メインアプリで、UI を更新するパブリック関数を作成します。[コードビュー] でメインアプリを開いた状態で、[エディター] タブで [関数] 、 [パブリック関数] を選択します。
既定の関数名を目的の名前に変更し、ダイアログボックスからメインアプリに渡す各オプションの入力引数を追加します。メインアプリオブジェクトを表す app 引数は 1 つ目の引数でなければならないため、追加の引数はこの引数に続けて指定します。次に、入力を処理する関数にコードを追加して、メインアプリを更新します。
```
function updateplot(app,sz,c) 
    % Process sz and c 
    ...
end
```
パブリック関数の完全にコード化された例については、ダイアログボックスを開くプロットアプリを参照してください。
ダイアログボックスアプリで、コールバック内からパブリック関数を呼び出します。[コードビュー] でダイアログボックスアプリを開いた状態で、[OK] ボタンのコールバック関数を追加します。
このコールバックで、メインアプリコードで定義したパブリック関数を呼び出します。CallingApp プロパティに保存されているメインアプリオブジェクトを、最初の引数として渡します。次に、UI を更新するためにメインアプリに必要な追加のデータを渡します。最後に、ダイアログボックスを閉じるために、関数 delete を呼び出します。
```
function ButtonPushed(app,event)
   % Call main app's public function
   updateplot(app.CallingApp,app.EditField.Value,app.DropDown.Value);

   % Delete the dialog box  
   delete(app)                  
end
```

ウィンドウを閉じるときの管理

どちらのアプリでも、ユーザーが閉じるときに特定のタスクを実行しなければなりません。ダイアログボックスを閉じる前に、メインアプリの [Options] ボタンを再度有効にしなければなりません。メインアプリが閉じる前に、ダイアログボックスが閉じていることを確認しなければなりません。

[コードビュー] でダイアログボックスアプリを開いた状態で、[コンポーネントブラウザー] で app.UIFigure オブジェクトを右クリックし、[コールバック] 、 [CloseRequestFcn コールバックの追加] を選択します。次に、メインアプリのボタンを再度有効にしてダイアログボックスアプリを閉じるコードを追加します。
```
function DialogAppCloseRequest(app,event)
   % Enable the Plot Options button in main app
   app.CallingApp.OptionsButton.Enable = "on";
            
   % Delete the dialog box 
   delete(app)             
end
```
[コードビュー] でメインアプリを開いた状態で、[コンポーネントブラウザー] で app.UIFigure オブジェクトを右クリックし、[コールバック] 、 [CloseRequestFcn コールバックの追加] を選択します。次に、両方のアプリを閉じるコードを追加します。
```
function MainAppCloseRequest(app,event)
   % Delete both apps
   delete(app.DialogApp)
   delete(app)              
end
```

例: ダイアログボックスを開くプロットアプリ

例を開く

このアプリは、ダイアログボックスでオプションを選択するためのボタンをもつメインのプロットアプリで構成されています。[Options] ボタンを押すと、入力引数を使用してダイアログボックスのアプリが呼び出されます。ダイアログボックスで、メインのアプリのパブリック関数を呼び出すことによって、[OK] ボタンのコールバックがユーザーの選択内容をメインアプリに送信します。