English
Instant Developer Foundation Documentazione
  • Reference Librerie
  • Oggetti UI
  • Libreria Grafico
  • Proprietà

Caption

proprietà copia link

Scopo

Proprietà di tipo stringa che rappresenta il titolo del riquadro che contiene il grafico. E' equivalente alle proprietà corrispondenti del pannello o dei book e viene visualizzata nella barra del titolo del riquadro, al di fuori dell'immagine del grafico; se si desidera includere un titolo nel grafico, si può usare la proprietà Title.

Un possibile utilizzo della proprietà Caption è quello di cambiare l'intestazione del grafico a runtime, ad esempio a seconda della riga selezionata in un pannello.

Sintassi

String Nome = "" // Recupero il nome del grafico
// 
Nome := Grafico.Caption

Quando letta

Restituisce una stringa che contiene il titolo del riquadro del grafico.

Quando impostata

Definisce il nome del grafico. Tale nome viene mostrato come titolo del riquadro in cui è contenuto il grafico.

Esempio di codice

// *********************************************
// Notificato quando l'utente clicca sul grafico
// *********************************************

event MasterDetail.Vendite.GraphClickEvent(
  int SerieNumber // Indica quale serie è stata cliccata (da 1 al numero di serie)
)
{
  int idx = 1 // 
  // 
  // Rendo visibile il grafico

  Storico.Visible := True
  // 
  // Modifichiamo la Caption del grafico a seconda dell'area selezionata

  Storico.Caption := Vendite.Area
  // 
  // Modifichiamo il titolo del grafico

  Storico.Title := Storico Vendite +c Space +c Vendite.Area
  // 
  // Ciclo su tutte le righe della tabella fino a trovare quella selezionata

  for each row
  {
    select
      NOMEOggetto := AREE.NOME
    from
      VENDITE // Tabella Master
      AREE    // Collegata con la tabella VENDITE usando la FK Area
    where
      VENDITE.ANNO = C2007
    // 
    record Vendita
      string NOMEOggetto // 
    // 
    // Se è la riga selezionata uso l'indice per separare la sezione

    if Vendita.NOMEOggetto = Vendite.Area
    {
      Vendite.SetExplosion(idx, C0.5)
    }
    else  // Altrimenti azzero la separazione per la sezione
    {
      Vendite.SetExplosion(idx, ZERO)
    }
    idx := idx + ONE
  }
}
  • La proprietà Caption non viene codificata per consentire l'uso di tag HTML. Se viene utilizzata una stringa che contiene caratteri speciali - ad esempio un & - potrebbe non venire visualizzata come atteso.
  • La barra del titolo del riquadro può essere nascosta per mostrare solo l'immagine del grafico. Questo può esserre ottenuto tramite il flag "Nascondi Riquadro" nella videata delle proprietà del grafico stesso.
  • Se il grafico è contenuto in una visualizzazione a schede (tabbed view), il titolo del grafico può essere variato indipendentemente dal titolo della scheda. Per modificare il titolo della scheda occorre utilizzare la funzione Set Caption della tabbed view.

Ultima modifica: 25/10/2016 / Validità: da 7.1.3300

Vedi anche

  • Caption (proprietà)
  • Title (proprietà)
  • UpdateGraph (procedura)
  • Set Caption (procedura)

Hai trovato utile l'articolo?

Grazie per il feedback!

Ti serve altro aiuto?

Consulta il Forum