CwGetHandleFromObjectName

Syntax: 

hObject = CwGetObjectName(hContext, sName)

        hObject         (handle) The handle of an object

        hContext        (handle) The handle of a group or view to search.

        sName           (string) The name of the object

Description:

This function returns the handle of an object with the name provided in "sName" and contained in the view or group referenced by "hContext". Names are case-insensitive (e.g. 'FOO' and 'foo' are considered identical). If no object with the given name exists, a null handle is returned. If more than one object has the given name, the handle of one of them is returned. There is no way to tell which one.

Example: 

/* Get user input by reading the text of a headline text object. */
dh = CwGetHandleFromObjectName(CwGetCurrentView(), 'input')

if \CwIsHandleValid(dh) then do
        say "Error: input object missing."
        exit
        end

userInput = CwGetProperty(CwGetRegion(dh), 'caption')

Functions by NAME

Index

Functions by PURPOSE