proprietàScopo
Rappresenta il documento mostrato nel form. Si usa questa proprietà quando il form nasce per mostrare o editare uno specifico documento. Ad esempio, se il form nasce per gestire un ordine cliente o una lista di ordini, allora è conveniente collegare l'ordine in fase di editing al form.
Sintassi
IDDocument Doc = null // Prendo il documento collegato
//
Doc := Form.Document
//
Doc := Form.Document
Quando letta
Ritorna un oggetto di tipo Document Orientation">IDDocument, rappresentante il documento attualmente collegato al form. Se il form non possiede documenti collegati viene ritornato un ogetto nullo (costante Null Object).
Quando impostata
Collega il documento al form, gestendo automaticamente la Caption della schermata e scatenando l'evento di OnChangeDocument.
Esempio di codice
// ***************************************************************
// Nell'evento di ActivateDoc metto il documento nel form prodotto
// ***************************************************************
event AlberoProdotti.Albero.OnActivateDoc(
IDDocument Document // Source document that has been activated
inout boolean Cancel // Set to True to cancel further processing (if Fal...
)
{
// Collego il documento al pannello ProdottiDO e imposto il layout form
ProdottiDO.Prodotto.SetDocument(Document, ??)
ProdottiDO.Prodotto.Layout := Form
//
// Collego il documento al form in modo da sfruttare la gestione automatica
// eseguita dal framework
ProdottiDO.Document := Document
}
// Nell'evento di ActivateDoc metto il documento nel form prodotto
// ***************************************************************
event AlberoProdotti.Albero.OnActivateDoc(
IDDocument Document // Source document that has been activated
inout boolean Cancel // Set to True to cancel further processing (if Fal...
)
{
// Collego il documento al pannello ProdottiDO e imposto il layout form
ProdottiDO.Prodotto.SetDocument(Document, ??)
ProdottiDO.Prodotto.Layout := Form
//
// Collego il documento al form in modo da sfruttare la gestione automatica
// eseguita dal framework
ProdottiDO.Document := Document
}
Se una videata ha un documento collegato, si attivano i seguenti automatismi;
- Il titolo della form mostra il nome completo del documento, utilizzando i colori per evidenziarlo meglio.
- Se il documento è modificato, viene aggiunto un * al titolo della form.
- Se si cerca di chiudere la form ed il documento è modificato, allora in base alla proprietà AutoSaveType si cerca di salvare il documento oppure si annulla la chiusura avvertendo l'utente della situazione.
Ultima modifica: 23/03/2021 / Validità: da 6.5.2680