proceduraScopo
Aggiunge un valore alla lista valori associata al campo.
Sintassi
Pannello.Campo.AddValueListItem(valore, nome, [descrizione], [icona], [stile], [whereclause])
Argomenti
| Valore | Valore che il campo può assumere. Nota: tutti i valori della lista devono essere dello stesso tipo del campo. |
| Nome | Nome che appare a video quando il campo assume questo valore. |
| Descrizione | Parametro opzionale di tipo carattere che rappresenta la descrizione estesa di questo valore. Appare come tooltip della cella quando è in sola lettura. |
| Immagine | Parametro opzionale di tipo carattere che rappresenta l'immagine (icona) che rappresenta il valore. Viene mostrata di fianco al nome quando la cella è in sola lettura. |
| Stile | Parametro opzionale di tipo intero che rappresenta lo stile visuale associato al valore della lista. |
| WhereClause | Where clause opzionale da utilizzare per il caricamento dei figli. |
Esempio di codice
// ************************************************
// Modifica la lista dei possibili valori del campo
// ************************************************
public void Prodotti1.BottoneMLV()
{
// Tolgo i valori precedenti
Prodotti.Sospeso.ClearValueList()
//
// Aggiungo i nuovi valori
Prodotti.Sospeso.AddValueListItem(C-1, Sì, MSG Prodotto Sospeso, ??)
Prodotti.Sospeso.AddValueListItem(ZERO, No, MSG Prodotto Attivo, ??)
Prodotti.Sospeso.AddValueListItem(ONE, Boh, MSG Non si sa, ??)
//
// Aggiorno il video perchè non avviene in automatico
this.UpdateScreen()
Prodotti.RefreshQuery()
}
// Modifica la lista dei possibili valori del campo
// ************************************************
public void Prodotti1.BottoneMLV()
{
// Tolgo i valori precedenti
Prodotti.Sospeso.ClearValueList()
//
// Aggiungo i nuovi valori
Prodotti.Sospeso.AddValueListItem(C-1, Sì, MSG Prodotto Sospeso, ??)
Prodotti.Sospeso.AddValueListItem(ZERO, No, MSG Prodotto Attivo, ??)
Prodotti.Sospeso.AddValueListItem(ONE, Boh, MSG Non si sa, ??)
//
// Aggiorno il video perchè non avviene in automatico
this.UpdateScreen()
Prodotti.RefreshQuery()
}
- Tramite questa procedura è possibile associare una lista valori anche a campi che non l'avevano a design-time.
- E' importante che tutti i valori aggiunti alla lista siano dello stesso tipo del campo.
- Attenzione: Le procedure ClearValueList e AddValueListItem operano sulla colonna del pannello e non su una singola cella dello stesso. Quindi tutte le righe del pannello hanno lo stesso set di possibili valori. Non è possibile specificare per ogni singola riga del pannello un insieme di valori diverso dalle altre righe utilizzando le due procedure indicate. E', invece, possibile specificare valori differenti per ogni riga sia utilizzando value source su tabelle del database sia utilizzando una value source di tipo Document Oriented.
Ultima modifica: 22/02/2022 / Validità: da 6.5.2680