proceduraScopo
Questa procedura permette di mostrare un tooltip a video; può essere utile ad esempio per guidare l'utente principiante nell'uso dell'applicazione o per indicare dove cliccare.
Sintassi
Applicazione.ShowTooltip(testo, titolo, id oggetto, ancora X, ancora Y,
posizione, ritardo comparsa, ritardo sparizione, mostra su inattività,
larghezza, altezza, stile, baffo, immagine)
posizione, ritardo comparsa, ritardo sparizione, mostra su inattività,
larghezza, altezza, stile, baffo, immagine)
Argomenti
| Testo | Testo da mostrare nel tooltip; può contenere anche testo HTML. |
| Titolo | Opzionale: Titolo del tooltip. Se non impostato il tooltip mostrerà solo il testo. |
| ID Oggetto | Opzionale: ID dell'oggetto su cui ancorare il tooltip: può essere ottenuto tramite le funzioni GetRD3ID dei vari oggetti oppure può essere l'ID di un oggetto del DOM. |
| Ancora X | Opzionale: coordinata X a cui ancorare il tooltip qualora non sia stato valorizzato il parametro ID Oggetto. |
| Ancora Y | Opzionale: coordinata Y a cui ancorare il tooltip qualora non sia stato valorizzato il parametro ID Oggetto. |
| Posizione | Opzionale: è la posizione in cui deve apparire il tooltip rispetto alla sua ancora; può essere uno dei valori della lista TooltipPositions. Il default è Sopra. |
| Ritardo Comparsa | Opzionale: numero di millisecondi dopo i quali deve apparire il tooltip; impostare a 0 per farlo apparire subito. Se non impostato vale 750 millisecondi. Se impostato a -1 il tooltip si comporta come il QBETip, ovvero appare subito passando sopra all'oggetto e rimane visibile fino a che non ci si sposta dall'oggetto. |
| Ritardo Sparizione | Opzionale: numero di millisecondi dopo i quali il tooltip deve scomparire una volta che è comparso; impostare a 0 per non farlo mai scomparire: in tal caso apparirà il bottone di chiusura. Se non impostato vale 4 secondi. |
| Mostra su Inattività | Opzionale: indica se il tooltip deve apparire solo se l'utente non clicca con il mouse o pigia un tasto della tastiera da almeno un numero di millisecondi pari al valore del paramentro Ritardo Comparsa. Il default è Falso ovvero compare anche in caso di attività dell'utente. |
| Larghezza | Opzionale: larghezza in pixel del tooltip. Se non impostato il tooltip si adatta al suo contenuto. |
| Altezza | Opzionale: altezza in pixel del tooltip. Se non impostato il tooltip si adatta al suo contenuto. |
| Stile | Opzionale: stile grafico del tooltip; può valere uno dei valori della lista TooltipStyles o altri valori: in tal caso occorre aver creato le classi necessarie nel file custom.css e l'immagine con i bordi e il baffo nominata "tooltip_MioStile.gif" nella cartella images. |
| Baffo | Opzionale: indica se dev'essere mostrato il baffo. Il default è True. |
| Immagine | Opzionale: è l'immaginetta da mostrare di fianco al titolo. E' consigliato usare un'immagine di piccole dimensione. Se non impostata verrà mostrata un'icona in base allo stile. |
Esempio di codice
// ************************************************************
// Spiega quale elaborazione viene eseguita da questa procedura
// ************************************************************
public void Webtop.MostraHelp(
optional int Ritardo = 0 // Quali dati vuoi passare alla procedura?
)
{
Webtop.ShowTooltip(Benvenuti nell'applicazione di esempio del Webtop!!!
, ??, ??, ??, ??, ??, Ritardo, C30000, False, ??, ??, ??, ??, Empty String)
}
// Spiega quale elaborazione viene eseguita da questa procedura
// ************************************************************
public void Webtop.MostraHelp(
optional int Ritardo = 0 // Quali dati vuoi passare alla procedura?
)
{
Webtop.ShowTooltip(Benvenuti nell'applicazione di esempio del Webtop!!!
, ??, ??, ??, ??, ??, Ritardo, C30000, False, ??, ??, ??, ??, Empty String)
}
- Questa funzionalità è disponibile solo in RD3.
- Se non vengono impostati i parametri ID Oggetto oppure Ancora X e Ancora Y il tooltip apparirà al centro dello schermo.
- I parametri Ancora X e Ancora Y sono da valorizzare insieme ossia la valorizzazione di uno solo dei due non ha effetto.
- In IE6 i tooltip non hanno né i bordi arrotondati né il baffo.
- Si può ottenere il comportamento del QBETip impostato a -1 il parametro Ritardo Comparsa, ovvero apparizione immediata passando sopra all'oggetto e spazione solo spostandosi dall'oggetto.
Ultima modifica: 23/03/2021 / Validità: da 8.5.3800