CwFindShallowerObject

Sintassi:

hObject = CwFindShallowerObject hPrevObj, nX, nY

        hObject         (handle) Handle dell'oggetto richiesto, oppure il
                        null handle se non vi sono oggetti

        hPrevObject     (handle) Oggetto al di la del quale cercare

        nX              (numerico) Coordinata orizzontale del punto a
                        cui controllare

        nY              (numerico) Coordinata verticale del punto a
                        cui controllare

Descrizione:

Questa funzione restituisce l'handle dell'oggetto più in fondo nell'ordine posto davanti a "hPrevObj" e coprente il punto nX, nY. Usare questa funzione è simile a ciclare tra gli elementi posti sotto il puntatore del mouse puntando una locazione e cliccando ripetutamente con il tasto sinistro del mouse, anche se l'ordine di selezione è invertito. Alternativamente, può essere pensato come una versione di CwFindPreviousObject che salta tutti gli oggetti che non occupano il punto nX, nY.

Un programma può ciclare tra tutti gli oggetti nella vista corrente che occupano il punto di coordinate (nX, nY) chiamando ripetutamente CwFindShallowerObject con lo handle ritornato dalla chiamata precedente come argomento.

Se "hLastObj" è il null handle, l'oggetto più avanzato che copre il punto viene ritornato, e se si tratta dell'oggetto maggiormente in profondità (l'ultimo della sequenza), viene ritornato un null-handle.

Questa funzione si comporta come CwFindDeeperObject, con la differenza che l'ordine in cui gli oggetti vengono ritornati tra le chiamate è invertito.

Esempio:

/* Trova gli oggetti sotto un certo punto e ne immagazzina gli
     handle nello stem "obj.". */

call CwGetMousePosition pos;
count = 1

o = CwFindShallowerObject(0, pos.x, pos.y)
do while CwIsHandleValid(o)
        obj.count = o
        count = count + 1
        o = CwFindShallowerObject(o, pos.x, pos.y)
        end


Funzioni per NOME

Indice

Funzioni per SCOPO