Message object properties

The first four properties of the Message object correspond
to the first four properties of the Microsoft Windows message structure.

Table 21-3: Message object properties
Property	Datatype	Use
Handle	Integer	The handle of the window or control.
Number	Integer	The number that identifies the event (this number comes from Windows).
WordParm	UnsignedInt	The word parameter for the event (this parameter comes from Windows). The parameter’s value and meaning are determined by the event.
LongParm	Long	The long parameter for the event (this number comes from Windows). The parameter’s value and meaning are determined by the event.
DoubleParm	Double	A numeric or numeric variable.
StringParm	String	A string or string variable.
PowerObjectParm	PowerObject	Any PowerBuilder object type including structures.
Processed	Boolean	A boolean value set in the script for the user–defined event: TRUE—The script processed the event. Do not call the default window Proc (DefWindowProc) after the event has been processed. FALSE—(Default) Call DefWindowProc after the event has been processed.
ReturnValue	Long	The value you want returned to Windows when Message.Processed is TRUE. When Message.Processed is FALSE, this attribute is ignored.

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:

OpenWithParm( w_question, &amp;<br>&#160;&#160;&#160;"The specified file already exists. " + &amp;<br>&#160;&#160;&#160;"Do you want to overwrite it?" )<br>IF Message.StringParm = "Yes" THEN<br>&#160;&#160;&#160;RETURN 0 &#160;// File is saved<br>ELSE<br>&#160;&#160;&#160;RETURN -1 // Saving is canceled<br>END IF

1	OpenWithParm( w_question, &<br>   "The specified file already exists. " + &<br>   "Do you want to overwrite it?" )<br>IF Message.StringParm = "Yes" THEN<br>   RETURN 0  // File is saved<br>ELSE<br>   RETURN -1 // Saving is canceled<br>END IF

For information on Microsoft message numbers
and parameters, see the Microsoft Software Developer’s
Kit (SDK) documentation.

Document get from Powerbuilder help

Thank you for watching.

Powerbuilder Documentation 12.5

August 9, 2023

Was this article helpful?