Message object properties
The first four properties of the Message object correspond to the
first four properties of the Microsoft Windows message structure.
|
Property |
Datatype |
Use |
|---|---|---|
|
Handle |
Integer |
The handle of the window or control. |
|
Number |
Integer |
The number that identifies the event (this number |
|
WordParm |
UnsignedInt |
The word parameter for the event (this parameter |
|
LongParm |
Long |
The long parameter for the event (this number comes |
|
DoubleParm |
Double |
A numeric or numeric variable. |
|
StringParm |
String |
A string or string variable. |
|
PowerObjectParm |
PowerObject |
Any PowerBuilder object type including |
|
Processed |
Boolean |
A boolean value set in the script for the
|
|
ReturnValue |
Long |
The value you want returned to Windows when When Message.Processed is |
Use the values in the Message object in the event script that
caused the Message object to be populated. For example, suppose the
FileExists event contains the following script. OpenWithParm displays a
response window that asks the user if it is OK to overwrite the file.
The return value from FileExists determines whether the file is
saved:
|
1 2 3 4 5 6 7 8 |
OpenWithParm( w_question, & "The specified file already exists. " + & "Do you want to overwrite it?" ) IF Message.StringParm = "Yes" THEN RETURN 0 // File is saved ELSE RETURN -1 // Saving is canceled END IF |
For information on Microsoft message numbers and parameters, see
the Microsoft Software Developer’s Kit (SDK) documentation.