Returning fully qualified name of an object (longname())

longname()

Return fully qualified name of an object


SYNTAX

longname(object_id)

Returns the long name of the object referred to by object_id - that is, the fully qualified name, including not only the object’s identifier but also, the window, group, menu, as appropriate.

This function is useful in the following circumstances:

1

When object_id is an argument passed to a function. See Example 1 below.

2

When object_id is a pointer-type temporary field. The function can be used to retrieve the full name of the object to which the pointer is pointing. See Example 2 below.

This function returns an alphanumeric type.


NOTES

  • The nameof() function returns an object’s short name - its identifier alone, without qualifiers.


EXAMPLE

  1. Retrieve argument passed to a function. This example displays the caption “Win1.Button2”:

    +window Win1 at 100,80 {
        +button Button2 at 14,5 {
            label = "BUTTON2"
        }
    }
        NameButton(Button2)
    ...
    
    !function NameButton(b) {
        caption longname(b)
    }
    
  2. Retrieve the object pointed to. The temporary field tmp.Alpha30 now contains “Win3.Meals.Lunchbox”:

    !temp Pointer,,p
    !temp Alpha30,,a30
    
    +window Win3 at 17,8 {
    
        textbox group Meals {
            +textbox LunchBox at 4,4 {
            ...
            }
        }
    }
        tmp.Pointer = &LunchBox
        tmp.Alpha30 = longname(tmp.Pointer)
    

RELATED TOPICS

nameof()

parent()

fromname()