proceduraScopo
Imposta l'immagine di sfondo della box.
Sintassi
Box.SetImage(file immagine)
Argomenti
| File Immagine | Stringa che rappresenta il nome del file immagine (completo di estensione) da mostrare come sfondo della box. |
Esempio
// *******************************
// Fired when a page is formatting
// *******************************
event Impiegati1.AziendeBook.AziendeBookPage.OnFormatting()
{
string FileName = "" //
//
// Estraggo il logo dalla tabella delle aziende
for each row
{
select
IDAzienda := ID
ImmagineAzienda := Immagine
from
Aziende // Master Table
where
ID = Parametri.ID
//
record Azienda
int ID // Brief description of field content.
string Immagine //
//
// Salvo il BLOB su disco
FileName := SaveBlobFile(Azienda.Immagine, ??, ??)
}
//
// Elimino dal path assoluto, il nome della directory dove è contenuto il
// sito WEB
FileName := Mid(FileName, Length(Path()) + C2, ??)
//
// Indico che la box utilizza l'immagine appena salvata
AziendeBook.Logo.SetImage(FileName)
}
// Fired when a page is formatting
// *******************************
event Impiegati1.AziendeBook.AziendeBookPage.OnFormatting()
{
string FileName = "" //
//
// Estraggo il logo dalla tabella delle aziende
for each row
{
select
IDAzienda := ID
ImmagineAzienda := Immagine
from
Aziende // Master Table
where
ID = Parametri.ID
//
record Azienda
int ID // Brief description of field content.
string Immagine //
//
// Salvo il BLOB su disco
FileName := SaveBlobFile(Azienda.Immagine, ??, ??)
}
//
// Elimino dal path assoluto, il nome della directory dove è contenuto il
// sito WEB
FileName := Mid(FileName, Length(Path()) + C2, ??)
//
// Indico che la box utilizza l'immagine appena salvata
AziendeBook.Logo.SetImage(FileName)
}
- Se il valore fornito alla procedura SetImage contiene il carattere / o \ il sistema considera tale valore come un nome di file completo, relativo alla root directory dell'applicazione web. Se, invece, il parametro non contiene il carattere / o \ il sistema suppone che l'immagine sia contenuta nella sottodirectory images dell'applicazione web; in quest'ultimo caso il sistema aggiunge il valore images/ davanti al nome fornito alla procedura.
- Il percorso che viene fornito alla procedura deve essere relativo alla root directory che contiene l'applicazione web. Il sistema aggiungerà poi il percorso della cartella che contiene l'applicazione web quando il book viene stampato su PDF. Qualora il book venga mostrato in anteprima in una videata WEB il sistema utilizzerà solo il percorso fornito alla procedura, eventualmente aggiungendo il testo images/ qualora il nome fornito non contenga i caratteri / o \.
- Se il book è contenuto in una porzione di videata web è consigliabile utilizzare solo immagini di tipo JPEG o GIF. Se il book è stamato su PDF è possibile utilizzare immagini di tipo BMP, JPEG e GIF.
- Se il valore del parametro è Empty String alla box sarà tolta l'immagine.
- Il modo in cui l'immagine si adatta alle dimensioni della box dipende dal valore del parametro Stretch.
- Normalmente la procedura SetImage viene utilizzata nell'evento di formattazione dell'oggetto che contiene la box per indicare quale immagine occorre mostrare all'interno della box.
- Attenzione: Se la procedura SetImage viene chiamata all'interno degli eventi di formattazione dell'oggetto che contiene la box (evento OnFormatting della pagina se la box è contenuta nella pagina o evento di BeforeFormatting della sezione se la box è contenuta in una sezione) la modifica ha effetto solo sulla box in fase di formattazione (consulta il videocorso Mastro On Formatting). Se la procedura SetImage viene chiamata al di fuori dagli eventi di formattazione dell'oggetto che contiene la box, da quel momento in poi tutte le copie della box utilizzeranno l'immagine fornita. In quest'ultimo caso è come se alla box fosse stata assegnata tale immagine a design-time.
- Se viene chiamata la procedura SetImage durante gli eventi di formattazione dell'oggetto che contiene la box o durante la procedura collegata alla box non è necessario ristampare il book. Tale modifica avrà effetto immediato. Qualora, invece, la modifica sia fatta fuori dagli eventi di validazione potrebbe essere necessario ristampare il book utilizzando la procedura Refresh dello stesso.
Ultima modifica: 02/11/2022 / Validità: da 6.5.2680