Startup Tasks and Input Arguments in App Designer

App Designer allows you to create a special function that executes when the app starts up, but before the user interacts with the UI. This function is called the StartupFcn callback, and it is useful for setting default values, initializing variables, or executing commands that affect initial state of the app. For example, you might use the StartupFcn callback to display a default plot or a show a list of default values in a table.

Create a StartupFcn Callback

To create a StartupFcn callback, right-click the UIFigure component in the Component Browser, and select Callbacks > Add StartupFcn callback.

App designer creates the function and places the cursor in the body of the function. Add commands to this function as you would do for any callback function. Then save and run your app.

See App with Auto-Reflow that Updates Plot Based on User Selections for an example of an app that has a StartupFcn callback.

Define Input App Arguments

The StartupFcn callback is also the function where you can define input arguments for your app. Input arguments are useful for letting the user (or another app) specify initial values when the app starts up.

To add input arguments to an app, open the app in App Designer and click Code View. Then click App Input Arguments in the Editor tab.

The App Input Arguments dialog box allows you to add or remove input arguments in the function signature of the StartupFcn callback. The app argument is always first, so you cannot change that part of the signature. Enter a comma-separated list of variable names for your input arguments. You can also enter varargin to make any of the arguments optional. Then click OK.

After you click OK, App Designer creates a StartupFcn callback that has the function signature you defined in the dialog box. If your app already has a StartupFcn callback, then the function signature is updated to include the new input arguments.

After you have created the input arguments and coded the StartupFcn, you can test the app. Expand the drop-down list from the Run button in the toolstrip. In the second menu item, specify comma-separated values for each input argument. The app runs after you enter the values and press Enter.

Note

MATLAB® might return an error if you click the Run button without entering input arguments in the drop-down list. The error occurs because the app has required input arguments that you did not specify.

After successfully running the app with a set of input arguments, the Run button icon contains a blue circle.

The blue circle indicates that your last set of input values are available for re-running your app without having to type them again. Up to seven sets of input values are available to choose from. Click the top half of the Run button to re-run the app with the last set of values. Or, click the bottom half of the Run button and select one of the previous sets of values.

The Run button also allows you to change the list of arguments in the function signature. Select Edit App Input Arguments... from the drop-down list in the bottom half of the Run button.

Alternatively, you can open the same App Input Arguments dialog box by clicking App Input Arguments in the toolstrip, or by right-clicking the StartupFcn callback in the Code Browser.

See Creating Multiwindow Apps in App Designer for an example of an app that uses input arguments.

Related Topics