CwGetFirstPropertyValue

Sintassi:

vPropVal = CwGetFirstPropertyValue(hObject, sPropName)

        vPropVal        (variante) Il primo possibile valore della proprieta`

        hObject         (handle) L'oggetto in esame

        sPropName       (stringa) Il nome della proprieta` in esame

Descrizione:

Alcune proprietà potrebbero avere una gamma relativamente piccola di valori, che alle volte possono variare tra versioni o addirittura diverse installazioni. Un esempio di questa possibilità è la proprietà "Font" degli oggetti testo. Questa funzione viene usata per elencare tutti i valori ammessi per queste proprietà. Una lista completa dei valori può essere ottenuta chiamando CwGetFirstPropertyValue con lo handle dell'oggetto e il nome della proprietà come argomenti. Il valore di ritorno è il primo valore della proprietà.

Valori successivi possono essere ottenuti tramite CwGetNextPropertyValue. Una volta che l'ultimo valore è stato ritornato, CwGetNextPropertyValue ritorna una stringa vuota.

Se una proprietà non ha un piccolo insieme di valori (per esempio una proprietà che accetta numeri arbitrari come argomenti), CwGetFirstPropertyValue ritorna una stringa vuota.

Esempio:

/* Questa funzione prende un oggetto e un nome di proprieta`, e ritorna una stringa
   contenente tutti i valori in una lista separata da virgole. */

allprops: procedure
parse arg obj, prop

v = CwGetFirstPropertyValue(obj, prop)
if v = '' then
        r = 'Any'
else
        do while v \= ''
                r = r||"," v
                v = CwGetNextPropertyValue()
                end
return r


Funzioni per NOME

Indice

Funzioni per SCOPO