Image.ImageOpened Evento

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

Si verifica quando l'origine dell'immagine viene scaricata e decodificata senza errori. È possibile usare questo evento per determinare le dimensioni naturali dell'origine dell'immagine.

// Register
event_token ImageOpened(RoutedEventHandler const& handler) const;

// Revoke with event_token
void ImageOpened(event_token const* cookie) const;

// Revoke with event_revoker
Image::ImageOpened_revoker ImageOpened(auto_revoke_t, RoutedEventHandler const& handler) const;

public event RoutedEventHandler ImageOpened;

function onImageOpened(eventArgs) { /* Your code */ }
image.addEventListener("imageopened", onImageOpened);
image.removeEventListener("imageopened", onImageOpened);
- or -
image.onimageopened = onImageOpened;

Public Custom Event ImageOpened As RoutedEventHandler 

<Image ImageOpened="eventhandler"/>

Tipo evento

RoutedEventHandler

Commenti

Quando ImageOpened viene attivato, che funge da notifica che tutte le operazioni asincrone sono state completate e tutte le proprietà dell'oggetto usato come origine dell'immagine sono pronte per l'uso. Ad esempio, per determinare le dimensioni dell'immagine, gestire ImageOpened e controllare il valore delle proprietà PixelWidth e PixelHeight nell'oggetto a cui si fa riferimento come Image.Source. I dati dell'evento ImageOpened non sono in genere utili.

Quando l'elemento Image non si trova nella struttura ad albero visuale attiva, l'elemento Image non genera eventi ImageOpened o ImageFailed . Se è necessario ricevere questi eventi mentre l'elemento non si trova nell'albero live, usare BitmapImage. ImageOpened/Eventi ImageFailed .

Comportamento di Windows 8

Per Windows 8, le risorse possono usare un modello di qualificatore di risorse per caricare risorse diverse a seconda del ridimensionamento specifico del dispositivo. Tuttavia, le risorse non vengono ricaricate automaticamente se il fattore di ridimensionamento cambia mentre l'app è in esecuzione. In questo caso, le app devono eseguire il ricaricamento delle risorse, gestendo l'evento DpiChanged (o l'evento LogicalDpiChanged deprecato) e usando l'API ResourceManager per ricaricare manualmente la risorsa appropriata per il nuovo fattore di ridimensionamento. A partire da Windows 8.1, tutte le risorse recuperate originariamente per l'app vengono valutate automaticamente se il fattore di ridimensionamento cambia durante l'esecuzione dell'app. Inoltre, quando tale risorsa è l'origine dell'immagine per un oggetto Image , uno degli eventi di caricamento di origine (ImageOpened o ImageFailed) viene generato in seguito all'azione del sistema di richiesta della nuova risorsa e quindi l'applicazione all'immagine. Lo scenario in cui può verificarsi una modifica della scalabilità in fase di esecuzione è se l'utente sposta l'app in un monitoraggio diverso quando è disponibile più di una.

Se esegui la migrazione del codice dell'app da Windows 8 a Windows 8.1 potresti voler tenere conto di questa modifica del comportamento, perché genera eventi ImageOpened o ImageFailed che si verificano in fase di esecuzione quando viene gestita la modifica della scala, anche nei casi in cui l'origine è impostata in XAML. Inoltre, se si dispone di codice che ha gestito DpiChangedLogicalDpiChanged/ e reimpostato le risorse, è necessario esaminare se tale codice è ancora necessario in base al nuovo comportamento di ricaricamento automatico Windows 8.1.

Le app create per Windows 8 che vengono eseguite in Windows 8.1 continuano a usare il comportamento di Windows 8.

Vedi anche

• ImageFailed
• Image e ImageBrush