The fact if the event is triggered by pressing, releasing or by double-clicking can be obtained from the Action parameter.
|pMe||(Object) Reference to the PmgTrendViewer object where the event rises.|
|Action||(Long) action type of the left mouse button|
0 - releasing the left mouse button
1 - pressing the left mouse button
2 - double-clicking the left mouse button
|Ctrl||(Boolean) indication of concurrent pressing the Ctrl key|
|Shift||(Boolean) indication of concurrent pressing the Shift key|
|Alt||(Boolean) indication of concurrent pressing the Alt key|
|X||(Long) Position of the mouse cursor (in pixels) in the X-coordinate relative to the left upper corner of the area for drawing the trends (bordered by scales)|
|Y||(Long) Position of the mouse cursor (in pixels) in the Y-coordinate relative to the left upper corner of the area for drawing the trends (bordered by scales)|
|TimePos||(Variant) Time value that refers to the curson position where it was clicked by the mouse.|
|ValuePos||(Variant) Value of the active trend (specified by the PmgTrendViewer.TrendActive property) that refers to the cursor position where it was clicked by the mouse. |
If no trend is displayed in the viewer (the value of the PmgTrendViewer.TrendsCount property is 0), then the parameter is set to the value Empty.
Caution 1: It is always necessary to check the Action parameter (see Example1). If it wasn't checked, then the script in the onMouseArea event would be called twice because if the user presses or releases the mouse button, then the onMouseArea event is triggered twice but always with the different Action parameter.
Caution 2: It is NOT advisable to place methods that call another window on the workspace (e.g. Pm.InputBox, etc.), into the script when the Action=1 action is treated. If such method is used, then it can result in consequently NOT calling the Action=0 action. Scripts that open other windows must be handled in the branch belonging to mouse button release action (i.e. if Action=0).
var oTrend = pMe.Trends(1);
if (Action == 0)
//remove the nearest point to the cursor position when the mouse button is released
//add point on the cursor position when the mouse button is released
oTrend.Points.AddPoints(timePos, ValuePos, 0, 5);
var oTView = pMe;
if (Action == 0)
nTrend = oTView.FindTrend(10, X, Y);
if (nTrend >= 0)
oTView.TrendActive = nTrend;