CwAddObjectToGroup
Sintassi:
hGroup = CwAddObjectToGroup(hObject, hOldGroup)
hGroup (handle) Handle del gruppo a cui l'oggetto e` stato aggiunto
hObject (handle) Handle dell'oggetto da aggiungere al gruppo
hOldGroup (handle) Handle del gruppo a cui l'oggetto va aggiunto, oppure null handle
Descrizione:
Questa funzione aggiunge un oggetto a un gruppo, creando il gruppo se questo ancora non esiste.
Se il gruppo, fornito in hOldGroup è valido, l'oggetto riferito da
hObject viene aggiunto al gruppo e la funzione ritorna l'handle all'oggetto.
Se il parametro del gruppo è il null handle, viene creato un nuovo gruppo, l'oggetto passato
vi viene aggiunto e la funzione ritorna l'handle al nuovo gruppo.
Esempio:
/* Create a couple of objects and group them. */
obj1 = createSomeObject()
obj2 = createSomeObject()
gh = CwAddObjectToGroup(obj1, 0)
call CwAddObjectToGroup obj2, gh
Note:
È permesso aggiungere un gruppo a sé stesso, ma nulla accade. Comunque questo permette di essere
più "leggeri" nell'uso di cicli.