StartStopButton

Create start-stop real-time application button for instrument panel UI

Since R2021b

Syntax

hStartStopButton = slrealtime.ui.control.StartStopButton(hFigure)

Description

hStartStopButton = slrealtime.ui.control.StartStopButton(hFigure) creates a Speedgoat^® target computer start-stop button for an instrument panel uifigure figure. This button starts or stops a real-time application running on the target computer and displays the state of the current application.

• When the button displays the Start icon and text, the target computer is not running an application. Clicking the button component starts the application.

• When the button displays the Stop icon and text, the target computer is running an application. Clicking the button component stops the application.

The button provides an option to Reload On Stop.

For information about control properties, see slrealtime.ui Properties. It is important to set the TargetSource property for this control if you plan on using your app with target computers other than the default target computer.

Examples

Create Target Computer Start-Stop Button

Create a real-time application start-stop button and adjust the position of the button.

% Create figure 
hFig = uifigure(); 
% Create start/stop component 
hStarted = slrealtime.ui.control.StartStopButton(hFig); 
% Change position of the component 
hStarted.Position = [0 0 200 200]; 
% Associate with default target 
hStarted.TargetSource = []; 
% Configure start options
hStarted.ReloadOnStop = 1;
hStarted.AutoImportFileLog = 1;
hStarted.ExportToBaseWorkspace = 1; 
% Customize 
hStarted.StartIcon = fullfile(pwd, 'start.png'); 
hStarted.StartText = 'START ME'; 
hStarted.StartIcon = fullfile(pwd, 'stop.png'); 
hStarted.StartText = 'STOP ME';

Input Arguments

hFigure — Handle to uifigure object

object handle

The hFigure argument identifies the uifigure to which you are adding the UI component.

Example: hFig = uifigure()

Data Types: function_handle

Output Arguments

hStartStopButton — Handle to start-stop button component

component handle

The hStartStopButton argument is the handle to the start-stop button component that you create.

Version History

Introduced in R2021b

R2024a: Added properties for components

To provide support for pre- and post-event callback code that executes when the state changes for a button component, several Simulink^® Real-Time™ App Designer components have added properties for adding callback code. The components and their event-related properties include:

• ConnectButton: PreConnectFcn, PostConnectFcn, PreDisconnectFcn, PostDisconnectFcn

• ImportFileLogButton: PreImportFcn, PostImportFcn

• LoadButton: PreLoadFcn, PostLoadFcn

• StartStopButton: PreStartFcn, PostStartFcn, PreStopFcn, PostStopFcn

R2022b: Added properties for application start and stop options

Added ReloadOnStop property, AutoImportFileLog property, and ExportToBaseWorkspace property to the StartStopButton component. For information about button properties, see slrealtime.ui Properties.