Home
Add-ons
Standard Object Library
The WinCC OA Standard Object Library (in short: Stdlib) is a base framework that facilitates the creation and use of WinCC OA Libraries. The Stdlib provides templates for creating WinCC OA Libraries and offers a vast range of functions that make the use of a WinCC OA Library in a WinCC OA project easier.
HOOK Functions, Basics
Stdlib hook-Functions
hook_<libraryPrefix>_libHighlightElementarySymbol()
This function returns TRUE when a certain datapoint element is highlighted.

Add-ons
- API
- Communication Center
- Disaster Recovery System
- Standard Object Library
  The WinCC OA Standard Object Library (in short: Stdlib) is a base framework that facilitates the creation and use of WinCC OA Libraries. The Stdlib provides templates for creating WinCC OA Libraries and offers a vast range of functions that make the use of a WinCC OA Library in a WinCC OA project easier.
  - Requirements and Installation
  - How to create a Standard Object Library
  - How to Create Datapoint Types for the Standard Object Library
  - How to Create a New Standard Object Library Symbol
  - Examples for Standard Object Library Dollar Parameters
  - How to Create a Standard Object Library Faceplate
  - How to Export Library Project Data
  - How to Add a Standard Libary Symbol to a Panel
  - User Authorization in the StdLib
  - [stdlib]
    Settings for the Standard Object Library (Stdlib).
  - Stdlib
  - HOOK Functions, Basics
    - hook Functions
    - Stdlib hook-Functions
      - hook_<libraryPrefix>_addEnableRuleDpes()
        Determines the datapoint elements that are additionally called for rule evaluation for the setting of an elementary symbol to inactive/active.
      - hook_<libraryPrefix>_addHighlightRuleDpes()
        Determines the datapoint elements that are additionally used for rule evaluation in order to set an elementary symbol to highlighted/not highlighted.
      - hook_<libraryPrefix>_addVisibleRuleDpe()
        Determines the datapoint elements which are additionally used for the rule evaluation in order to set an elementary symbol to visible/invisible.
      - hook_<libraryPrefix>_alterInfoAreaDisplay()
        This function allows the icon-ID, and therefore the icon displayed in an information area, to determine when the value of the datapoint element that is connected to an information area changes. Which datapoint elements are connected to a certain information area is determined via the function hook_<LibName>_getInfoAreaDPEs().
      - hook_<libraryPrefix>_fillPopUpMenu()
        This function is used to change the context menu of a symbol or an elementary symbol.
      - hook_<libraryPrefix>_getAlertElement()
        By using this function, the library creator can define were the sum alert of a DPT/DP is located.
      - hook_<libraryPrefix>_getInfoAreaDPEs()
        This function determines the datapoint elements that can change the icon for an information area of a symbol. For detailed information, see also hook_<libraryPrefix>_displayInfoAreaIcon() and hook_<libraryPrefix>_alterInfoAreaDisplay().
      - hook_<libraryPrefix>_getInvalidElement()
        This function determines the datapoint element that indicates whether a datapoint is invalid.
      - hook_<libraryPrefix>_getOperationModeElement()
        This function determines the datapoint node that saves the operating states.
      - hook_<libraryPrefix>_hasDpeAnActiveAdress()
        This function is used to check whether an elementary symbol in a faceplate has a peripheral address.
      - hook_<libraryPrefix>_libEnableElementarySymbol()
        This function returns TRUE when a certain datapoint element is activated.
      - hook_<libraryPrefix>_libHighlightElementarySymbol()
        This function returns TRUE when a certain datapoint element is highlighted.
      - hook_<libraryPrefix>_libVisibleElementarySymbol()
        This function returns TRUE if a certain datapoint element is visible.
- BACnet Application
- SmartSCADA
  The WinCC OA feature SmartSCADA provides two packages: the Analytics package and the KPI framework.
- WinCC OA Excel Report
  WinCC OA Excel Report, is a program extension of MS Excel for integrated data evaluation and protocol generation with WinCC OA archive data. Reports can be created with the WinCC OA Excel Report. Templates are used for the reports. If a report is to be generated over a defined period of time, the system accesses the template and automatically fills it with data from the process database. Reports can also be created, printed and saved on a scheduled basis without requiring user access.
- Video

hook_<libraryPrefix>_libHighlightElementarySymbol()

This function returns TRUE when a certain datapoint element is highlighted.

Synopsis

bool hook_ <libraryPrefix>_libHighlightElementarySymbol ( dyn_anytype aParams);

Parameters


Parameter	Description
aParams	aParams[1] = datapoint element aParams[2] = connected datapoint elements aParams[3] = connected values

Default

bool hook_stdlib_libHighlightElementarySymbol(dyn_anytype aParams)
{ 
  return false;
}

Return Value

TRUE = datapoint element is highlighted

FALSE = datapoint element is not highlighted.