|
If you read this property, you can obtain message structure as tree format which control is handling. You can set tree format to this property. In case of setting, you can use line-feeds, spaces and tabs in grammar freely.
 Syntax
The grammar of the string to set List Property is as follows;
Common Notice
White space (space, tab, carriage return and line feed) is treated as a separator only. So, you can use them to improve readability of source code. But you must be careful that you use in comment or string text, it is treated as character.
From aster (*) to the end of line are treated as comment, except aster in string text.
Integer consists of number '0' to '9' and minus (-) flag. If you want to write in hexadecimal expression put '0x' in front of the value. In this case, you can also use 'a' to 'f' and 'A' to 'F'. For decimal part of the number, you can omit front '0' like '0.9' as '.9'. You can also use exponential expression. There are reserved words like 'true' (=1) and 'false' (=0).
String is surrounded by single quotation mark ('). It is not be able to contain new-line and single quotation itself. So if you do want to fill these kind of characters in string, use hexadecimal expression like 0x0a.
Bold letter portion in explanation means to describe character itself. These characters may also be uppercase or lowercase letter fundamentally. Refer to each explanation for an italic character. Moreover, the portion surrounded by brackets ([]) can be omitted.
Grammar
| xx | Stream number. Don't fill space between 'S' and 'F'. |
| yy | Function number. Don't fill space 'F' and 'w'. |
| w | Wait bit. If you want to specify it, add 'w'. It can be omitted. |
| Body | Message body. |
In order to recognize stream, function, and wait-bit as 1 lump, don't put neither space nor new-line code among these. All of streams and functions can be omitted and only message body can also be described.
Message body
Message body is hierarchy structure.
List
| Number | Number of list. This is only for compatibility of SECSIM. Swing ActiveX control ignore this number. |
| Body | Message body. You can put other items here. |
Ascii string
| Strings | ASCII string of text. |
Long string can be divided separately. Moreover, you can write character code as well, for example:
<a 'ABC' 'DEF' '012' 0x33 '4' 53 54 '789'>
could be written as
<a 'ABCDEF0123456789'>
These are exactly the same.
2-byte character string
| Strings | 2-byte character string for far east complicated language. This version of Swing ActiveX control can handle only DBCS (Double Byte Character Set). |
JIS8 string
This is treated as same kind of string as ASCII string.
| Strings | JIS-8 string of text for Japanese 'katakana'. |
I have never seen this type.
Integer
|
Numbers
|
Integer. It must be one of followings.
| i1 | 8-bit integer |
| i2 | 16-bit integer |
| i4 | 32-bit integer |
| i8 | 64-bit integer |
| u1 | 8-bit unsigned integer |
| u2 | 16-bit unsigned integer |
| u4 | 32-bit unsigned integer |
| u8 | 64-bit unsigned integer |
|
You can write some numbers. This means array, for example:
<i1 1 0x02 3>
This version of Swing ActiveX control can not handle very big value in i8 and u8.
Floating point
|
Fnumbers
|
Floating point value. It is one of these.
| f4 | 32-bit floating point number |
| f8 | 64-bit floating point number |
|
For example:
<f4 0 1.0 3.14>
Binary
For example:
<b 0xff 0x3e 255 0>
Boolean
For example:
<bool true false 1 0>
Return Value
Example
|
|
. List = "s1f13w{<a'Swing'><a'Ver 3.17'>}"
|
|
|
m_msg. SetList("s1f13w{<a'Swing'><a'Ver 3.17'>}");
|
Remarks
If you use List Property, it is more simple to use this property than to use Add Method. It is very clear to compare with the code using Add Method. Following 2 examples generate exactly the same message in different way.
Using Add Method
See Also
|