Scopo
Rappresenta il documento attaccato al pannello. Può essere usata solo se il pannello è document oriented.
Sintassi
IDDocument doc = null // Il documento sulla riga selezionata del pannello
//
doc := Pannello.Document
//
doc := Pannello.Document
Quando letta
Ritorna un oggetto che deriva dalla libreria IDDocument che rappresenta il documento attaccato alla riga attiva del pannello, oppure alla riga per cui viene chiamato l'evento se essa viene letta all'interno di un evento di pannello.
Quando impostata
Attacca il documento al pannello come detail. E' equivalente a chiamare la procedura SetDocument con Master = False. Il documento deve essere un oggetto che deriva dalla libreria IDDocument.
Se è necessario attaccare un documento come master, è necessario utilizzare la procedura SetDocument.
Esempio di codice
// *************************************************
// Fired when the panel prepares data visualization.
// *************************************************
event EsploratoreCategorie.Prodotto.OnDynamicProperties()
{
Prodotto p = null // Il prodotto selezionato nel pannello
//
// Prelevo il documento dal pannello (è un prodotto!)
p := Prodotto.Document
//
// Se il prodotto c'è davvero e non è quindi una riga vuota
if NOT(p IS Null Object)
{
// Se il prodotto è sotto scorta...
if p.Scorte < p.LivelloDiRiordino
{
// Evidenzio il prodotto
Prodotto.NomeProdotto.SetVisualStyle(Rosso)
}
}
}
// Fired when the panel prepares data visualization.
// *************************************************
event EsploratoreCategorie.Prodotto.OnDynamicProperties()
{
Prodotto p = null // Il prodotto selezionato nel pannello
//
// Prelevo il documento dal pannello (è un prodotto!)
p := Prodotto.Document
//
// Se il prodotto c'è davvero e non è quindi una riga vuota
if NOT(p IS Null Object)
{
// Se il prodotto è sotto scorta...
if p.Scorte < p.LivelloDiRiordino
{
// Evidenzio il prodotto
Prodotto.NomeProdotto.SetVisualStyle(Rosso)
}
}
}
- La lettura di questa proprietà è molto frequente nella gestione di pannelli DO perchè permette di reperire subito il documento attaccato alla riga selezionata del pannello.
- Questa proprietà esegue una conversione implicita al tipo di variabile a cui si vuole assegnare e quindi non necessario un cast esplicito per assegnarla ad un oggetto in memoria. Se però i tipi non corrispondono si avrà un errore a runtime.
Ultima modifica: 23/03/2021 / Validità: da 6.5.2680