| Description: |
Called graphic module that displays a tag selector to allow the selection of a tag widget.
|
| 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 | PIPAddressList | PIPListenerGroup | PMultiCheckBox | PPageSelect | PPhraseEdit | PRadioButtons | PSecBit | PSelectObject | PServerListName | PSpinbox | PTimeZone | PTypeToggle | SiteDispParms |
| Format: |
\DialogLibrary.PWidgetSelect(ParmNum, Title, FocusID, Trigger, DrawBevel, VertAlign, AlignTitle[, UnspecifiedLabel]) |
| Parameters: |
| ParmNum | ||||||||
| Required. Any numeric expression giving the parameter number (from 0) to alter in the caller. | ||||||||
| Title | ||||||||
| Any text expression to be used as a the title to put on the bevel. | ||||||||
| Focus ID | ||||||||
| 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). | ||||||||
| Trigger | ||||||||
| Set when the variable is changed. | ||||||||
| DrawBevel | ||||||||
| Any Boolean expression that when set to TRUE causes a bevel to be drawn around the control. Defaults to TRUE | ||||||||
| VertAlign | ||||||||
An optional parameter that is any numeric expression that sets the vertical alignment of the button and display area according to one of the following options:
The default value is 0, top alignment. |
||||||||
| AlignTitle | ||||||||
| 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. | ||||||||
| UnspecifiedLabel | ||||||||
| Optional. Caption to appear inside the selector field when a selection has not been specified. |
| Comments: |
The "P" tools (PWidgetSelect, 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 element indicated by ParmNum to the logical value set by the check box. The PWidgetSelect will open the Widget Panel where the widgets available will be filtered to the tag type using this pTool. |
Example:
{ Widget }
GUITransform(0, 65, 400, 45,
1, 1, 1, 1, 1 { No Scaling },
0, 0, 1, 0 { No movement, visible, reserved },
0, 0, 0 { Not selectable },
\Code.DialogLibrary\PWidgetSelect(#TagParameter { Parm Num },
"Widget" { Label },
TRUE { Focus ID },
Trigger { Trigger },
FALSE { No Bevel },
0 { Top Vert align },
True { Align Title },
"Use Default" { Caption }));
