Show Message on Host

Displays the message in a dialog on the host machine.

Library

QUARC Targets/Sinks/Error Handling

Description

The Show Message on Host block displays an error message in a dialog on the host when its input is non-zero. Unlike the Stop with Message block it does not stop the model. A fixed error message string can be provided as the error message, or it can interpret its input as a standard QUARC error code and supply the corresponding error message. If the input is interpreted as an error code then only negative inputs cause the block to issue an error message.

The dialog containing the message does not close when the model is terminated. The user must close it manually. However, if the model is restarted, it will reuse the same dialog so that a series of dialogs are not created every time the model is restarted. It will also change the error message in the dialog if the Message type parameter is set to Interpret input as error code and the input changes.

Note that the dialog is displayed as long as the input to the block is non-zero, even if the user closes the dialog. Hence, this block is best used in a Triggered Subsystem so that the dialog is only opened when the input changes.

Input Ports

This block has a single input port. The error message is displayed on the host when this input becomes non-zero or negative, depending on the setting of the Message type parameter.

Output Ports

This block has no output ports.

Data Type Support

The Show Message on Host block accepts signals of any of the built-in Simulink data types at its input. Fixed point is not currently supported.

Parameters and Dialog Box

Message type

The type of error message to issue. If this parameter is set to Fixed error message then it uses the contents of the Error message parameter as the error message. If the Message type parameter is set to Interpret input as error code then it interprets the input as a QUARC error code and issues the corresponding error message.

Message icon

The type of icon to display in the dialog.

Error message

The error message to issue. The error message is treated as a string. It is not evaluated so Matlab workspace variables cannot be used. This parameter is ignored if the Message type parameter is set to Interpret input as error code.

Targets

Copyright ©2024 Quanser Inc. This page was generated 2024-04-16. Submit feedback to Quanser about this page.

Link to this page.