Controllo Aggiungi immagine nelle app canvas

Scatta una foto o carica immagini dal dispositivo locale.

Descrizione

Con questo controllo gli utenti possono scattare foto o caricare i file di immagine dal proprio dispositivo e aggiornare l'origine dati con questo contenuto. In un dispositivo mobile viene visualizzata la finestra di dialogo in cui scegliere se scattare una foto o selezionarne una già disponibile.

Questo è un controllo raggruppato contenente due controlli: Immagine e Pulsante Aggiungi immagine. Il controllo Immagine consente di visualizzare l'immagine caricata o un segnaposto se non è stata caricata alcuna immagine. Il controllo Pulsante Aggiungi immagine consente di richiedere un'immagine da caricare.

Per le proprietà relative al controllo Immagine, vedi Controllo Immagine: informazioni di riferimento.

Limiti

Il controllo Immagine presenta le seguenti limitazioni:

• Quando si usa il controllo Aggiungi immagine in iOS, le immagini importate usando la fotocamera o la raccolta non contengono metadati come orientamento, informazioni sulla posizione o impostazioni relative alla videocamera.

Proprietà del controllo Pulsante Aggiungi immagine

AccessibleLabel: etichetta per le utilità per la lettura dello schermo. Deve descrivere lo scopo dell'aggiunta di un'immagine.

Align: posizione del testo in relazione al centro orizzontale del relativo controllo.

BorderColor: colore del bordo di un controllo.

BorderStyle: indica se il bordo di un controllo è Solid (Tinta unita), Dashed (Tratteggiato), Dotted (Punteggiato) o None (Nessuno).

BorderThickness: spessore del bordo di un controllo.

ChangePictureText: testo visualizzato sul controllo quando un'immagine viene caricata.

Color: colore del testo di un controllo.

DisabledBorderColor: colore del bordo di un controllo se la relativa proprietà DisplayMode è impostata su Disabled.

DisabledColor: colore del testo di un controllo se la relativa proprietà DisplayMode è impostata su Disabled.

DisabledFill: colore dello sfondo di un controllo se la relativa proprietà DisplayMode è impostata su Disabled.

DisplayMode: indica se il controllo consente l'input dell'utente (Edit), visualizza solo i dati (View) o è disabilitato (Disabled).

Error: in caso di problema di caricamento di un'immagine, questa proprietà contiene una stringa di errore appropriata.

Fill: colore dello sfondo di un controllo.

FocusedBorderColor: colore del bordo di un controllo quando è evidenziato.

FocusedBorderThickness: spessore del bordo di un controllo quando è evidenziato.

Font: nome della famiglia di caratteri in cui viene visualizzato il testo.

FontWeight: spessore del testo di un controllo. Può essere Bold (Grassetto), Semibold (Semibold), Normal (Normale) o Lighter (Sottile).

Height: distanza tra i bordi superiore e inferiore del controllo.

HoverBorderColor: colore del bordo di un controllo quando l'utente posiziona il puntatore del mouse su di esso.

HoverColor: colore del testo di un controllo quando l'utente posiziona il puntatore del mouse su tale controllo.

HoverFill: colore dello sfondo di un controllo quando l'utente posiziona il puntatore del mouse su di esso.

Italic: indica se il testo di un controllo è in corsivo.

Media: identificatore per il clip riprodotto da un controllo Audio o Video.

OnChange: azioni da eseguire quando l'utente modifica il valore di un controllo, ad esempio usando un dispositivo di scorrimento.

OnSelect: azioni da eseguire quando l'utente tocca o fa clic su un controllo.

Padding: distanza tra il testo di un pulsante di importazione o esportazione e il bordo di tale pulsante.

PressedBorderColor: colore del bordo di un controllo quando l'utente tocca o fa clic su tale controllo.

PressedColor: colore del testo di un controllo quando l'utente tocca o fa clic su tale controllo.

PressedFill: colore dello sfondo di un controllo quando l'utente tocca o fa clic su tale controllo.

Reset: indica se viene ripristinato il valore predefinito di un controllo.

Size: dimensione del carattere del testo visualizzato in un controllo.

Strikethrough: indica se viene visualizzata una riga all'interno del testo di un controllo.

TabIndex: ordine di spostamento tramite tastiera in relazione ad altri controlli.

Text: testo visualizzato sul controllo quando un'immagine non viene caricata.

Tooltip: testo descrittivo visualizzato quando l'utente posiziona il mouse su un controllo.

Underline: indica se il testo visualizzato nel controllo è sottolineato.

UseMobileCamera: indica se utilizzare direttamente una fotocamera per dispositivi mobili, se disponibile. Per i dispositivi Android, questa proprietà richiede l'impostazione sperimentale Acquisizione file multimediali migliorata attivata.

VerticalAlign: posizione del testo di un controllo in relazione al centro verticale di tale controllo.

Visible: indica se un controllo viene visualizzato o è nascosto.

Width: distanza tra i bordi sinistro e destro di un controllo.

X: distanza tra il bordo sinistro di un controllo e il bordo sinistro del contenitore padre o della schermata se non c'è un contenitore padre.

Y: distanza tra il bordo superiore di un controllo e il bordo superiore del contenitore padre o della schermata se non c'è un contenitore padre.

Funzioni correlate

Patch( DataSource, BaseRecord, ChangeRecord )

Esempi

Aggiungere immagini a un controllo Raccolta immagini

1. Aggiungi un controllo Aggiungi immagine e quindi fai clic tre volte su di esso.

   Non sai come aggiungere un controllo, assegnargli un nome e configurarlo?

2. Nella finestra di dialogo Apri tocca o fai clic su un file di immagine e quindi scegli Apri.

3. Aggiungi un controllo Pulsante, spostalo sotto al controllo Aggiungi immagine e imposta la proprietà OnSelect del controllo Pulsante sulla formula seguente:
   Collect(MyPix, AddMediaButton1.Media)

   Sono necessarie altre informazioni sulla funzione Collect o su altre funzioni?

4. Aggiungi un controllo Raccolta verticale e impostane la proprietà Items su MyPix.

5. Seleziona il controllo Immagine nella raccolta e impostane la proprietà Image su ThisItem.Value.

6. Premi F5 e quindi tocca o fai clic sul controllo Pulsante.

   L'immagine del controllo Aggiungi immagine verrà visualizzata nel controllo Raccolta verticale. Se l'immagine non ha le stesse proporzioni del controllo Immagine nel controllo Raccolta verticale, imposta la proprietà ImagePosition del controllo Immagine su Fit.

7. Tocca o fai clic sul controllo Aggiungi immagine, seleziona un altro file di immagine, scegli Aprie quindi tocca o fai clic sul controllo Pulsante.

   La seconda immagine verrà visualizzata nel controllo Raccolta immagini.

8. (Facoltativo) Ripeti il passaggio precedente una o più volte e quindi premi ESC per tornare all'area di lavoro predefinita.

Usa la funzione SaveData per salvare le immagini in locale o la funzione Patch per aggiornare un'origine dati.

Linee guida per l'accessibilità

Si applicano le stesse linee guida relative ai controlli Pulsante e Immagine. Tieni presenti anche le indicazioni seguenti:

Contrasto dei colori

• Il controllo Pulsante Aggiungi immagine deve avere sufficiente contrasto tra il testo e lo sfondo. Poiché l'immagine caricata può avere colori diversi, usa per Fill un colore opaco sul controllo Pulsante Aggiungi immagine per garantire un contrasto adeguato.

Supporto lettore schermo

• Il controllo Pulsante Aggiungi immagine deve avere proprietà Text e ChangePictureText che richiedono all'utente di aggiungere o modificare un'immagine.

Supporto per la tastiera

• Il valore di TabIndex per il controllo Pulsante Aggiungi immagine deve essere uguale o superiore a zero, in modo che gli utenti della tastiera possano passare a questo controllo.
• Il controllo Pulsante Aggiungi immagine deve avere indicatori di attivazione chiaramente visibili. A questo scopo, usa FocusedBorderColor e FocusedBorderThickness.