InsertTrend - method of the PmgTrendViewer object
Description:
The method creates and returns a new object of the
tvTrend type. The object is located into the trends container to the
nIndex index and whenever it is accessible by the
Trends method.
Syntax:
Object InsertTrend(Long nIndex, String sID, String sName)
Parameters:
| nIndex | (Long) Index to the trends container. Newly created object is inserted to this index. |
|---|
| sID | (String) Trend identifier (maximal length is 64 characters) |
|---|
| sName | (String) User name of trend |
|---|
Return values:
Returns the created
tvTrend object.
If the creation of the object failed, then returns value null for JavaScript or Nothing pro VBScript.
Nothing value can be tested by VBScript
Is operator.
Note:
The maximal number of trends is 255.
If the parameters are not entered or they are set as empty strings (""), then new tvTrend object with default parameters sID and sName will be created.
New object with preset parameters can be created also on the "Trends" tab.
Example:
JavaScriptVBScriptSelect and copy to clipboard
var oTView = pMe;
var oTrend = oTView.InsertTrend(0, "t1", "Temperature");
if (oTrend)
//.. ok
else
//.. error
Dim oTView, oTrend
Set oTView = pMe
Set oTrend = oTView.InsertTrend(0, "t1", "Temperature")
If Not oTrend Is Nothing Then
'.. ok
Else
'.. error
End If