funzioneScopo
Chiede alla shell nativa di salvare la foto all'interno del dispositivo e restituirne il percorso assoluto.
Sintassi
string path = "" // Percorso della foto
//
path = Shell.getPhoto(IDAlbum, IDPhoto, [path], [quality], [width], [height])
//
path = Shell.getPhoto(IDAlbum, IDPhoto, [path], [quality], [width], [height])
Argomenti
| IDAlbum | È un parametro di tipo stringa e rappresenta il nome dell'album che contiene la foto di cui si desidera ottenere l'identificativo. Tale valore viene normalmente ottenuto chiamando la funzione GetAlbumID. |
| IDPhoto | È un parametro di tipo stringa e rappresenta l'identificativo della foto di cui si desidera ottenere l'immagine. Tale valore viene normalmente ottenuto chiamando la funzione GetPhotoID. |
| Path | Directory in cui salvare la foto (se vuota il sistema salva la foto nella cartella TEMP dell'applicazione). |
| Quality | È un parametro opzionale di tipo intero e rappresenta la qualità dell'immagine (0-100). Il valore di default è 100. |
| Width | È un parametro opzionale di tipo intero e rappresenta la larghezza dell'immagine in pixel. |
| Height | È un parametro opzionale di tipo intero e rappresenta l'altezza dell'immagine in pixel. |
Valore di ritorno
Viene restituito un percorso assoluto che punta alla copia della foto all'interno del dispositivo. Normalmente questo percorso viene utilizzato per mostrare in anteprima l'immagine mediante i metodi SetImage delle box o Image dei campi di pannello. Se l'applicazione viene eseguita fuori dalla shell nativa, la funzione restituisce il valore Null.
Esempio di codice
public void Rullino.ElencaFoto()
{
for (int alb = 0; alb < Shell.getAlbumCount(); alb = alb + 1)
{
string albumName = Shell.getAlbumID(alb)
for (int f = 0; f < Shell.getPhotoCount(albumName); f = f + 1)
{
string pictureID = Shell.getPhotoID(albumName, f)
string thumbPath = Shell.getPhotoThumbnail(albumName, pictureID, ...)
date time pictureDT = Shell.getPhotoDateTime(albumName, pictureID)
}
}
}
{
for (int alb = 0; alb < Shell.getAlbumCount(); alb = alb + 1)
{
string albumName = Shell.getAlbumID(alb)
for (int f = 0; f < Shell.getPhotoCount(albumName); f = f + 1)
{
string pictureID = Shell.getPhotoID(albumName, f)
string thumbPath = Shell.getPhotoThumbnail(albumName, pictureID, ...)
date time pictureDT = Shell.getPhotoDateTime(albumName, pictureID)
}
}
}
- La funzione può essere utilizzata unicamente in un'applicazione offline avviata dentro alla shell nativa. Se viene eseguita in una applicazione non offline (C#/Java) o in un'applicazione web offline fuori dalla shell nativa, il sistema genera un'eccezione.
Ultima modifica: 25/10/2016 / Validità: da 12.0.5200