The 'name' property

Character Vector

Valid for: All objects

If you created the object using ⎕NEW, the name property is the internal name of the object, allocated by APLX. You can use this name as the right argument of ⎕WE, to wait for events until a window has been closed:

      win←'⎕' ⎕NEW 'Window'
      win.caption←'Sample Window'
      win.name
SYSOBJ-3
      ⎕WE win.name

If you created the object using ⎕WI, the name property is the which you specified as the left argument, excluding the parent name if any. In this case you can change the name subsequently, as in this example:

     'Win1.OK' ⎕WI 'name'                   ⍝ Read the current name
OK
     'Win1.OK' ⎕WI 'name' 'OKBut'           ⍝ Change the name
     'Win1.OKBut' ⎕WI 'name'                ⍝ Note left argument
OKBut

If you want the fully-qualified name including the parent hierarchy, use the self property instead.