Developpement Windows Phone – partie 14


Images

Cet article fait partie d’une série d’articles sur le développement Windows Phone. Il s’agit d’une traduction des articles se trouvant sur la MSDN.

Sommaire

Bien débuter et fondamentaux

Visuels et média

Travailler avec les données

Sondes et autres fonctionnalités spécifiques au téléphone


Data Binding

La plupart des applications Windows Phone affichent des données dans les contrôles. Dans de nombreux cas, les données sont des objets business tels que des actions en bourse, des titres de news ou des images. En plus, vous voulez souvent autoriser l'utilisateur à sélectionner un élément depuis une liste puis afficher les détails relatifs à cet élément dans un autre contrôle comme par exemple une zone de texte.

Ce tutoriel montre comment lier un contrôle à un simple élément et comment lier un contrôle de liste à une collection d'éléments, De plus, vous verrez au sein de cet article comment personnaliser l'affichage des éléments, comment implémenter une vue détaillée basée sur une sélection et comment convertir les données avant de les afficher.

Ce tutoriel contient les sections suivantes:


Images

Dans Silverlight pour Windows Phone 7, vous avez plusieurs options pour afficher des images telles que des photos ou des diagrammes. Ce tutoriel décrit comment intégrer des images dans vos applications Windows Phone.

Ce tutoriel contient les sections suivantes:

Image et ImageBrush

Pour afficher une image, vous pouvez utiliser au choix un objet Image ou un objet ImageBrush. L’exemple suivant montre comment afficher une image nommée licorige.jpg en utilisant un objet Image.

XAML
  1. <Image Source="licorice.JPG" />

La capture suivante montre le résultat dans l’émulateur.

image_thumb1

Dans cet exemple, la propriété Source spécifie l’emplacement de l’image que vous voulez afficher. Vous pouvez spécifier la Source avec un chemin absolu (par exemple, http://contoso.com/myPicture.jpg) ou en spécifiant l’URL d’un fichier qui est inclut dans le fichier XAP. Pour ajouter une image à votre application, effectuez les opérations suivantes dans Visual Studio:

  1. Dans le menu Projet, sélectionnez Ajouter un élément existant.
  2. Sélectionnez le fichier image et cliquez sur Ajouter.
  3. Dans l’explorateur de solution, sélectionnez l’image qui vient d’être ajoutée.
  4. Dans la fenêtre des propriétés, changez la propriété Build Action sur Content.

Ainsi, lorsque l’application est compilée, le fichier image est inclut dans le XAP.

Remarque

Silverlight pour Windows Phone ne supporte pas tous les formats d’images. La classe BitmapImage peut être utilisée pour référence des images dans les formats JPEG et PNG. Pour plus d’informations sur les sources d’images ou les formats qui peuvent être utilisés pour un objet Image, regardez BitmapImage.

L’objet ImageBrush vous autorise à utiliser une image pour peindre une zone qui prend un objet Brush. Par exemple, ImageBrush peut être utilisé comme valeur pour la propriété Background d'un Panel. Pour plus d'informations sur les pinceaux, lisez l'article suivant Pinceaux.

Voici un exemple qui montre comment l'image licorice est peinte au sein d'un texte

XAML
  1. <!-- TextBlock with an image brush applied to the text. -->
  2. <TextBlock Margin="20"
  3. Text="LICORICE"
  4. FontFamily="Verdana"
  5. FontSize="80"
  6. FontWeight="Bold">
  7. <TextBlock.Foreground>
  8. <ImageBrush ImageSource="licorice.JPG"/>
  9. </TextBlock.Foreground>
  10. </TextBlock>

Voici le résultat dans l'émulateur.

image_thumb3

Etirer une Image

Si vous ne définissez pas les valeurs Width ou Height d'une Image, alors elle sera affichée avec les dimensions de l'image spécifiée par la propriété Source. Le fait de définir les propriétés Width et Height créé une zone rectangulaire dans laquelle se trouvera l'image. Vous pouvez spécifier comment l'image remplira cette zone en utilisant la propriété Stretch qui accepte les valeurs suivantes:

  • None: l'image ne s'étend pas pour remplir les dimensions de sortie.
  • Uniform: l'image est déformée pour remplir les dimensions de la zone. Mais le ratio d'affichage est préservé. C'est la valeur par défaut.
  • UniformToFill: L'image est agrandie pour remplir complètement la zone mais préserve son ratio. (une partie de l'image peut alors ne pas être visible).
  • Fill: L'image est déformée pour remplir la zone. Le ratio peut alors ne pas être respecté et l'image s'en retrouve potentiellement avec un ratio totalement différent que celui de son image source.

L'illustration suivante montre les différents paramétrages possibles de la propriété Stretch.

image_thumb5

Rogner une Image

Vous pouvez utiliser la propriété Clip pour détourer une zone d’une Image. Vous définissez la propriété Clip sur un objet Geometry, ce qui vous permet de découper une variété de formes géométriques dans votre Image (par exemple, une ellipse, ligne ou un chemin complexe). Pour plus d’informations sur l’utilisation des géométries, lisez la présentation des Géométries sur MSDN.

L’exemple suivant montre comment utiliser un EllipseGeometry comme région de découpage pour une Image. Dans cet exemple, un objet Image est défini avec la propriété Source définie avec un fichier image. Un objet EllipseGeometry avec une valeur RadiusX de 125, une valeur RadiusY de 100, et une valeur Center de 225,175 est définie pour la propriété Clip de l’Image. Seule la partie de l’image qui est dans la zone de l’ellipse sera affichée.

XAML
  1. <Image Source="Licorice.JPG">
  2. <Image.Clip>
  3. <EllipseGeometry RadiusX="125" RadiusY="100" Center="225,175"/>
  4. </Image.Clip>
  5. </Image>

Voici le résultat dans l’émulateur.

image_thumb7

Appliquer un masque d’opacité

Vous pouvez appliquer un OpacityMask sur une Image pour créer une variété de techniques de masques d’opacité comme par exemple des effets de vignettage.

L’exemple suivant montre comment appliquer un dégradé radial sur une Image avec des fondus sur les bords (effet de vignette).

XAML
  1. <Image Source="licorice.jpg" >
  2. <Image.OpacityMask>
  3. <RadialGradientBrush GradientOrigin="0.5,0.5"
  4. Center="0.5,0.5"
  5. RadiusX="0.5"
  6. RadiusY="0.5">
  7. <!-- These Gradient Stop colors are only changing the
  8. alpha values so the image fades out toward the edges. -->
  9. <GradientStop Color="#ffffffff" Offset="0.5" />
  10. <GradientStop Color="#00ffffff" Offset="0.8" />
  11. </RadialGradientBrush>
  12. </Image.OpacityMask>
  13. </Image>

Voici le résultat dans l’émulateur.

image_thumb9

Remarque

Vous pouvez utiliser une variété d’objets Brush pour un masque d’opacité. Pour plus d’informations sur les pinceaux dans Silverlight pour Windows Phone, lisez l’article Brushes QuickStart.

Créer des WriteableBitmaps

Un objet WriteableBitmap fournit une BitmapSource qui peut être modifiée. Cela vous permet de modifier les données à la volée et de mettre à jour l'image.

Vous pouvez passer une BitmapSource, les dimensions d'une nouvelle bitmap ou un UIElement au constructeur du WriteableBitmap. Passer un UIElement va créer une image bitmap de l'élément visuel. Par exemple, si vous voulez une image de tout l'arbre visuel, vous pouvez passer l'élément UIElement racine au constructeur.

La propriété Pixels du WriteableBitmap est un tableau qui représente la texture 2D du bitmap. Vous pouvez altérer l'image en modifiant les valeurs des pixels dans ce tableau.

Remarque

Le format utilisé par l'objet WriteableBitmap de Silverlight est ARGB32. Ainsi, les pixels dans le tableau de pixels d'un WriteableBitmap sont stockés en tant que couleurs pré-multipliées. Chaque canal de couleur est pré-multiplié par la valeur alpha.

Remarque

Les objets MediaElement n'apparaitront pas dans les captures WriteableBitmap. C'est parce que les MediaElements sont affichés entièrement de façon hardware dans Silverlight pour Windows Phone.

L'exemple suivant montre comment créer une image WriteableBitmap depuis un objet Image et comment modifier le WriteableBitmap. Pour créer l'objet WriteableBitmap, la propriété Source de l' Image est castée en BitmapSource et est passée en paramètre au constructeur de WriteableBitmap. Lorsque le bouton "Modify Pixels" est cliqué, le gestionnaire d'évènement itère sur le tableau de Pixels du bitmap et définit chacun d'entre eux sur noir. L'objet Image est alors modifié par ce bitmap et est réaffiché.

Pour essayer cet exemple, cliquez sur Modify Pixels pour voir comment l'image est distordue.

Remarque

Cet exemple live utilise Silverlight pour simuler le comportement du Windows Phone. Le comportement peut néanmoins être légèrement différent dans l'émulateur Windows Phone ou d’un vrai Windows Phone.

XAML
  1. <StackPanel>
  2. <Image Name="ImageToModify" Source="licorice.jpg" />
  3. <StackPanel Orientation="Horizontal" HorizontalAlignment="Center" Margin="30" >
  4. <Button Name="ButtonModify" Content="Modify Pixels" Click="ButtonModify_Click" />
  5. <Button Name="ButtonReset" Content="Reset Image" Click="ButtonReset_Click" />
  6. </StackPanel>
  7. </StackPanel>
C#
  1. private void ButtonModify_Click(object sender, RoutedEventArgs e)
  2. {
  3. int pixelTarget = 4;
  4. if (ImageToModify.Source != null)
  5. {
  6. // Get WriteableBitmap. ImageToModify is defined in MainPage.xaml
  7. WriteableBitmap bitmap =
  8. new WriteableBitmap(ImageToModify.Source as BitmapSource);
  9. // Iterate through each pixel.
  10. for (int x = 0; x < bitmap.Pixels.Length; x++)
  11. {
  12. // Set every 4th pixel.
  13. if (x % pixelTarget == 0)
  14. {
  15. bitmap.Pixels[x] = 0;
  16. }
  17. }
  18. // Set Image object, defined in XAML, to the modified bitmap.
  19. ImageToModify.Source = bitmap;
  20. }
  21. }
  22. private void ButtonReset_Click(object sender, RoutedEventArgs e)
  23. {
  24. BitmapImage licoriceImage =
  25. new BitmapImage(new Uri("licorice.jpg", UriKind.Relative));
  26. ImageToModify.Source = licoriceImage;
  27. }
Visual Basic
  1. Private Sub ButtonModify_Click(sender As Object, e As RoutedEventArgs)
  2. Dim pixelTarget As Integer = 4
  3. If ImageToModify.Source IsNot Nothing Then
  4. ' Get WriteableBitmap. ImageToModify is defined in MainPage.xaml
  5. Dim bitmap As New WriteableBitmap(TryCast(ImageToModify.Source, BitmapSource))
  6. ' Iterate through each pixel.
  7. For x As Integer = 0 To bitmap.Pixels.Length - 1
  8. ' Set every 4th pixel.
  9. If x Mod pixelTarget = 0 Then
  10. bitmap.Pixels(x) = 0
  11. End If
  12. Next
  13. ' Set Image object, defined in XAML, to the modified bitmap.
  14. ImageToModify.Source = bitmap
  15. End If
  16. End Sub
  17. Private Sub ButtonReset_Click(sender As Object, e As RoutedEventArgs)
  18. Dim licoriceImage As New BitmapImage(New Uri("licorice.jpg", UriKind.Relative))
  19. ImageToModify.Source = licoriceImage
  20. End Sub

Voir aussi


Cliquez ici pour revenir au sommaire de la liste d’articles

Skip to main content