Scopo
Questa funzione permette di recuperare il documento nel punto indicato della collection. Può essere utile durante la procedura di caricamento ritardato di una collection per verificare se un determinato punto della collection è già stato caricato o meno.
Sintassi
IDDocument doc := Collection.GetDirect(posizione)
Argomenti
| Posizione | E' un numero intero che rappresenta l'indice della locazione da cui recuperare il documento. Può variare fra 1 e il numero di elementi nella collection |
Valore di ritorno
E' un oggetto di tipo IDDocument presente nel punto indicato nella collection. Può essere null se alla locazione indicata la collection non era ancora stata caricata oppure se il parametro posizione è fuori dai limiti ammessi.
Esempio di codice
// ****************************************************************************
// Evento notificato al documento durante il caricamento ritardato di una
// collection
// ****************************************************************************
event Divisa.OnMissingDocument(
int Position // Posizione nella collection a cu...
IDCollection Collection of IDDocument // Collection a cui impostare il d...
)
{
Divisa d := New() // Nuovo documento
//
// Imposto le proprietà del nuovo documento
d.Descrizione := bla bla
d.SetOriginal()
//
// Se non c'era già un documento,
if Collection.GetDirect(Position) IS Null Object
{
// Lo passo alla collection nel punto desiderato
Collection.SetDirect(Position, d)
}
}
// Evento notificato al documento durante il caricamento ritardato di una
// collection
// ****************************************************************************
event Divisa.OnMissingDocument(
int Position // Posizione nella collection a cu...
IDCollection Collection of IDDocument // Collection a cui impostare il d...
)
{
Divisa d := New() // Nuovo documento
//
// Imposto le proprietà del nuovo documento
d.Descrizione := bla bla
d.SetOriginal()
//
// Se non c'era già un documento,
if Collection.GetDirect(Position) IS Null Object
{
// Lo passo alla collection nel punto desiderato
Collection.SetDirect(Position, d)
}
}
L'uso di questa funzione è riservato alla gestione dell'evento OnMissingDocument.
Ultima modifica: 25/10/2016 / Validità: da 8.5.3800
funzione