PIPAddressList

(Dialog Library)

Description:	Uses an IPAddressList to set a parameter with a semicolon-delimited IP address list.
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 \| PIPListenerGroup \| PMultiCheckBox \| PPageSelect \| PPhraseEdit \| PRadioButtons \| PServerListName \| PSecBit \| PSelectObject \| PSpinbox \| PTimeZone \| PTypeToggle \| SiteDispParms
Format:	\DialogLibrary.PIPAddressList(ParmNum [, Trigger, FocusID, Title, DrawBevel, 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.

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.

Usual height: 130 pixels.

Comments:

This module should be used whenever the user needs an IP Allow filter for use with the SocketManagerServer.

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 (Pcheck box, PContributor, PColorSelect, PDroplist, and PEditField) were intended only for use 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.
The recommended minimum height ranges from 100 pixels for a plain list to 130 pixels for a list with an aligned titled bevel. The up/down buttons will hide if there is not enough room for them to display.

Example:

{***** Allowed incoming IP address (or ranges) -- optional *****}
GUITransform(30, 309, 240, 177, { Ht 130 }
             1, 1, 1, 1, 
             1, 0, 0, 1, 0, 0, 0, 0, 
             \DialogLibrary.PIPAddressList(\#IPAddressAllow         { ParmNum },
                                           Trigger, 
                                           Valid(Parms[\#ListenerGroup]) ?  10 { FID to 19} : 0, 
                                           \GetPhrase("IPAllowLabel"){ Title     }, 
                                           TRUE                     { DrawBevel  },
                                           TRUE                     { AlignTitle }));