2 - Amiga Magazine Online

* i metodi OM-NOTIFY e OM-UPDATE, definiti dalla root- rametri di OM-NOTIFY. I1 pacchetto di parametri di
class; OM-NOTIFY e di OM-UPDATE è simile a quello di
* le classi di interconnessione (la icclass e la sua sottoclasse
modelclass);
OM-SET:
struct opUpdate
* gli attributi ICA-TARGET e ICA-MAP, definiti dalla "ic- {
C~~SS"
e dalla gadgetclass. ULONG MethodID; /* OM-NOTIFY o OM-UPDATE */
struct TagItem *opuAttrList;
11 metodo OM-NOTIFY trasmette una TagList di attributi /* lista dei nuovi attributi */
all'oggetto target specificato dall'attributo ICA-TARGET. Gli struct GadgetInfo *opu-G~nfo;
oggetti chiamano questo metodo su se stessi quando il va- /* contesto del gadget */
lore di alcuni attributi con applicabilità "N" (Notify) viene ULONG opu-~lags; /* flags */
alterato. In genere le sottoclassi della gadgetclass non im- };
plementano direttamente il metodo OM-NOTIFY, perciò il
messaggio viene passato alla superclasse finché non rag- 11 campo aggiuntivo opu-Flags contiene il flag OPUF-IN-
giunge un dispatcher che lo riconosce e invia all'oggetto TERIM, che viene impostato quando il messaggio contiene
target un messaggio OM-UPDATE contenente gli stessi pa- un aggiornamento "intermedio" degli attributi ed è azzerato
ULONG MYCLASS-OMSet (Class *cl, Object *obj, struct opSet *msg)
(
struct MyClassData *myclassdata;
struct TagItem*ti, *tstate;
BOOL do-supermethod;
do-supermethod = FALSE;
myclassdata = (struct PIPData *) INST-DATA (cl, obj);
tstate = msg->opupttr~ist;
while (ti = NextTagItem (&tstate))
switch (ti->ti-Tag)
{
}
case MYCLASSAttributol:
. . .
myclassdata->~ttributol = ti->ti-~ata;
. . .
break;
case MYCLASSAttributo2:
. . .
myclassdata->Attributo2 = ti->ti-Data;
...
break;
default:
/* La TagList contiene degli attributi non gestiti */
do-supermethod = TRUE;
/* Invia il messaggio OM-SET alla superclasse,
* solamente se necessario.
* /
if (do-supermethod)
return DoSuperMethodA (cl, (Object *)g, (Msg) rnsg);
return 0;
1
Listato 2.
-
-
per gli aggiornamenti finali. Per esempio,
uno slider invia molti messaggi intermedi
mentre l'utente sta spostando l'indicatore,
e un messaggio finale quando l'utente rila-
scia il gadget. Alcuni oggetti target posso-
no essere interessati soltanto agii aggiorna-
menti finali e non a quelli intermedi.
Dal momento che OM-UPDATE e
OM-SET sono molto simili, in genere le
classi utilizzano la stessa routine per gesti-
re entrambi questi metodi. Quando un og-
getto riceve un messaggio OM-UPDATE,
non deve far altro che esaminare la TagLi-
st e impostare i propri attributi di conse-
guenza, esattamente come nel caso di
OM-SET. Certe volte può capitare che il
cambiamento di un attributo ricevuto con
OM-UPDATE scateni l'invio di una secon-
da notifica da parte dell'oggetto. in questo
Caso, l'oggetto deve copiare il contenuto
del campo flags del messaggio OM-UP-
DATE nel campo flags del messaggio
OM-NOTIFY. In caso contrario, tra due
oggetti potrebbero verificarsi dei ping-
pong di notifiche che porterebbero inevi-
tabilmente a un blocco totale del sistema.
Per evitare che ciò accada, la icclass im-
plementa un sistema in grado di ricono-
scere i loop e fermarli, utilizzando dei flag
non documentati nel campo opu-Flags di
opupdate.
Dal momento che classi diverse utilizzano
attributi diversi, quando si collegano due
oggetti è spesso necessario operare una
traduzione negli ID degli attributi.
ICA-MAP permette di specificare una Ta-
gList in cui ogni TagItem è una coppia di
valori che associa un attributo del primo