Condizioni di notifica
Questo evento viene notificato al documento quando una visualizzazione ad albero vuole sapere quale icona mostrare a fianco del nodo corrispondente. Qualora non venga implementato, l'albero mostrerà l'icona associata a design time alla classe corrispondente.
Utilizzo consigliato
Questo evento può essere utilizzato per mostrare icone legate al singolo documento, invece che alla classe che implementa il documento.
Argomenti
| Icon | Parametro di input/output di tipo stringa che rappresenta il file icona che deve essere associato al nodo corrispondente al documento. L'icona deve risiedere nella sotto-directory images della web application. |
| Icon Type | Il parametro IconType vale 0 se il nodo è chiuso e 1 se il nodo è aperto. |
| Caller Collection | Collection in cui è contenuto il documento. Può essere diversa dalla ParentCollection se il documento è contenuto per reference. |
| Caller Form | Form che contiene l'albero per cui l'evento viene chiamato. Usare la funzione Me dell'oggetto Form per effettuare i confronti. Può valere ZERO per non indicare una form in particolare. |
| Caller Frame | Albero per cui viene chiamato l'evento. Utilizzare la funzione Me dell'oggetto Tree per effettuare i confronti. Può valere ZERO per non indicare un oggetto visuale in particolare. |
Esempio di codice
// ********************************************************************
// Fired by a tree to know which icon should by shown for this document
// ********************************************************************
event Categoria.OnGetIcon(
inout string Icon // File name to load
int IconType // Icon Type (i.e. 0 = standard icon)
IDCollection CallerCollection // This is the collection this document is contained in.
int CallerForm // Caller Form Index
int CallerFrame // Caller Frame Index
)
{
// Se la collection prodotti è caricata...
if Prodotti.Loaded
{
// Uso l'icona PRODOTTI
Icon := Convert(ToImage(Prodotto))
}
else // Altrimento l'icona con il ?
{
Icon := Convert(ToImage(Categoria))
}
}
// Fired by a tree to know which icon should by shown for this document
// ********************************************************************
event Categoria.OnGetIcon(
inout string Icon // File name to load
int IconType // Icon Type (i.e. 0 = standard icon)
IDCollection CallerCollection // This is the collection this document is contained in.
int CallerForm // Caller Form Index
int CallerFrame // Caller Frame Index
)
{
// Se la collection prodotti è caricata...
if Prodotti.Loaded
{
// Uso l'icona PRODOTTI
Icon := Convert(ToImage(Prodotto))
}
else // Altrimento l'icona con il ?
{
Icon := Convert(ToImage(Categoria))
}
}
- Questo evento potrebbe essere notificato anche in contesti diversi dalla visualizzazione ad albero.
- A partire dalla versione 8.1.3650 il sistema notifica l'evento ogni volta che un nodo di un albero DO viene aperto o chiuso.
Ultima modifica: 22/09/2021 / Validità: da 8.1.3650
evento