Scopo
Questa proprietà rappresenta la frequenza con cui gli scrolltip vengono generati automaticamente. Si ricorda che gli scrolltip automatici vengono generati solo se la lista dei record è ordinata per una o più colonne.
Sintassi
Pannello.ScrollTipRate := valore
Quando letta
Ritorna un numero intero che rappresenta la frequenza attuale di calcolo degli scrolltip.
Quando scritta
Modifica le impostazioni attuali. I possibili valori sono:
- -1: Questo è il valore di default e si consiglia di non modificarlo. Il sistema calcolerà automaticamente la frequenza degli scrolltip in base alla grandezza del pannello e al numero di record e ottimizzerà sia l'esperienza utente che la quantità di dati scaricati.
- 0: Impostando a zero questa proprietà, gli scrolltip automatici non verranno generati. Si consiglia di impostare questo valore se si desidera disabilitare o personalizzare gli scrolltip.
- 1: Se si imposta a 1 questa proprietà, gli scrolltip verranno generati per tutte le righe della lista. Questo può richiedere sia tempo di elaborazione che tempo per lo scaricamento dei risultati. Si consiglia di non impostare questo valore se il numero di righe che il pannello può contenere è maggiore di 100.
- n (>1): In questo caso gli scrolltip verranno generati ogni n righe. Per ottimizzare l'esperienza utente si consiglia di mantenere il valore -1 con cui la frequenza ottimale viene calcolata dal sistema.
Note
- Dopo aver modificato il valore della proprietà occorre richiamare il metodo RefreshScrollTips che si occupa di ricalcolare ed inviare al client i nuovi scrolltip.
- Quando non sono presenti scrolltip la scrollbar è libermente posizionabile. Se invece essi sono presenti, la scrollbar comanda il posizionamento del pannello alla riga corrispondente allo scrolltip "più vicino". Il numero di scrolltip e la loro frequenza determinano quindi la granularità dello scrolling.
Esempio di codice
// ****************************
// Pulsante scrolltip ogni riga
// ****************************
public void PannelliAccoppiati.ScrolltipOgniRiga()
{
// Tutte le righe avranno uno scroll tip, se sono troppe però diventa inutile e dannoso:
// troppi dati scaricati sul client!
ProdottiLista.ScrollTipRate := ONE
//
// Mando i nuovi tip al client
ProdottiLista.RefreshScrollTips()
}
// Pulsante scrolltip ogni riga
// ****************************
public void PannelliAccoppiati.ScrolltipOgniRiga()
{
// Tutte le righe avranno uno scroll tip, se sono troppe però diventa inutile e dannoso:
// troppi dati scaricati sul client!
ProdottiLista.ScrollTipRate := ONE
//
// Mando i nuovi tip al client
ProdottiLista.RefreshScrollTips()
}
Ultima modifica: 23/03/2021 / Validità: da 6.8.3060