Promotic
WikipediaLinkedInYoutubeTwitterFacebook

Preconfigurations Window for entering alphanumeric values

The window contains a keyboard for entering the alphanumeric values (letters and numbers) Very useful for touchscreen terminals.
 
This preconfiguration can be activated when creating a new object (e.g. by "New object" in the local object menu or by pressing the Insert key after selecting the object) and is included in the group: " / Panels (PmPanel) / Keyboards".

This preconfiguration can be used with the objects: PmFolder, PmRoot, PmPanel or PmWorkspace.

 
- Preconfiguration creates an object of type PmPanel.
- The preconfiguration is created including the panel (PmPanel object) functionality as a WEB panel.
 
The OpenView method with entry parameter oExtra can be used to open the panel. See How to work with modal windows.

The alphanumeric functional buttons (PmiButton) in the onButtonUp event allow changes in the resulting PmiText display.

In the onPanelStartEnd event the entry value of the argument is loaded into the display (PmiText). In the onPanelStopEnd event after the OK button is pressed the value from PmiText is returned back to the object, that called the OpenView method.

These configurators can be set before the preconfiguration is created:
The name of created objectName of the object created in the application object tree. This is a system name and must not contain empty string, diacritics, spaces and the first character must not be a number.

Default: "KeybAlfaNum"

PermissionsOn this page permissions of the object are defined. See Description of the page Permissions.
Enable as WEB componentIt indicates if this object has to be registered as a WEB server component

After this preconfiguration is created, the configurator is se to: PmPanel > Web Server > Enable as WEB component.

Example:
The input value sTxt will be displayed in the graphic item of the window. The edited value will be returned into the sVal variable.
-------------------------
An example in VBScript syntax:
Opening the preconfigured window in the panel using the onButtonUp event of the PmiButton graphic item.
Dim oExtra, sTxt
sTxt = "Text 1"
Set oExtra = Pm.CreatePmMap()
oExtra.mapSetValueAt "Arguments", sTxt
oExtra.mapSetValueAt "onClose", Pm.CreatePmAction(1, pMe, "ClosePanel")
pMe.PmPanel.OpenView "/KeybAlfaNum", "target:_blank;modal:1;", "", oExtra
Obtaining returned value of the ClosePanel user method with parameters oSystem and oPrivate of this graphic item.
Dim sVal
sVal = oSystem.ReturnValue
If Pm.IsValid(sVal) Then
  Pm.Debug "AlfaNumValue=" & sVal
End If
-------------------------
An example in JavaScript syntax:
Opening the preconfigured window in the panel using the onButtonUp event of the PmiButton graphic item.
var sTxt = "Text 1";
var oExtra = Pm.CreatePmMap();
oExtra.onClose = Pm.CreatePmAction(1, pMe, "ClosePanel");
pMe.PmPanel.OpenView("/KeybAlfaNum", "target:_blank;modal:1;", "", oExtra);
Obtaining returned value of the ClosePanel user method with parameters oSystem and oPrivate of this graphic item.
var sVal = oSystem.ReturnValue;
if(Pm.IsValid(sVal))
  Pm.Debug("AlfaNumValue=" + sVal);
 
This preconfiguration is used in PreCfg - Preconfiguration examples.
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice