stOCX Active-X Control API's

The following API functions are available for use with the stOCX Active-X Control:

 

API method:

Description:

AddPen

Adds an item to be trended to the graph.

AddPenViaAliasName

Adds a pen to the trend graph specifying the required item via it's Alias name.

ConfigDataCollection

Set the data collection attributes when connected directly to a Data Source.

ConnectToCollector

Instructs the control to connect to the named Sapphire Collector.

ConnectToOPCDA

Instructs the control to connect to the named Data Access (DA) OPC Server.

ConnectToOPCHDA

Instructs the control to connect to the named Historical Data Access (HDA) OPC Server.

Disconnect

Causes the control to disconnect from the current Data Source.

DisconnectAll

Causes the control to disconnect from all connected Data Sources.

EnableMenu

Enable or Disable the Plot Properties Right-click menu.

EnableMultipleConnections

Allow the control to establish connections with more than one Data Source.

FetchData

Populates the graph with data and control the scan state.

FitToView

Re-scale all the pens in Auto-scale mode.

GetConnectionAttribute

Gets the specific connection attribute for the default Data Source.

GetConnections

Gets the list of currently connected Data Sources.

GetCurrentConnection

Gets the Connection String for the Data Source that is currently being used.

GetDisplayMask

Returns a mask indicating what is currently displayed in the plot.

GetLastError

Get the last API Error.

GetNumberOfPens

Returns the number of items being currently being trended.

GetPenAttribute

Gets the specified attribute for the chosen pen.

GetPenHandle

Get the Pen handle for a given Item.

GetPens

Returns the list of pens currently being trended.

GetPlotAttribute

Get the specified attribute for the Active plot.

GetSDRs

Returns the list of SDRs held by the data collector the control is connected to.

GetUserPreference

Fetch the value of the specified User Preference for the current User account.

GetVersionString

Returns version information about the control.

IsValidItem

Check to see if the Item assigned to the given pen is valid.

LoadPlotFile

Configure the control from a predefined plot file.

LoadPrefsFile

Customize the control from a predefined user preferences file.

PrintTrend

Send the current plot file to the default Printer for printing.

RemoveAllPens

Remove all the pens within the current plot.

RemoveNamedPen

Remove a pen that is currently being based on it's item name.

RemovePen

Removes a pen that is currently being trended using it's item handle.

SavePlotFile

Save the plot to the specified filename.

SetConnectionAttribute

Sets the connection attributes for the default Data Source.

SetDelimiter

Sets the delimiting character for separating sections of attribute values.

SetDisplayMask

Controls what is displayed in the plot.

SetDurationSeconds

Sets the duration of the period the plot covers.

SetGraphStyle

Set the required Graph Style for the plot.

SetPenAttribute

Set the specified attribute for the chosen pen.

SetPlotAttribute

Sets the specified attribute for the chosen plot.

SetPlotPeriod

Set the period for the plot by specifying the required start and end time.

SetScaleAuto

Request that the high and low Y-axis scales for the pen are automatically calculated.

SetScaleLink

Link the scales for the Current pen to another pen using pen handles.

SetScaleLinkByName

Link the scales for the Current pen to another pen using Item names.

SetScaleManual

Set the high and low Y-axis scales to user specified values.

SetSDR

Sets the SDR for the trend. This determines what points can be plotted on the plot.

SetTargets

Set the pen Targets for Radar Plots.

SetUserPreference

Set a specific User Preference for the current User.

Synchronize

Synchronizes all other graphs with this plot.