Dialog and Menu Functions

Introduction

Dialog an menu functions allow an Operator Action (written as IEC 61131-3 Structured Text) to open menus and dialogs:

FunctionReturnsDescription
ConfirmActionDialog INT Opens a dialog with a title, a message string, and OK and Cancel buttons.
DialogAddLabel Adds a text label to the current dialog definition.
DialogAddTextEditor Adds a multi-line text editor to the current dialog definition.
DialogAddValue Adds a text entry field mapped to a program variable to the current dialog definition.
DialogNew Resets the current dialog definition back to empty.
DialogOpen INT Opens the current dialog using the specified title and buttons.
MessageDialog Opens a dialog with a title, a message string, and an OK button.
StandardTagMenu Opens the Standard Tag Menu for the specified tag.
TextEditorDialog INT Opens a dialog with a title, a text editor, and OK and Cancel buttons.
TagCommand Executes the specified command on a tag, prompting for confirmation or user input if required.
ValueDialog INT Opens a dialog with a title, a text editor, and OK and Cancel buttons.

A function that returns a value can be called from an Expression.

All of these functions can be called from a Structured Text Function Call.

Using Dialog functions

You can use the functions that begin with the word Dialog, for example DialogNew(), DialogAddLabel(), and DialogOpen(), to build custom dialogs.

A typical call sequence is:

  1. Call DialogNew() to reset the current dialog definition back to empty.
  2. Call one or more DialogAddXXXX() functions to add fields to the current dialog definition.
  3. Call DialogOpen() to open the dialog defined by the current dialog definition.

Further Information

Operator Actions

To learn where you can use these functions.

Glossary

For definitions of the terms used in Fernhill SCADA.