RECEIVER property [Revelation On-Line Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== RECEIVER property ======


 
==== Applies To ====
 
System.
 
==== Description ====
 
[[get_property|Get_Property()]] returns an object that was set as receiver of messages sent through the OpenEngine C interface.

[[set_property|Set_Property()]] sets a control indicated in //object// (only an edit box is supported) as a receiver of data sent through the OpenEngine C interface using the Send_Dyn method.

Some stored procedures, like [[rlist|RLIST]] (with target of 1), [[list_users|LIST_USERS]], and most of the system procedures marked as Command Line, send their data to a client program, like the system editor, using a method called Send_Dyn. To support the capture of this information, the RECEIVER property specifies an edit box control that will receive the information.
 
==== Usage ====
 
//object// = **Get_Property**("**SYSTEM**", "**RECEIVER**")

//oldobject// = **Set_Property**("**SYSTEM**", "**RECEIVER**", //newobject//)
 
==== See Also ====
 
[[statusline|STATUSLINE property]]
 
==== Example ====
 
<code>
* capture text results of list_users in the edit box EDITBOX_RESULTS.

declare function get_property
declare subroutine set_property

Set_Property ("SYSTEM", "RECEIVER", @window: ".EDITBOX_RESULTS")
Set_Property (@window: ".EDITBOX_RESULTS", "TEXT", "")
Call List_Users("")
Users = Get_Property (@window: ".EDITBOX_RESULTS", "TEXT")

* reset the receiver property to null.
Set_Property ("SYSTEM", "RECEIVER", "")
</code>