SignalTable

Create signal table for instrument panel UI

Since R2021b

Syntax

hSigTable = slrealtime.ui.control.SignalTable(hFigure)

Description

hSigTable = slrealtime.ui.control.SignalTable(hFigure) creates an editable signal table display for an instrument panel uifigure figure. Only the Enabled column is editable to enable or disable a signal from streaming its value to the table. The display shows the signals that you have selected for streaming in the real-time application. When the instrument panel app is running, the SignalTable component provides a right-click menu that lets you select signals to add to or remove from the display.

For information about display properties, see slrealtime.ui Properties.

Examples

Create Signal Table

Create a signal table and adjust the position of the table.

% Create figure 
hFig = uifigure(); 
% Create signal table component 
hSTable = slrealtime.ui.control.SignalTable(hFig); 
hSTable.Signals = struct( ... 
  'BlockPath', {'testmodel/Constant1', 'testmodel/Constant2', ...
                'testmodel/Sine Wave', 'testmodel/str2', ...
				'testmodel/Switch1'}, ... 
  'PortIndex', {1, 1, 1, 1, 1}, . . .
  'Decimation', {1, 2, 5, 1, 1}, . . .
  'ArrayIndex', {[], [], 2, [2 2], 3}, . . .
  'BusElement', {'', 'b', '', 'z', 'a'}, . . .
  'Callback', {[], cb, [], [], []}); 
% Change position of the component 
hSTable.Position = [0 0 200 200]; 
% Customize 
hSTable.FontWeight = 'bold'; 
hSTable.FontAngle = 'italic';

Create Signal Table by Using Signal Names

Create a signal table and adjust the position of the table. When using signal names in the Signals property, the BlockPath selects the signal name and the PortIndex value is -1.

% Create figure 
hFig = uifigure(); 
% Create signal table component 
hSTable = slrealtime.ui.control.SignalTable(hFig); 
hSTable.Signals = struct( ... 
  'BlockPath', {'testmodel/Constant1', 'testmodel/Constant2', ...
                'Sine', 'String', 'testmodel/Switch1'}, ... 
  'PortIndex', {1, 1, -1, -1, 1}); 
  'Decimation', {1, 2, 5, 1, 1}, . . .
  'ArrayIndex', {[], [], 2, [2 2], 3}, . . .
  'BusElement', {'', 'b', '', 'z', 'a'}, . . .
  'Callback', {[], cb, [], [], []}); 
% Change position of the component 
hSTable.Position = [0 0 200 200]; 
% Customize 
hSTable.FontWeight = 'bold'; 
hSTable.FontAngle = 'italic';

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

hSigTable — Handle to signal table component

component handle

The hSignTable argument is the handle to the signal table component that you create.

Version History

Introduced in R2021b

R2023a: Added optional properties for Decimation, BusElement, ArrayIndex, and Callback

The SignalTable provides optional properties that let you configure Decimation, BusElement, ArrayIndex, and Callback for each signal added to the signal table. For more information, see the Signals property.

R2022b: Added context menu for selecting signals at run time

Added a right-click menu to the SignalTable component that lets you select signals to add to or remove from the display while the instrument panel app is running.

R2022b: Select signals by name

In R2022b, you can use a signal name instead of a full block path to create robust binding between a signal and an instrument. This support applies to the SignalTable component and functions such as connectLine or connectScalar.