Scopo
Questa procedura serve per resettare il documento, annullandone tutte le proprietà, svuotando le collection e resettando gli stati. Può essere utile per preparare un'istanza del documento totalmente "bianca" per impostare criteri di ricerca o da utilizzare nei propri algoritmi.
Sintassi
Documento.Clear()
Argomenti
Questa procedura non ha argomenti.Esempio di codice
// *************************************
// Trova i prodotto che cominciano per C
// *************************************
public void Prodotti.BottoneTrova()
{
Prodotto p = new() // Un'oggetto prodotto
IDCollection c = new() // La collection da attaccare al pannello
//
// Resetto lo stato di p (in effetti lo avevo appena creato, ma se fosse stato globale lo avrei
// dovuto fare per forza)
p.Clear()
//
// Imposto un criterio di filtro QBE sul nome del prodotto: tutti i prodotti che iniziano per C
p.NomeProdotto := QBE C
//
// Carico la collection e la associo al pannello
p.LoadCollectionByExample(c, True, ZERO)
Prodotto.Collection := c
}
// Trova i prodotto che cominciano per C
// *************************************
public void Prodotti.BottoneTrova()
{
Prodotto p = new() // Un'oggetto prodotto
IDCollection c = new() // La collection da attaccare al pannello
//
// Resetto lo stato di p (in effetti lo avevo appena creato, ma se fosse stato globale lo avrei
// dovuto fare per forza)
p.Clear()
//
// Imposto un criterio di filtro QBE sul nome del prodotto: tutti i prodotti che iniziano per C
p.NomeProdotto := QBE C
//
// Carico la collection e la associo al pannello
p.LoadCollectionByExample(c, True, ZERO)
Prodotto.Collection := c
}
- Tutte le proprietà del documento vengono annullate e non impostate ad un valore di default. Le proprietà numeriche, ad esempio, valgono Null Number e non ZERO.
- Tutte le eventuali modifiche al documento vengono annullate e gli stati vengono resettati.
- Dopo aver resettato il documento è possibile usarlo per chiamare la funzione LoadCollectionByExample che considera solo le proprietà valorizzate come criteri di filtro.
- Tutte le eventuali modifiche al documento vengono annullate e gli stati vengono resettati.
- La chiamata a questa procedura causa la notifiica dell'evento OnClear sul documento.
Ultima modifica: 23/03/2021 / Validità: da 6.5.2680