ConnectButton

Create connect target computer button for instrument panel UI

Since R2021b

Syntax

hConnectButton = slrealtime.ui.control.ConnectButton(hFigure)

Description

hConnectButton = slrealtime.ui.control.ConnectButton(hFigure) creates a Speedgoat^® target computer connect-disconnect button for an instrument panel uifigure figure. This single button has two states.

• For the connected state, the button indicates that the MATLAB^® development computer is connected to target computer. Clicking the button disconnects the development computer from the target computer.

• For the disconnected state, the button indicates that the development computer is disconnected from target computer. Clicking the button connects the development computer to the target computer.

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 Connect-Disconnect Button

Create a target computer connect-disconnect button and adjust the position of the button.

% Create figure
hFig = uifigure();
% Create connect button component
hConnected = slrealtime.ui.control.ConnectButton(hFig);
% Change position of the component
hConnected.Position = [0 0 200 200];
% Associate with a target object
hConnected.TargetSource = 'TargetPC1';
% Customize
hConnected.ConnectedIcon = fullfile(pwd, 'myConnectedIcon.png');
hConnected.DisconnectedIcon = fullfile(pwd, 'myDisconnectedIcon.png');
hConnected.ConnectedText = 'Push to disconnect';
hConnected.DisconnectedText = 'Push to connect';

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

hConnectButton — Handle to connect button component

component handle

The hConnectButton argument is the handle to the connect 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