Home
Data Visualization
User interfaces, Trends and Reports for every purpose and device.
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
hook Functions
hook_<libraryPrefix>_projectFillPopUpMenu()
This function configures the context menu of a symbol and elementary symbols of a faceplate.

Version Information
Release Notes, Update information, Certifications and Frequently Asked Questions.
Concepts
Your first step into modern and powerful process visualization.
Deployment
Topics, you need to know, before using WinCC OA.
Security
Go beyond the norm in cybersecurity.
Engineering
Powerful tools for easy or complex engineering tasks.
Data Management
Classify, structure and archive your data.
Business Logic / Control
Endless possibilities in data processing for your projects.
Data Visualization
User interfaces, Trends and Reports for every purpose and device.
- User Interfaces
  All the available options for visualizing WinCC OA.
- System Overview
  A panel for the diagnostics of a WinCC OA system.
- Alert and Event Screen (AEScreen)
  The alert and event panel (AEpanel) in WinCC OA is a standard panel and allows displaying alerts and events in table format.
- Variable Trend
  A set of panels and scripts used for the simplified display of trend curves and trend groups (up to 16 trend curves).
- Standard Symbols (STD_Symbols)
  Symbol library consisting of graphics objects for the quick display and design of system diagrams.
- 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 Data Point 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
      - hook_<libraryPrefix>_displayInfoAreaIcon()
        This function specifies which icon is displayed in an information area based on its state. The function then displays the icon for a symbol.
      - hook_<libraryPrefix>_enableElementarySymbol()
        This function specifies if an elementary symbol is active or inactive.
      - hook_<libraryPrefix>_faceplateHeadline()
        This function specifies the text for the header of a faceplate.
      - hook_<libraryPrefix>_faceplateWindowTitle()
        This function queries the text of the faceplate window title of the referenced data point.
      - hook_<libraryPrefix>_hasUserAuthorization()
        This function determines whether a certain user has the authorization to change the value of a data point element.
      - hook_<libraryPrefix>_highlightElementarySymbol()
        This function determines whether an elementary symbol is highlighted.
      - hook_<libraryPrefix>_namingFaceplateTabs()
        This function determines the titles for the tabs in a faceplate.
      - hook_<libraryPrefix>_objectTooltip()
        This function determines the tool tip text of a symbol.
      - hook_<libraryPrefix>_openFaceplate()
        This function opens the faceplate of a symbol.
      - hook_<libraryPrefix>_projectFillPopUpMenu()
        This function configures the context menu of a symbol and elementary symbols of a faceplate.
      - hook_<libraryPrefix>_visibleElementarySymbol()
        This function identifies whether an elementary symbol is visible.
    - Stdlib hook-Functions
Southbound Interfaces
The process connection to the actual machines/sensors.
Northbound Interfaces
Your portal to the cloud or supervising systems.
Web Connectivity / Network Interfaces
Data exchange, APIs and web technologies
User Management
All about authorization, authentication and login-customization.
Availability
How to get your system uptime to the maximum.
Reporting
Create state of the art project reports without limits.
Addons
Useful tools and enhancements for special demands.
Reference Tables
Detailed and extensive content for special project adaptation.
Videos & Tutorials
Explore the capabilities of WinCC OA with our carefully selected collection of video tutorials and guides.
WinCC OA Documentation
Basic information about terms and functions within the documentation.
Disclaimer
A brief clarification of liability exclusions or legal notices.

hook_<libraryPrefix>_projectFillPopUpMenu()

This function configures the context menu of a symbol and elementary symbols of a faceplate.

Synopsis

void hook_<libraryPrefix>_projectFillPopUpMenu(string sDp, dyn_string &dsMenueEntry, dyn_string &dsFunction);

Parameters

Parameters


Parameter	Description
sDp	Data point name
dsMenueEntry	Entry in the context menu
dsFunction	Function of the entry

Return Value

-

Description

This function configures the context menu of a symbol and the elementary symbols of a faceplate. By default, the following entries in the context menu are provided: DP Monitor, Para, Help, Alarm Screen, Even Screen and Trend.

You can find the function in the stdlib_hook_project.ctl under wincc_oa_path/Stdlib_3.20/scripts/libs/

hook_projectFillPopUpMenu(string sDp, dyn_string &dsMenueEntry, dyn_string &dsFunction)
{
  string sDpMonitor, sPara, sHelp, sAlarm, sEvents, sTrend;
  sDpMonitor = getCatStr("stdlib","DpMonitor");
  sPara      = getCatStr("stdlib","Para"     );
  sHelp      = getCatStr("stdlib","Help"     );
  sAlarm     = getCatStr("stdlib","Alarm"    );
  sEvents    = getCatStr("stdlib","Events"   );
  sTrend     = getCatStr("stdlib","Trend"    );
  dsMenueEntry= makeDynString("PUSH_BUTTON", sPara          + ", "+PARA+"     ,  " + ((isModeExtended() && getUserPermission(32))?"1":"0"),
                              "PUSH_BUTTON", sAlarm         + ", "+ALARMS+"   ,  " + TRUE,
                              "PUSH_BUTTON", sEvents        + ", "+EVENTS+ "  ,  " + TRUE,
                              "PUSH_BUTTON", sDpMonitor     + ", "+DPMONITOR+",  " + TRUE,
                              "PUSH_BUTTON", sTrend         + ", "+TREND+"    ,  " + TRUE,
                              "PUSH_BUTTON", sHelp          + ", "+HELP+"     ,  " + TRUE
                              );
  dsFunction=makeDynString("OpenDpMonitor(\""+sDp+"\");","OpenPara(\""+sDp+"\");","OpenHelp(\""+sDp+"\");","OpenAlerts(\""+sDp+"\");","OpenEvents(\""+sDp+"\");","OpenTrend(\""+sDp+"\");");
}
/*
@author Markus Trummer
function for adding and removing faceplate tabs before opening the faceplate
@param sDp ... datapoint for which the faceplate will be opened
@param &ds_panels ... panels which will be opend
@param &ds_pfad ... paths of the panels
*/