System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
3.4.2.11 Line styles
Line style symbolic name Value
LS_SOLID 0
LS_DASH 1
LS_DOT 2
LS_DASHDOT 3
LS_DASHDOT
DOT
4
hidden LS_INVISIBLE 5
3.4.2.12 Line end style
Line end symbolic name Value for the left line ends Value for the right line ends
LE_NO 0 0
LE_HOLLOW_ARROW 1 65536
LE_FULL_ARROW 2 131072
LE_CFULL_ARROW 3 196608
LE_LINE 4 262144
LE_HOLLOW_CIRCLE 5 327680
LE_FULL_CIRCLE 6 393216
Note
From a line width > 5 the line end "empty circle" is displayed as filled circle.
3.4.2.13 List types
List type Numeric value
decimal 0
Binary 1
bit 2
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1541
3.4.2.14 Language ID
WinCC only supports the SUBLANG_DEFAULT languages of Windows.
symbolic name Value
(hexadecimal)
Abbreviation
LANG_ARABIC 0x0401
LANG_AFRIKAANS 0x0436
LANG_ALBANIAN 0x041C
LANG_BASQUE 0x042D
LANG_BULGARIAN 0x0402
LANG_BYELORUSSIAN 0x0423
LANG_CATALAN 0x0403
LANG_CHINESE 0x0404
LANG_CROATIAN 0x041A
LANG_CZECH 0x0405 CSY
LANG_DANISH 0x0406 DAN
LANG_DUTCH 0x0413 NLD
LANG_ENGLISH 0x0409 ENU
LANG_ESTONIAN 0x0425
LANG_FAEROESE 0x0438
LANG_FARSI 0x0429
LANG_FINNISH 0x040B FIN
LANG_FRENCH 0x040C FRA
LANG_GERMAN 0x0407 DEU
LANG_GREEK 0x0408
LANG_HEBREW 0x040D
LANG_HUNGARIAN 0x040E HUN
LANG_ICELANDIC 0x040F ISL
LANG_INDONESIAN 0x0421
LANG_ITALIAN 0x0410 ITA
LANG_JAPANESE 0x0411
LANG_KOREAN 0x0412
LANG_LATVIAN 0x0426
LANG_LITHUANIAN 0x0427
LANG_NORWEGIAN 0x0414 NOR
LANG_POLISH 0x0415 PLK
LANG_PORTUGUESE 0x0416 PTB
LANG_ROMANIAN 0x0418
LANG_RUSSIAN 0x0419 RUS
LANG_SLOVAK 0x041B SKY
LANG_SLOVENIAN 0x0424
LANG_SORBIAN 0x042E
LANG_SPANISH 0x040A ESP
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1542
System Manual, 11/2008,
symbolic name Value
(hexadecimal)
Abbreviation
LANG_SWEDISH 0x041D SVE
LANG_THAI 0x041E
LANG_TURKISH 0x041F TRK
LANG_UKRAINIAN 0x0422
3.4.2.15 Text alignment
Horizon
tal
Alignmen
t
Numeric value
left 0
centered 1
right 2
Vertica
l
Alignmen
t
Numeric value
Up 0
centered 1
bottom 2
3.4.2.16 Tag statuses
Value
(decimal)
Value
(hexdecimal)
Meaning
0 0x0000 No error
1 0x0001 Connection to partner not established
2 0x0002 Handshake error
4 0x0004 Network module defective
8 0x0008 Configured upper limit exceeded
16 0x0010 Configured lower limit exceeded
32 0x0020 Format upper limit exceeded
64 0x0040 Format lower limit exceeded
128 0x0080 Conversion error
256 0x0100 Tag initialization value
512 0x0200 Tag replacement value
1024 0x0400 Channel addressing error
2048 0x0800 Tag not found or not available
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1543
Value
(decimal)
Value
(hexdecimal)
Meaning
4096 0x1000 Access to tag not permitted
8192 0x2000 Timeout, no check-back message from the channel
16384 0x4000 Server not available.
3.4.3 Structure definitions
3.4.3.1 Structure definition CCAPErrorExecute
typedef struct {
DWORD dwCurrentThreadID; Thread ID of the current thread
DWORD dwErrorCode1; Error code 1
DWORD dwErrorCode2; Error code 2
BOOL bCycle; cycle/acycle
char* szApplicationName; Name of the application
char* szFunctionName; Name of the function
char* szTagName; Name of the tag
LPVOID lpParam; Pointer to the action stack
DWORD dwParamSize; Size of the action stack
DWORD dwCycle; Cycle of the variable
CMN_ERROR* pError; Pointer to CMN_ERROR
} CCAPErrorExecute;
Members
The meaning of the individual error IDs and the structure elements depending on them are
specified in the following table:
100700
1
0 X X X X X Action requires exception
100700
1
1 X X X X X Exception when
accessing the return
result
100700
1
4097 X X X
X X Stack overflow while
executing the action
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1544
System Manual, 11/2008,
100700
1
4098 X X X X X The action contains a
division by 0
100700
1
4099 X X X
X X The action contains an
access to a non-existing
symbol
100700
1
4100 X X X X X The action contains an
access violation
100700
4
0 X X X Function is not known
100700
5
1 X X
Action does not include a
P code.
100700
5
2 X X Incorrect function name
100700
5
4 X X X X X Return value type is
invalid
100700
5
32768f
f
X X X
X X Ciss Compiler error when
loading the action
100700
6
0 X X X X X X X Tag is not defined
100700
6
1 X X X X X X X
Tag timeout
100700
6
2 X X X X X X X X Tag cannot be returned in
the desired format
100700
6
3 X X X X X X X X Tag returns status
violation, status present
in
CMN_ERROR.dwError1
100700
7
1 X X X
X X X Error in PDLRTGetProp
100700
7
2 X X X X X X Error in PDLRTSetProp
100700
7
3 X X X X X X Error with DM call
Error structure
The OnErrorExecute function uses the error structure to evaluate or to output error messages,
if marked by an "x" in the pError column.
See also
Structure definition CMN_ERROR (Page 1546)
3.4.3.2 Structure definition CCAPTime
typedef struct {
DWORD dwCurrentThreadID; ThreadID of the current Thread
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1545
DWORD dwCode; Code
BOOL bCycle; cycle/acycle
char* szApplicationName; Name of the Application
char* szFunctionName; Name of the Function
LPVOID lpParam; Pointer to the Action-Stack
DWORD dwParamSize; size of the Action-Stack
double dblTime;
DWORD dwFlags; flags
} CCAPTime;
Members
dwCode
The structure element dwCode provides information on calling OnTime:
dwCode = 113 Call with time definition for each action
dwCode = 114 Call with time monitoring for each action
dwFlags
The structure element dwFlags provides information on the output type:
dwFlags = TRUE The results are output to a file
dwFlags = FALSE The results are output to the diagnostics window
3.4.3.3 Structure definition CMN_ERROR
struct CMNERRORSTRUCT {
DWORD dwError1,
DWORD dwError2,
DWORD dwError3,
DWORD dwError4,
DWORD dwError5;
TCHAR szErrorText[MAX_ERROR_LEN];
}
CMN_ERROR
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1546
System Manual, 11/2008,
Description
The extended error structure contains the error code and an error text for the error that has
occurred.
Each application can use the error structure to evaluate or to output error messages.
Members
dwError1 .. dwError5
These entries can be used in any way by the API functions.
The API descriptions inform about the values the respective entries contain in case of an error.
If not specified otherwise, the error codes are present in dwError1.
szErrorText
Buffer for the text description of the error cause
The content is determined from the resources and therefore language-dependent.
3.4.3.4 Structure definition DM_TYPEREF
typedef struct {
DWORD dwType;
DWORD dwSize;
char szTypeName[MAX_DM_TYPE_NAME + 1];
}
DM_TYPEREF;
Members
dwType
Specifies the tag type
DM_VARTYPE_BIT Binary tag
DM_VARTYPE_SBYTE Signed 8-bit value
DM_VARTYPE_BYTE Unsigned 8-bit value
DM_VARTYPE_SWORD Signed 16-bit value
DM_VARTYPE_WORD Unsigned 16-bit value
DM_VARTYPE_SDWORD Signed 32-bit value
DM_VARTYPE_DWORD Unsigned 32-bit value
DM_VARTYPE_FLOAT Floating-point number 32-bit IEEE 754
DM_VARTYPE_DOUBLE Floating-point number 64-bit IEEE 754
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1547
DM_VARTYPE_TEXT_8 Text tag, 8-bit font
DM_VARTYPE_TEXT_16 Text tag, 16-bit font
DM_VARTYPE_RAW Raw data type
DM_VARTYPE_STRUCT Structure tag
DM_VARTYPE_TEXTREF Text reference tag
dwSize
Specifies the length of the data type in bytes.
szTypeName
In the case of structure tags, contains the name of the structure type
3.4.3.5 Structure definition DM_VAR_UPDATE_STRUCT
typedef struct {
DM_TYPEREF dmTypeRef;
DM_VARKEY dmVarKey;
VARIANT dmValue;
DWORD dwState;
}
DM_VAR_UPDATE_STRUCT;
Members
dmTypeRef
Contains information on the tag type. For performance reasons, nothing is entered into this
structure in case of cyclic requirements.
dmVarKey
Specifies the tags to be edited.
dmValue
Tag value
Upon access to the value of the VARIANT a ".u." has to be inserted between the name of the
VARIANT and the name of the member.
Example:
// Supply variant
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1548
System Manual, 11/2008,
myVariant.vt = VT_I4;
myVariant.u.lVal = 233;
A description of the data type VARIANT can be found in the associated documentation. The
VARIANT
dmValue must be initialized with VariantInit() before first use and enabled again with
VariantClear(&dmValue) after use. For this reason, the structure
DM_VAR_UPDATE_STRUCT must not be deleted with ZeroMemory() or memset().
dwState
Identifies the tag status.
See also
Tag statuses (Page 1543)
Structure definition DM_VARKEY (Page 1550)
Structure definition DM_TYPEREF (Page 1547)
3.4.3.6 Structure definition DM_VAR_UPDATE_STRUCTEX
typedef struct {
DM_TYPEREF dmTypeRef;
DM_VARKEY dmVarKey;
VARIANT dmValue;
DWORD dwState;
DWORD dwQualityCode;
}
DM_VAR_UPDATE_STRUCTEX;
Members
dmTypeRef
Contains information on the tag type. For performance reasons, nothing is entered into this
structure in case of cyclic requirements.
dmVarKey
Specifies the tags to be edited.
dmValue
Tag value
Upon access to the value of the VARIANT a ".u." has to be inserted between the name of the
VARIANT and the name of the member.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1549
Example:
// Supply variant
myVariant.vt = VT_I4;
myVariant.u.lVal = 233;
A description of the data type VARIANT can be found in the associated documentation. The
VARIANT
dmValue must be initialized with VariantInit() before first use and enabled again with
VariantClear(&dmValue) after use. For this reason, the structure
DM_VAR_UPDATE_STRUCTEX must not be deleted with ZeroMemory() or memset().
dwState
Identifies the tag status.
dwQualityCode
Identifies the tag quality code.
See also
Tag statuses (Page 1543)
Structure definition DM_VARKEY (Page 1550)
Structure definition DM_TYPEREF (Page 1547)
3.4.3.7 Structure definition DM_VARKEY
typedef struct {
DWORD dwKeyType;
DWORD dwID;
char szName[ MAX_DM_VAR_NAME + 1 ];
LPVOID lpvUserData;
}
DM_VARKEY;
Members
dwKeyType
Defines whether the tag is to be addressed by a key ID or by its name.
DM_VARKEY_ID Specification via key ID
DM_VARKEY_NAME Specification via tag name
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1550
System Manual, 11/2008,