onKeyPress - event of the PmgObject object

Description:

The event is triggered after pressing or releasing the key of the keyboard, if the object has a focus (only the object with the focus gets the message). The event can be used for controlling the item by the keyboard.

Parameters:

pMe	(Object) Reference to the PmgObject object where the event rises.
pEvent	(Object) Reference to object describing detailed information about the specific event. pEvent.Action - (Integer) Indication of pressing or releasing the key. 0 - key release 1 - key press pEvent.Code - (Long) Pressed key code. In case of an ANSI character the value equals the char code, for the other codes see Keys constants. In order to convert such numeric code into String the Pm.StringCodeFrom method can be used. pEvent.Ctrl - (Boolean) Indication of concurrent pressing the Ctrl key. pEvent.Shift - (Boolean) Indication of concurrent pressing the Shift key. pEvent.Alt - (Boolean) Indication of concurrent pressing the Alt key.

pMe

(Object) Reference to the PmgObject object where the event rises.

pEvent

(Object) Reference to object describing detailed information about the specific event.

pEvent.Action - (Integer) Indication of pressing or releasing the key.

0 - key release

1 - key press

pEvent.Code - (Long) Pressed key code. In case of an ANSI character the value equals the char code, for the other codes see Keys constants.
In order to convert such numeric code into String the Pm.StringCodeFrom method can be used.

pEvent.Ctrl - (Boolean) Indication of concurrent pressing the Ctrl key.

pEvent.Shift - (Boolean) Indication of concurrent pressing the Shift key.

pEvent.Alt - (Boolean) Indication of concurrent pressing the Alt key.

Note:

The event has the same parameters as the PmaRoot.onKeyPress event.

- This event is triggered only if the "Control enabled" configurator is checked.

- This event is also functional in Web panels.

- This event is not functional for object: PmgRoot, PmgActiveX.

Example:

The example of the event content. Here 'hot' keys are defined for two various actions.

JavaScriptVBScriptSelect and copy to clipboard



if (pEvent.Action == 1 && pEvent.Ctrl)
{

	switch (pEvent.Code)
	{

		case 65:

			// Key A

			// Calling some 1st action
			break;

		case 66:

			// Key B

			// Calling some 2nd action
			break;
	}
}