long AddItemWithDisplayName (LPCTSTR SDR, LPCTSTR DL, LPCTSTR ItemName, long SigDigits, LPCTSTR DisplayName);
Available (from release):
stTabular History OCX (V3-02), stTabular History Automation (V3-02)
Return Value:
A handle to the newly created item if successful otherwise 0.
Parameters:
|
Name: |
Description: |
|
SDR |
The SDR containing the Item to be added.
Note: When connected directly to an OPCServer, the SDR should be set to the same value as the ServerName argument used on the ConnectToDA or ConnectToHDA call. |
|
DL |
The data location of the item.
Note: When connected directly to an OPCServer, the DL should be set to the same value as the ServerName argument used on the ConnectToDA or ConnectToHDA call. |
|
ItemName |
The name of the item to be added. |
|
SigDigits |
The number of significant digits to use when displaying the item. |
|
DisplayName |
Name to use on the display dropdown. |
Remarks:
Call this function to add and select an item on the display. The SDR, DL and ItemName parameters uniquely identify the item to be added. If an item with the same SDR, DL and ItemName already exist then this will be selected.
Tip: This method assigns the next sequential color from the active color palette to the new item. If a specific color is required, use the AddItemWithDisplayNameAndColor method instead.