CwFindNextObject

Sintassi:

hObj = CwFindNextObject(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 successivo a quello riferito da "hLastObj". L'oggetto successivo è (più o meno) quello dietro "hLastObj".

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

Questa funzione si comporta come CwFindPreviousObject, a parte il fatto che l'ordine di visita degli oggetti è invertito.

Esempio:

/* Fa' qualcosa con tutti gli oggetti della vista corrente. */
o = CwFindFirstObject(CwGetCurrentView())
do while CwIsHandleValid(o)
        call doSomethingTo o
        o = CwFindNextObject(o)
        end

Note:

Quando viene trovata la fine della sequenza (l'ultimo oggetto), la successiva chiamata tornerà un null-handle.

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



Funzioni per NOME

Indice

Funzioni per SCOPO