At line 1 added 191 lines |
%%(display:none) |
{{{ |
WikiUp |
}}} |
/% |
[{TableOfContents }]\\ |
NOTA la versione precedente è la LOBASE_340\\ |
La documentazione del membro LOBASE_340 NON è aggiornata.\\ |
\\ |
!! Logica per la ricerca delle icone\\ |
La directory che contiene le icone di Loocup risiede sul filesystem e si chiama LOOCUP_ICO.\\ |
Con l'installazione di Loocup questa cartella viene creata all'interno della cartella di installazione di Loocup.\\ |
\\ |
Quando viene chiesta l'icona di un oggetto Loocup utilizza il seguente meccanismo per reperire la posizone della cartella LOOCUP_ICO:\\ |
1) se nel setup è definito l'elemento Path con attributo uguale a ICO (XPATH=Setup/Program/BAS/Paths/Path[@Cod='ICO']) viene utilizzato l'attributo Value.\\ |
2) Se nel path indicato dall'attributo Value non c'è la cartella LOOCUP_ICO, viene ricercata nella cartella che contiene la cartella di installazione di loocup, la cartella LOOCUP_ICO/AMBIENTE.\\ |
3) Se non esiste la cartella al punto 2, si passa alla cartella di default.\\ |
\\ |
Una volta identificata la posizone della cartella LOOCUP_ICO, come per la ricerca delle immagini, viene fatta una ricerca per risalita di tipo/parametro/codice all'interno della cartella LOOCUP_ICO, in modo da individuare il file fisico che contiene l'icona da usare.\\ |
\\ |
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_099.png' caption='cartella delle icone nel file system' width='100%' style='max-width: 100%;'}]\\ |
\\ |
* Looc.up è installato nella directory LOOCUP, nell'esempio specifico C:/PROGRAMMI/LOOCUP.\\ |
* La directory di installazione LOOCUP contiene la directory LOOCUP_ICO che contiene le icone di default. Questa directory viene creata durante l'installazione iniziale di Loocup.\\ |
\\ |
\\ |
!! Forzatura Path di Icone da Sme.Up\\ |
E' possibile forzare la directory base delle icone di LoocUp attraverso gli script di configurazione di Loocup (file SCP_SET).\\ |
La dichiarazione della variabile ICO, mediante il tag C.PAT, attributo Value consente di forzare la cartella delle icone.\\ |
Qui di seguito vediamo il frammento di script:\\ |
C.SEZ Cod="Path"\\ |
C.PAT Cod="ICO" Txt="Icone" Type="TREE" Value="PERCORSO_IMG"\\ |
Il percorso può essere relativo o assoluto. Nel primo caso va concepito a partire dalla directory di installazione di LoocUp.\\ |
\\ |
!! Caratteri non consentiti nei path\\ |
Qualora gli identificativi dell'oggetto di cui si sta ricercando l'icona contengano caratteri non consentiti in un percorso di file system, tali caratteri andranno sostituiti con il carattere meno (-). Quindi l'icona dell'oggetto di tipo ** sarà contenuto nella cartella --. Gli oggetti di tipo OJ-*USRPRF avranno le loro icone nella cartella -USRPRF contenuta nella cartella OJ.\\ |
\\ |
\\ |
!! Casi particolari\\ |
Se viene ricercata l'icona dell'oggetto TA, *CNTT; XX, ci si riconduce alla ricerca dell'icona dell'oggetto (XX; ; )\\ |
Se viene ricercata l'icona dell'oggetto (OG, OG, XX) o dell'oggetto (OG, ; XX) ci si riconduce alla ricerca dell'icona dell'oggetto (XX; ; )\\ |
Se viene ricercata l'icona dell'oggetto (OG, XX, YY) ci si riconduce alla ricerca dell'icona dell'oggetto (XX, YY, )\\ |
\\ |
\\ |
!! Meccanismo di ricerca delle icone\\ |
Ogni oggetto, comando e azione può avere icone specifiche o generiche definite da tipo/parametro/codice di appartenenza.\\ |
Se l'icona dell'oggetto (tipo/parametro/codice) così definita non è presente sul filesystem interviene la logica di risalita, che permette la ricerca di icone più generiche come l'icona dell'istanza (tipo/parametro) o l'icona ancora più generica della classe (tipo).\\ |
Si andrà quindi a ricercare l'icona rispettando il seguente ordine:\\ |
* LOOCUP_ICO/tipo/parametro/codice.PNG/GIF ( icona specifica)\\ |
* LOOCUP_ICO/tipo/parametro/default.PNG/GIF (icona generica)\\ |
* LOOCUP_ICO/tipo/codice.PNG/GIF (icona specifica)\\ |
* LOOCUP_ICO/tipo/default.PNG/GIF (icona generica)\\ |
* LOOCUP_ICO/default.PNG/GIF (icona generica)\\ |
\\ |
__NOTA 1__ : Il modulo grafico (SMETRAY) non visualizza l'icona di default generica. Il modulo base (LOOCUO.JAR) la utilizza. Questa è però costituita da un'immagine di 16x16 trasparente. E' stata operata questa scelta per uniformità grafica e per evitare interventi sul codice.\\ |
\\ |
__NOTA 2__: al codice viene trimmato, pertanto, eventuali spazi a sinistra vengono eliminati.\\ |
\\ |
\\ |
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_098.png' caption='visualizzazione icona CN;; CN;CLI; e CN;CLI;001 nel filesystem e nella scheda' width='100%' style='max-width: 100%;'}]\\ |
Nell'esempio in figura possiamo notare dove sono posizionate le icone nel filesystem (in alto) e la loro visualizzazione nel componente albero della scheda (in basso). In particolare notiamo l'icona specifica assegnata all'oggetto CN;CLI;001 (recuperata dal filesystem nel percorso LOOCUP_ICO\CN\CLI\001.gif, vedi etichetta (1) ) e l'icona generica dell'oggetto CN;CLI;005 (non trovata nel filesystem l'icona specifica nel percorso LOOCUP_ICO\CN\CLI\005.gif viene recuperata l'icona generica nel percorso LOOCUP_ICO\CN\CLI\default.gif, vedi etichetta (2) ).\\ |
\\ |
!! Schemi di ricerca delle icone\\ |
Di seguito vediamo gli schemi per identificare l'icona di un oggetto\\ |
\\ |
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_120.png' caption='Identificazione cartella Icone' width='100%' style='max-width: 100%;'}]\\ |
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_121.png' caption='Ricerca icona, casi particolari - OG;OG;XX - OG;;XX - OG;XX;YYY - TA;*CNTT;XX' width='100%' style='max-width: 100%;'}]\\ |
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_121.png' caption='Ricerca icona di oggetto generico' width='100%' style='max-width: 100%;'}]\\ |
%%quote |
Nei casi particolari delle icone di programma (come per esempio l'icona di Microsoft Word, Microsoft Office ...) l'icona viene richiesta direttamente al sistema operativo e non è quindi inclusa in nessun percorso di Loocup. |
/% |
---- |
\\ |
\\ |
!! Tipi di icone -- TODO Validare\\ |
Le icone in Loocup possono rappresentare:\\ |
* oggetti\\ |
* funzioni (verbo/azione)\\ |
* comandi\\ |
\\ |
Le icone-oggetto sono catalogate nelle diverse classi note di Smeup (AR per gli articoli, CN per i contatti ...).\\ |
Le icone-funzione sono icone che rappresentano azioni generiche, che non sono associate ad un oggetto specifico. Ad esempio l'azione "taglia", l'azione "copia" generica.\\ |
Le icone-comando sono icone che rappresentano comandi, ovvero azioni riferite ad un oggetto specifico. Ad esempio l'icona "copia testo" dovrà essere diversa dall'icona "copia cliente" poichè è differente l'oggetto a cui è riferita l'azione, e differente quindi il comando. Queste icone sono catalogate con tipo __J1__ e parametro __KEY__.\\ |
\\ |
\\ |
!! Le icone nei componenti\\ |
In alcuni componenti di Loocup è possibile visualizzare icone specifiche e generiche dell'oggetto come descritto. Inoltre, in alternativa, su alcuni componenti è anche possibile visualizzare delle icone differenti da quelle standard, semplicemente definendo nell'attributo __i="..."__ del nodo dell'xml a cui appartiene l'oggetto, l'azione o il comando un percorso specifico dal quale attingere l'icona.\\ |
\\ |
! I bottoni\\ |
Nel componente bottone è possibile visualizzare icone oggetto in vari modi.\\ |
L'icona può dipendere esclusivamente dall'oggetto a cui fa riferimento il bottone: in questo caso l'xml del componente bottone vengono assegnati gli attributi tipo, parametro e codice dai quali è possibile risalire all'icona visualizzata.\\ |
...\\ |
<Oggetto Nome="Bottone" Tipo="CN" Parametro="CLI" Codice="" Testo="Bottone" />\\ |
...\\ |
\\ |
In alternativa è possibile assegnare altre icone al componente assegnando all'attributo i='...' valori differenti. Le icone possono essere:\\ |
* icone dirette (es. : con i="M1")\\ |
* riferite ad oggetti (es. : con i="CN;CLI;001")\\ |
* specificando il pathfile (es. : con Tipo="J1" Parametro="PATHFILE" e i="[*ICON_PATH]\Verde.gif")\\ |
\\ |
...\\ |
<Oggetto Tipo="" Parametro="" Codice="" Testo="" i="M1" />\\ |
...\\ |
<Oggetto Tipo="" Parametro="" Codice="" Testo="" i="CN;CLI;001" />\\ |
...\\ |
<Oggetto Tipo="J1" Parametro="PATHFILE" Codice="" Testo="" i="[*ICON_PATH]\Verde.gif" />\\ |
...\\ |
\\ |
! L'albero\\ |
Nel componente albero è possibile visualizzare icone generiche, icone oggetto o icone specifiche valorizzando nel setup l'attributo __icone='...'__ con i seguenti valori:\\ |
* __icone="no"__ per visualizzare le icone generiche dei nodi (la cartella per i nodi con figli, il punto per i nodi foglia senza figli)\\ |
* __icone="yes"__ per visualizzare le icone oggetto che dipendono dal tipo, parametro e codice del nodo\\ |
* __icone="specific"__ per visualizzare solo le icone specificate nell'attributo __i='...'__ (vedi di seguito)\\ |
\\ |
Nell'xml del componente albero vengono assegnati gli attributi tipo, parametro e codice dai quali è possibile risalire all'icona visualizzata.\\ |
<Oggetto>\\ |
...\\ |
<Oggetto Tipo="CN" Parametro="CLI" Codice="001" Testo="Cliente" />\\ |
...\\ |
</Oggetto>\\ |
\\ |
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_096.png' caption='esempio icone oggetto nell'albero' width='100%' style='max-width: 100%;'}]\\ |
In alternativa è possibile assegnare altre icone al componente assegnando all'attributo i='...' valori differenti. Le icone possono essere:\\ |
* icone dirette (es. : con i="M1")\\ |
* riferite ad oggetti (es. : con i="CN;CLI;001")\\ |
* specificando il pathfile (es. : con Tipo="J1" Parametro="PATHFILE" e i="[*ICON_PATH]\Verde.gif")\\ |
\\ |
<Oggetto>\\ |
...\\ |
<Oggetto Tipo="" Parametro="" Codice="" Testo="Cliente" i="M1" />\\ |
<Oggetto Tipo="" Parametro="" Codice="" Testo="Cliente" i="CN;CLI;001" />\\ |
<Oggetto Tipo="J1" Parametro="PATHFILE" Codice="" Testo="Cliente" i="[*ICON_PATH]\Verde.gif" />\\ |
...\\ |
</Oggetto>\\ |
\\ |
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_097.png' caption='esempio icone specifiche nell'albero' width='100%' style='max-width: 100%;'}]\\ |
! La matrice\\ |
Nel componente matrice è possibile visualizzare icone oggetto sull'intestazione o nella cella con i seguenti valori:\\ |
* __iconeTesta="no"__ per non visualizzare le icone oggetto nell'intestazione\\ |
* __iconeTesta="yes"__ per visualizzare le icone oggetto nell'intestazione\\ |
* __icone="no"__ per non visualizzare le icone oggetto nella cella\\ |
* __icone="yes"__ per visualizzare le icone oggetto nella cella\\ |
\\ |
Per visualizzare un'__icona sull'intestazione__ della matrice è sufficiente assegnare all'attributo oggetto (ogg) della colonna l'oggetto a cui è riferita la colonna. Ad esempio per visualizzare nell'intestazione della colonna l'icona con tipo="CN" e parametro="CLI" è sufficiente scrivere nell'xml Ogg="CNCLI", come segue:\\ |
<Griglia>\\ |
...\\ |
<Colonna Cod="ID colonna" Txt="Descrizione colonna" Tip="" Lun="3" IO="O" Ogg="CNCLI" />\\ |
...\\ |
</Griglia>\\ |
\\ |
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_100.png' caption='esempio matrice con colonna oggettizzata' width='100%' style='max-width: 100%;'}]\\ |
Per visualizzare un'__icona nella cella__ della matrice è sufficiente assegnare all'attributo oggetto (ogg) della colonna il codice della colonna che specifica l'icona tra parentesi quadre ed eventualmente il tipo e/o parametro comuni a tutte le celle della colonna.\\ |
Ad esempio per visualizzare nelle celle della seconda colonna le icone ;; CN;; CN;CLI; AR;; e AR;ART; è sufficiente scrivere nell'xml Ogg="[ID1]", e nelle celle della colonna con codice ID1 specificare gli oggetti per ogni singola riga come segue:\\ |
<Griglia>\\ |
<Colonna Cod="ID1" Txt="colonna1" Tip="" Lun="3" IO="O" Ogg="" />\\ |
<Colonna Cod="ID2" Txt="colonna2" Tip="" Lun="15" IO="O" Ogg="[ID1]" />\\ |
</Griglia>\\ |
<Righe>\\ |
...\\ |
<Riga Fld="|00001"/>\\ |
<Riga Fld="CN|00001"/>\\ |
<Riga Fld="CNCLI|00001"/>\\ |
<Riga Fld="AR|00001"/>\\ |
<Riga Fld="ARART|00001"/>\\ |
...\\ |
</Righe>\\ |
\\ |
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_101.png' caption='esempio matrice con cella oggettizzata e tipo colonna eterogeneo' width='100%' style='max-width: 100%;'}]\\ |
Nel caso in cui le celle della colonna siano di uno stesso tipo, ad esempio CN;; CN;CLI; e CN;COL; , è sufficiente scrivere nell'xml Ogg="CN[ID1]", e nelle celle della colonna con codice ID1 specificare i parametri di ogni singola riga come segue:\\ |
<Griglia>\\ |
<Colonna Cod="ID1" Txt="colonna1" Tip="" Lun="3" IO="O" Ogg="" />\\ |
<Colonna Cod="ID2" Txt="colonna2" Tip="" Lun="15" IO="O" Ogg="CN[ID1]" />\\ |
</Griglia>\\ |
<Righe>\\ |
...\\ |
<Riga Fld="|00001"/>\\ |
<Riga Fld="CLI|00001"/>\\ |
<Riga Fld="COL|00001"/>\\ |
...\\ |
</Righe>\\ |
\\ |
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_102.png' caption='esempio matrice con cella oggettizzata e tipo colonna omogeneo' width='100%' style='max-width: 100%;'}]\\ |
!! Le icone dei componenti Java\\ |
I componenti Java, utilizzano delle icone che sono incluse nel file Loocup.jar.\\ |
La modifica delle icone è possibile solamente passando attraverso l'IDE Eclipse.\\ |
\\ |
! Classificazione delle icone\\ |
I componenti java, utilizzano due tipi di icone: quelle per i pulsanti/toolbar e quelle di altro tipo.\\ |
\\ |
Passiamo ad analizzare componente per componente le icone utilizzate\\ |
\\ |