Zusätzliche Information
API-Dokumentation
Die Homepage der API Doxygen-Dokumentation ist
<wincc_oa_path>/api/docu/index.html
.
Migration
Überprüfen Sie die Anforderungen für die API-Entwicklung für die verwendete Version. Bestehende API-Projekte müssen konvertiert und mit dem entsprechenden Compiler kompiliert werden, um die API-Anforderungen zu erfüllen:
So konvertieren Sie ein API-Projekt von VC++ 12.0 oder VC++ 14.0 auf VC++ 14.1:
Öffnen Sie die alte .sln - Datei mit Visual Studio 2017. Die Projektdateien werden automatisch nach sln bzw. .vcxproj konvertiert.
Zusätzliche Ressourceninformationen
Durch die Verwendung der Datei VersInfo.rc
können dem kompilierten Objekt
zusätzliche Informationen, wie z.B. Dateibeschreibungen, hinzugefügt werden.
CONTROL-Erweiterungen und Versionsnummer-Prüfung
Der Controller prüft einen Versions-String aus der CtrlExtension (DLL, so) gegen seinen
eigenen Versions-String. Eine CONTROL-Erweiterung muss einen Versions-String liefern. Dafür
gibt es zwei Makros:CTRL_EXTENSION_VERSION
und das CTRL_EXTENSION
(class, funcList)
. Die BaseExternHdl.hxx
definiert diese Makros.
Eine vorhandene CONTROL-Erweiterung muss mindestens eines von den Makros in eine
.cxx
-Datei hinzufügen, damit sie mit der aktuellen WinCC OA-Version verwendet werden kann. Die Implementierung der
newExternHdl()
-Funktion ist nicht mehr notwendig. CTRL_EXTENSION
(class, funcList)
enthält auch CTRL_EXTENSION_VERSION
.
Es muss nur die XXXExternHdl.cxx-Datei nach der Definition der fnList
wie
folgt geschrieben werden:
CTRL_EXTENSION(myClassNam, fnList)