CwFindPreviousObject

Sintassi:

hObj = CwFindPreviousObject(hLastObj)

        hLastObj        (handle) Handle a un oggetto

        hObj            (handle) Handle a un oggetto

Descrizione:

Questa funzione è usata per elencare tutti gli oggetti nella vista corrente. Essa ritorna l'oggetto precedente quello riferito da "hLastObj". Quest'oggetto è, più o meno, davanti a quello riferito da "hLastObj".

Un programma può ciclare attraverso tutti gli oggetti nella vista corrente chiamando ripetutamente CwFindPreviousObject con l' handle ritornato dalla precedente chiamata come argomento. La sequenza di oggetti visitati chiamando CwFindPreviousObject in questo modo è uguale a quella degli oggetti selezionati con il tasto page-up della tastiera.

Se "hLastObj" corrisponde al null handle, viene ritornato l'ultimo oggetto nella sequenza, e se questo è il primo (il più avanzato) degli oggetti nella vista (l'ultimo nella sequenza), viene ritornato un null-handle.

Questa funzione si comporta come CwFindNextObject, eccetto che l'ordine in cui gli oggetti vengono visitati è invertito.

Esempio:

/* Fa' qualcosa con tutti gli oggetti nella vista corrente. */
o = CwFindLastObject(CwGetCurrentView())
do while CwIsHandleValid(o)
        call doSomethingTo o
        o = CwFindPreviousObject(o)
        end

Nota:

Passare un null handle equivale a chiamare CwFindLastObject con la vista correntemente selezionata.

Funzioni per NOME

Indice

Funzioni per SCOPO