Supporto delle notifiche di riquadri e avvisi popup per lingua, fattore di scala e contrasto elevato.

  • Articolo

I riquadri e gli avvisi popup possono caricare stringhe e immagini personalizzate per il linguaggio di visualizzazione, il fattore di scala di visualizzazione, il contrasto elevato e altri contesti di runtime. Per informazioni di base su come usare qualificatori nei nomi dei file di risorse, vedi Personalizzare le risorse per lingua, scalabilità e altri qualificatori e icone e logo delle app.

Per altre informazioni sulla proposta di valore associata alla localizzazione dell'app, vedi Globalizzazione e localizzazione.

Fare riferimento a una risorsa stringa da un modello

Nel modello di riquadro o avviso popup è possibile fare riferimento a una risorsa stringa usando lo ms-resource schema URI (Uniform Resource Identifier) seguito da un identificatore di risorsa stringa semplice. Ad esempio, se disponi di un file Resources.resx che contiene una voce di risorsa il cui nome è "Farewell", allora disponi di una risorsa stringa con l'identificatore "Farewell". Per altre info sugli identificatori di risorsa stringa e sui file di risorse (con estensione resw), vedi Localizzare le stringhe nell'interfaccia utente e nel manifesto del pacchetto dell'app.

Questo è il modo in cui un riferimento all'identificatore di risorsa stringa "Farewell" apparirà nel corpo del testo del contenuto del modello, usando ms-resource.

<text id="1">ms-resource:Farewell</text>

Se ometti lo ms-resource schema URI, il corpo del testo è solo un valore letterale stringa e non un riferimento a un identificatore.

<text id="1">Farewell</text>

Fare riferimento a una risorsa immagine da un modello

Nel modello di riquadro o avviso popup puoi fare riferimento a una risorsa immagine usando lo ms-appx schema URI (Uniform Resource Identifier) seguito dal nome della risorsa immagine. Questo è lo stesso modo in cui si fa riferimento a una risorsa immagine nel markup XAML (per altri dettagli, vedi Fare riferimento a un'immagine o a un altro asset dal markup e dal codice XAML).

Ad esempio, è possibile denominare cartelle come questa.

\Assets\Images\contrast-standard\welcome.png
\Assets\Images\contrast-high\welcome.png

In tal caso, si dispone di una singola risorsa immagine e il relativo nome (come percorso assoluto) è /Assets/Images/welcome.png. Ecco come usare il nome nel modello.

<image id="1" src="ms-appx:///Assets/Images/welcome.png"/>

Osserva che in questo esempio URI lo schema ("ms-appx") è seguito da "://" seguito da un percorso assoluto (un percorso assoluto inizia con "/").

Hosting e caricamento di immagini nel cloud

Gli ms-resource schemi URI e ms-appx eseguono la corrispondenza automatica dei qualificatori per trovare la risorsa più appropriata per il contesto corrente. Gli schemi URI Web (ad esempio, http, httpse ftp) non eseguono tali corrispondenze automatiche.

Aggiungere invece all'URI dell'immagine una stringa di query che descrive il valore o i valori del qualificatore richiesti.

<image id="1" src="http://www.contoso.com/Assets/Images/welcome.png?ms-lang=en-US"/>

Quindi, nel servizio app che fornisce le immagini implementare un gestore HTTP che controlla e usa la stringa di query per determinare quale immagine restituire.

È anche necessario impostare l'attributo addImageQuery su true nel payload XML delle notifiche di tipo riquadro o avviso popup+. L'attributo addImageQuery viene visualizzato negli visualelementi , bindinge image degli schemi sia del riquadro che degli schemi di tipo avviso popup. L'impostazione esplicita di addImageQuery su un elemento esegue l'override di qualsiasi valore impostato su un predecessore. Ad esempio, un valore addImageQuery di true in un image elemento esegue l'override di addImageQuery di false nell'elemento padrebinding.

Si tratta delle stringhe di query che è possibile usare.

Qualifier Stringa di query Esempio
Ridimensiona ms-scale ?ms-scale=400
Lingua ms-lang ?ms-lang=en-US
Contrasto ms-contrast ?ms-contrast=high

Per una tabella di riferimento di tutti i possibili valori qualificatori che è possibile usare nelle stringhe di query, vedere ResourceContext.QualifierValues.

API importanti