funzioneScopo
Restituisce il nome del book così come definito a design-time ovvero durante lo sviluppo dell'applicazione.
Sintassi
String Nome := Book.Name()
Argomenti
Questa funzione non ha argomenti.Valore di ritorno
Viene restituito il nome del book così come definito a design-time.
Esempio di codice
// ********************************************
// Mostra il book caricando il file XML fornito
// ********************************************
public void BookDaXML.MostraBookXML(
string FileName // Nome del file XML da mostrare
)
{
int Risultato = 0 //
//
// Carico il book da XML. Se ho successo proseguo
Risultato := XMLBook.LoadFromXML(Path() +c C/ +c BookXML/ +c FileName)
if Risultato = ZERO
{
// Rendo visibile il book e aggiorno il titolo che appare nell'intestazione
XMLBook.Visible := True
XMLBook.Caption := <font color=red> +c XMLBook.Name() +c </font>
//
// Stampo la prima pagina del book
XMLBook.Print(ONE, ONE)
}
}
// Mostra il book caricando il file XML fornito
// ********************************************
public void BookDaXML.MostraBookXML(
string FileName // Nome del file XML da mostrare
)
{
int Risultato = 0 //
//
// Carico il book da XML. Se ho successo proseguo
Risultato := XMLBook.LoadFromXML(Path() +c C/ +c BookXML/ +c FileName)
if Risultato = ZERO
{
// Rendo visibile il book e aggiorno il titolo che appare nell'intestazione
XMLBook.Visible := True
XMLBook.Caption := <font color=red> +c XMLBook.Name() +c </font>
//
// Stampo la prima pagina del book
XMLBook.Print(ONE, ONE)
}
}
- Normalmente questa funzione viene utilizzata per valorizzare la proprietà Caption di un book. Il valore di default della proprietà Caption, infatti, è proprio il nome del book come definito in fase di progettazione, lo stesso valore restituito dalla funzione Name. La differenza sostanziale è che se la proprietà Caption viene modificata a run-time la funzione Name restituisce ancora il nome "originale" del book.
- La funzione Name può risultare utile se si legge un book da XML. E' possibile, infatti, chiamare la funzione Name dopo aver caricato il book da XML per ottenere il nome del book. Questo può essere utile, per esempio, per aggiornare la Caption del book stesso se questo viene mostrato in anteprima in una videata WEB.
Ultima modifica: 06/10/2021 / Validità: da 6.5.2680