## 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.

Topic: APLX Help : System Classes : Properties : name

[ Previous | Next | Contents | Index ]