PRealmSelect
(Dialog Library)
| Description: |
Tool for setting the Realm parameter of a tag, this appears as a non-editable drop list displaying the friendly names of available realms.
|
| Returns: | Nothing |
Usage: ![]() |
Steady State only. |
| Function Groups: | Graphics |
| Related to: | GUITransform |PAddressEntry |PAlmPriority |PAreaSelect |PCheckBox |PColorEdit |PColorSelect | PContributor | PEditField | PEditName | PFileChooser |PHueSelect| PImageSelect | PIPAddressList | PIPListenerGroup |PMultiCheckBox | PPageSelect | PPhraseEdit | PRadioButtons | PSecBit | PSelectObject | PSelectCertificate |PServerListName | PSpinbox |PTimeZone | PTypeToggle|SiteDispParms |
Format: ![]() |
\DialogLibrary.PRealmSelect(ParmNum[, Title, ID, ExtTrigger, DrawBevel, VertAlign, AlignTitle]); |
| Parameters: |
| ParmNum |
| Required. Indexes a specific tag parameter for editing. |
| Title |
| Optional display title of the drop down field. Defaults to "Realm". |
| ID |
| Optional boolean. If FALSE the Realm Field will display the current Realm name, uneditable and displayed in gray-scale. Defaults to TRUE. |
| ExtTrigger |
| Optional external trigger to be set when the Realm changes. Output value only. |
| DrawBevel |
| An optional parameter that is any logical expression. If TRUE or INVALID (does not return 0), a bevel is drawn around the Realm droplist, otherwise (is 0) no bevel is drawn. Defaults to TRUE. |
| VertAlign |
|
An optional numeric value that sets the vertical alignment of the unopened Realm droplist. AlignTitle determines whether or not Title is incorporated into this alignment setting. Defaults to 0.
|
| AlignTitle |
| An optional paramter that is any logical expression. If TRUE (does not return 0), the Title will be incorporated into the same vertical alignment configuration as the droplist and its bevel. Defaults to TRUE. |
| Comments: |
The list of available realms is compiled from .Dynamic or .Startup setting files, users and roles defined in the Application Security Configuration, and the HTTP Realms defined by the Thin Client/Server setup. The drop list includes two additional options at the top:
Users within a realm, not including the RootNameSpace, will not have access to a PRealmSelect while a NameSpaceDelimiter is set. |
Example
{
\DialogLibrary.PRealmSelect(0, "MyRealm", FALSE, MyTrigger, 2, TRUE);
]
