CwGetHandleFromObjectName

Sintassi:

hObject = CwGetObjectName(hContext, sName)

        hObject         (handle) Handle di un oggetto

        hContext        (handle) Handle di un gruppo o di una vista in cui cercare

        sName           (stringa) Nome dell'oggetto

Descrizione:

Questa funzione ritorna l'handle di un oggetto con il nome passato tramite "sName" e contenuto nella vista o nel gruppo riferiti da "hContext". La funzione non distingue tra lettere minuscole o maiuscole per i nomei (per esempio 'FOO' e 'foo' sono considerati nomi identici). Se non esistono oggetti con il nome dato, viene ritornato un null handle. Se più di un oggetto ha uno stesso nome, viene ritornato lo handle di uno di tali oggetti: non è possibile dire quale di quelli presenti verrà ritornato.

Esempio:

/* Acquisisce dati dall'utente leggendo il testo di un oggetto testo headline. */
dh = CwGetHandleFromObjectName(CwGetCurrentView(), 'input')

if \CwIsHandleValid(dh) then do
        say "Errore: l'oggetto fornito e` assente."
        exit
        end

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


Funzioni per NOME

Indice

Funzioni per SCOPO