OBJECTID Method (System) [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.

====== OBJECTID Method (System) ======


 
==== Description ====
 
 
This method returns the name of a PS GUI object matching the passed handle (HWND).
 
 
 
 
==== Syntax ====
 
 
ObjectID = Exec_Method( "SYSTEM", "OBJECTID", HwndObject )
 
 
 
 
==== Parameters ====
 
 
 
^Name^Required^Description^
|HwndObject|Yes|Handle (HWND) of the GUI object to query.|

 


 
==== Returns ====
 
 
The name of the PS GUI object matching the passed handle, or null otherwise.
 
 
 
 
==== Remarks ====
 
 
N/A
 
 
 
 
==== Example ====
 
<code>
 
// Example - find the object under the screen cursor and check if it's a

   // PS object.

   

   hwndHot = Exec_Method( "SYSTEM", "HANDLEBYCURSOR", "", "", "" )

   

   if hwndHot then

      hotID = Exec_Method( "SYSTEM", "OBJECTID", hwndHot )

      if bLen( hotID ) then

         // We have a PS object underneath the cursor

      end

   end
 
 
 

</code>

 
==== See Also ====
 
 
OBJECTBYCURSOR method, OBJECTID method, Common GUI HANDLE property.