| dalla versione 8.5.3800 - modificato il 10/05/2010 - link - english
|
Scopo
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.
Applicazione.ShowTooltip(testo, titolo, id oggetto, ancora X, ancora Y,
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.
|
Note
-
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.
public void Webtop.MostraHelp(
optional int Ritardo = 0
)
{
Webtop.ShowTooltip(Benvenuti nell'applicazione di esempio del Webtop!!!
, ??, ??, ??, ??, ??, Ritardo, C30000, False, ??, ??, ??, ??, Empty String)
}
Cosa ne pensi?
Ti sono rimaste delle domande su punti che questo articolo non ha trattato? Pensi che sia utile aggiungere una nota all'articolo? Aiutaci a migliorare la documentazione di Instant Developer scrivendo il tuo commento nei campi qui sotto.