PIPListenerGroup

Dialog Library

Description:

Draws a droplist of all available IP Listener Groups. (In general, the groups will be the IP Listener tag names.)
Returns: Nothing
Usage: Steady State only.
Function Groups: Graphics
Related to: GUITransform | PAddressEntry | PAlmPriority | PAreaSelect | PCheckBox | PColorEdit | PColorSelect | PContributor | PDroplist | PEditField | PEditName | PFileChooser | PHSliderBar | PHueSelect | PImageSelect | PIPAddressList | PMultiCheckBox | PPageSelect | PPhraseEdit | PRadioButtons | PSecBit | PSelectObject | PServerListName | PSpinbox | PTimeZone | PTypeToggle | SiteDispParms
Format: \DialogLibrary.PIPListenerGroup(ParmNum, Trigger, FocusID [, Title, DrawBevel, VertAlign, AlignTitle])
Parameters:  
ParmNum
Required. Any numeric expression giving the parameter number (from 0) in the caller to alter
Trigger
Set when the variable is changed.
FocusID
Boolean. If this value is FALSE (0), the field will display its current setting, but cannot be opened (i.e. its value cannot be changed), and will appear disabled (grayed-out).
Title
An optional parameter that is any text expression to be used as a the title to put on the bevel.
DrawBevel
Optional Boolean expression that when set to TRUE, causes a bevel to be drawn around the control.
VertAlign

An optional parameter that is any numeric expression that sets the vertical alignment of the droplist according to one of the following options:

VertAlign Vertical Alignment
0 Top
1 Center
2 Bottom

Whether the title is included when the vertical alignment is calculated is determined by the value of AlignTitle. The default value is 0.

AlignTitle
An optional parameter that is any logical expression. If TRUE (non-0) the title is included in the calculation for vertical alignment, if FALSE (0) it is added to the droplist after it and its bevel has been vertically aligned. The default is true.
Comments:

This module is a member of the VTScada Dialog Library and must therefore be called from within a GUITransform and prefaced by \DialogLibrary..

The "P" tools are intended for use only in configuration folders and drawing panel modules, and therefore are subject to the system security restraints.

This parameter tool expects the first parameter of its calling module to contain an array of tag parameters. It will then set the value of the element indicated by ParmNum.

Usual height: 45 pixels.

Examples:

{***** Network Listener group *****}
GUITransform(30, 168, 240, 123, { Ht 45 }
             1, 1, 1, 1, 1            { No scaling                     },
             0, 0, 1, 0               { No movement; visible; reserved },
             0, 0, 0                  { Not selectable                 },
             \DialogLibrary.PIPListenerGroup(\#ListenerGroup, 
                                             Trigger,
                                             TRUE                  {ID},
                                             \IPNetworkListenerGroup));