Comment “cuisiner” une application Windows 8 avec XAML et C# en une semaine–Jour 0

Il y de cela quelques semaines, David Catuhe, a commencé à écrire une série d'articles, sur la manière de "Cuisiner" une application Windows 8 avec HTML 5, CSS 3 et JavaScript.

Le but étant étant de fournir une recette pragmatique pour écrire une application Windows 8 à partir de zéro.

A ça demande, je reprends son idée de l'application UrzaGatherer https://urzagatherer.codeplex.com/ (Application pour aider les collectionneurs de cartes Magic The Gathering à gérer leur collection) et vous propose une série d'articles mais cette fois-ci en .NET avec C# et en XAML. (Bien évidement vous pouvez choisir également Visual Basic .NET, ou alors de le faire en natif avec C++ et XAML).

Note : La version C# sera ISO fonctionnelle par rapport à la version HTML ni plus ni moins.

image

Pour développer l’application, vous allez donc avoir besoin de :

• Un ordinateur avec Windows 8 Consumer Preview installé dessus (Vous pouvez le télécharger ici: https://preview.windows.com)

• Visual Studio 11 (La version Express Beta pour Windows 8 peut être téléchargée ici: https://msdn.microsoft.com/en-us/windows/apps/br229516)

• Et c’est tout!

Note : Cet série d'articles est consacré à la manière de créer une application Windows 8 au Style Metro de bout en bout, afin que vous développeurs, vous en maitrisiez les concepts et que votre application adhère aux principes d'une application au style Metro. Pour les puristes, pas de MVVM, d'injection de contrôle et autres modèles de développement, ce n'est pas le but recherché. Mais bon vous pouvez toujours améliorer la recette en lui ajoutant une pincée de MVVM, MVMM light étant désormais disponible pour WinRT https://mvvmlight.codeplex.com/.

La solution peut-être téléchargée ici : Day0

Créer le projet

La première chose à faire est de créer un projet vide (nous aurions bien sur pu utiliser un modèle plus complet de Visual Studio comme le ‘Grid Application"’ mais l’objectif ici est de comprendre comme tout fonctionne) en utilisant le menu Fichier/Nouveau projet

clip_image002[6]

Le projet est ainsi crée avec uniquement les fichiers nécessaires

clip_image004

Créer les ressources graphiques

Le fichier package.appxmanifest permet de décrire votre application auprès de Windows 8. Il contient particulièrement la description de l’application ainsi que tous les logos et ressources graphiques nécessaires :

Nous allons ajouter ces ressources afin de donner tout de suite un air de “vraie application”.

Le “splash screen” par exemple est très important car c’est la première chose que vos utilisateurs vont voir et comme chacun sait la première impression est toujours la plus importante : clip_image006

clip_image008

Cette partie est souvent la plus dure au final car les développeurs ne sont que très rarement de bons designers

Structurer le projet

La structuration va dépendre de votre manière de travailler, mais elle aide le plus souvent à s'y retrouver plus rapidement. Dans notre exemple nous avons choisi une structuration tout à fait commune.

En créant deux répertoires supplémentaire par rapport à la solution de base,

DataModel, pour le modèle de données, et Views qui contiendra les vues de l’application

image

 

Connexion aux données

La connexion aux données sera faite dans le fichier /DataModel/UrzaGathererDataSource.cs

Pour UrzaGatherer, les données sont composées de :

• Un fichier all.json qui décrit toutes les cartes supportées

• Les images de chaque carte (plus de 4Go!!)

• Un logo pour chaque extension (sachant qu’une carte appartient à une extension qui appartient à un bloc)

• Un logo pour chaque bloc

 

Dans un premier temps, nous allons ajouter dans le répertoire DataModel, une nouvelle classe UrzaGathererDataSource.csimage

Code Snippet

  1. namespace UrzaGatherer.DataModel
  2. {
  3.     class UrzaGathererDataSource
  4.     {
  5.     }
  6. }

Avant d’implémenter quoi que ce soit dans cette classe, nous allons créer dans l’espace de nom UrzaGatherer.DataModel, trois autres classes JSONBlock, JSONExpansion et JSONCard, dérivant de la classe UrzaGatherer.Common.BindableBase. Cette dernière étant une classe helper , créée automatiquement par Visual Studio 11 et qui implémente INotifyPropertyChanged pour le Binding de données.

Code Snippet

  1. public class JSONBlock : UrzaGatherer.Common.BindableBase
  2. {
  3.     private String _name;
  4.     public String name
  5.     {
  6.         get { return _name; }
  7.         set { this.SetProperty(ref this._name, value); }
  8.     }
  9.     private String _logo;
  10.     public String logo {
  11.         get{return _logo;}
  12.         set {this.SetProperty(ref this._logo, value);
  13.         }
  14.     }
  15.     private int _id;
  16.     public int id {
  17.         get { return _id; }
  18.         set{this.SetProperty(ref this._id, value);
  19.         }
  20.     }
  21.     private int _index;
  22.     public int index {
  23.         get { return _index; }
  24.         set{ this.SetProperty(ref this._index, value);}
  25.     }
  26.     
  27.    public ObservableCollection<JSONExpansion> expansions { get; set; }       
  28. }
  29. public class JSONExpansion : UrzaGatherer.Common.BindableBase
  30. {
  31.     private JSONBlock _block;
  32.     public JSONBlock block {
  33.         get { return _block;}
  34.         set { this.SetProperty(ref this._block, value); }
  35.     }
  36.     private String _name;
  37.     public String name
  38.     {
  39.         get { return _name; }
  40.         set { this.SetProperty(ref this._name, value); }
  41.     }
  42.     private String _logo;
  43.     public String logo
  44.     {
  45.         get { return _logo; }
  46.         set
  47.         {
  48.             this.SetProperty(ref this._logo, value);
  49.         }
  50.     }
  51.     private int _id;
  52.     public int id
  53.     {
  54.         get { return _id; }
  55.         set
  56.         {
  57.             this.SetProperty(ref this._id, value);
  58.         }
  59.     }
  60.     private int _orderInBlock;
  61.     public int orderInBlock
  62.     {
  63.         get { return _orderInBlock; }
  64.         set
  65.         {
  66.             this.SetProperty(ref this._orderInBlock, value);
  67.         }
  68.     }
  69.     
  70.     public ObservableCollection<JSONCard> cards { get; set; }
  71.     
  72. }
  73. public class JSONCard
  74. {
  75.     public String power { get; set; }
  76.     public String flavor { get; set; }
  77.     public String picturePath { get; set; }
  78.     public String name { get; set; }
  79.     public String author { get; set; }
  80.     public String color { get; set; }
  81.     public String rarity { get; set; }
  82.     public String text { get; set; }
  83.     public String type { get; set; }
  84.     public int id { get; set; }        
  85.     public int number { get; set; }
  86.     public int? force { get; set; }
  87.     public int? defense { get; set; }
  88.     public double? price { get; set; }
  89.  
  90.     
  91. }

Implémentons maintenant notre classe UrzaGathererDataSource

Code Snippet

  1. public class CardsLoadEnventArgs : EventArgs
  2.     {
  3.         public ObservableCollection<JSONBlock> Blocks;
  4.         public CardsLoadEnventArgs(ObservableCollection<JSONBlock> blocks)
  5.         {
  6.             Blocks = blocks;
  7.         }
  8.     }
  9.     class UrzaGathererDataSource
  10.     {
  11.    
  12.         const String CARDS_ROOT = "https://urzagatherer.blob.core.windows.net";        
  13.         const String REMOTE_FILE_PATH = "/cards/all.json";
  14.         const String LOCAL_FILE = "all.json";
  15.         const int MAX_BUFFER_SIZE = 10 * 1024 * 1024;
  16.  
  17.         
  18.         public delegate void CardsLoadEventHandler (Object sender, CardsLoadEnventArgs e);
  19.         public event CardsLoadEventHandler CardsLoaded;
  20.         
  21.         private ObservableCollection<JSONBlock> _blocks;
  22.         public ObservableCollection<JSONBlock> blocks {
  23.             get { return _blocks;}
  24.             set {_blocks=value;}
  25.         }
  26.  
  27.         private StorageFile _cardsFile;
  28.         public StorageFile Cards {
  29.             get { return _cardsFile;}
  30.             set { _cardsFile=value;}
  31.         
  32.         }
  33.         /// <summary>
  34.         /// Does the all.json file is already in the cache ?
  35.         /// if yes get the file for futur use
  36.         /// </summary>
  37.         /// <returns></returns>
  38.         public async Task<bool>  IsCardsOnCache()
  39.         {
  40.             try
  41.             {
  42.  
  43.                 var localCache = ApplicationData.Current.LocalFolder;
  44.                 _cardsFile = await localCache.GetFileAsync(LOCAL_FILE);
  45.                 return true;
  46.             }
  47.             catch(System.IO.FileNotFoundException)
  48.             {
  49.                 return false;
  50.             }
  51.  
  52.             
  53.         }
  54.         /// <summary>
  55.         /// Download the all.json file, and save it on the local folder
  56.         /// to avoid futur download
  57.         /// </summary>
  58.         public async void  LoadRemoteCardsAsync()
  59.         {
  60.             var requestStr=CARDS_ROOT + REMOTE_FILE_PATH;
  61.             var client = new HttpClient();
  62.             client.MaxResponseContentBufferSize = MAX_BUFFER_SIZE;
  63.             var response=await client.GetAsync(new Uri(requestStr));
  64.             var result = await response.Content.ReadAsStringAsync();
  65.             
  66.             //if I'm here I need to save the data on the cache
  67.             var localCache = ApplicationData.Current.LocalFolder;
  68.             var fileCache=await localCache.CreateFileAsync(LOCAL_FILE, CreationCollisionOption.ReplaceExisting);
  69.             await Windows.Storage.FileIO.WriteTextAsync(fileCache, result);
  70.             CreateBlocks(result);
  71.         }
  72.         /// <summary>
  73.         /// Read the data from the cache
  74.         /// </summary>
  75.         public async void ReadJsonDataFromCacheAsync()
  76.         {
  77.             
  78.             var stream = await _cardsFile.OpenReadAsync();
  79.             var input = stream.GetInputStreamAt(0);
  80.             var reader = new DataReader(input);
  81.             uint count = await reader.LoadAsync((uint)stream.Size);
  82.             var result = reader.ReadString(count);
  83.             CreateBlocks(result);
  84.         }
  85.  
  86.         public void CreateBlocks(String cards)
  87.         {
  88.             this.blocks = new ObservableCollection<JSONBlock>();
  89.             var  blockItems= JsonArray.Parse(cards);
  90.             int count = blockItems.Count();
  91.             for (uint i = 0; i < count; i++)
  92.             {
  93.                 JSONBlock block = new JSONBlock();
  94.                 var objBlock = blockItems.GetObjectAt(i);
  95.                 block.id = (int)objBlock.GetNamedNumber("id");
  96.                 block.index = (int)objBlock.GetNamedNumber("index");
  97.                 block.name = objBlock.GetNamedString("name");
  98.                 block.logo = block.logo = CARDS_ROOT + "/blocks/" + block.name.Replace(":", "-") + ".png";
  99.                 JsonArray expansionsItems = objBlock.GetNamedArray("expansions");
  100.                 CreateExpansions(block, expansionsItems);
  101.                 blocks.Add(block);
  102.             }
  103.                         
  104.  
  105.             if (CardsLoaded != null)
  106.             {
  107.                 CardsLoaded(this, new CardsLoadEnventArgs(blocks));
  108.             }
  109.         }
  110.  
  111.         public void CreateExpansions(JSONBlock parentBlock,JsonArray expansionsItems)
  112.         {
  113.             var expansions = new ObservableCollection<JSONExpansion>();
  114.             int count=expansionsItems.Count();
  115.             for (uint i = 0; i < count; i++)
  116.             {
  117.                 var objExpension=expansionsItems.GetObjectAt(i);
  118.                 JSONExpansion expansionItem = new JSONExpansion();
  119.                 expansionItem.block = parentBlock;
  120.                 
  121.                 expansionItem.id=(int)objExpension.GetNamedNumber("id");
  122.                 expansionItem.name=objExpension.GetNamedString("name");
  123.                 expansionItem.logo = CARDS_ROOT + "/logos/" + expansionItem.name.Replace(":", "_") + ".png";
  124.                 expansionItem.orderInBlock = (int)objExpension.GetNamedNumber("orderInBlock");
  125.                 //Disable for Day 0                
  126.                 //JsonArray cardsItems = objExpension.GetNamedArray("cards");
  127.                 //expansionItem.cards = CreateCards(cardsItems);
  128.                 expansions.Add(expansionItem);
  129.             }
  130.             parentBlock.expansions = expansions;
  131.             
  132.         }
  133.         public ObservableCollection<JSONCard> CreateCards(JsonArray cardsItems)
  134.         {
  135.             var cards = new ObservableCollection<JSONCard>();
  136.             int count = cardsItems.Count();
  137.             for (uint i=0; i < count; i++)
  138.             {
  139.                 var objCard = cardsItems.GetObjectAt(i);
  140.                 JSONCard cardItem = new JSONCard();
  141.                 cardItem.author = objCard.GetNamedString("author");
  142.                 cardItem.id = (int)objCard.GetNamedNumber("id");
  143.                 cardItem.color = objCard.GetNamedString("color");
  144.                 cardItem.defense = (int)objCard.GetNamedNumber("defense");
  145.                 cardItem.flavor = objCard.GetNamedString("flavor");
  146.                 cardItem.force = (int)objCard.GetNamedNumber("force");
  147.                 cardItem.name = objCard.GetNamedString("name");
  148.                 cardItem.number = (int)objCard.GetNamedNumber("number");
  149.                 cardItem.picturePath = objCard.GetNamedString("picturePath");
  150.                 cardItem.power = objCard.GetNamedString("power");
  151.                 cardItem.price = objCard.GetNamedNumber("price");
  152.                 cardItem.rarity = objCard.GetNamedString("rarity");
  153.                 cardItem.text = objCard.GetNamedString("text");
  154.                 cardItem.type = objCard.GetNamedString("type");
  155.                 cards.Add(cardItem);
  156.             }            
  157.             return cards;
  158.         }
  159.     }

 

Le fichier all.json , contenant les données sera téléchargé au démarrage de l’application et sauvegardé dans un répertoire local, c’est la méthode asynchrone, LoadRemoteCardsAsync() qui sera en charge :

  1. De télécharger le fichier,
  2. De le sauvegarder dans le répertoire locale à l’application
  3. Et dans la foulée d’appeler la méthode CreateBlocks,  pour parser et mapper le fichier au format JSON correspondantes.

 

Une fois que les données sont mappées, l’évènement CardsLoaded sera levé afin de prévenir les vues qui s’y sont abonnées.

 

Vous noterez également la présence des méthodes IsCardsOnCacheAsync et ReadJsonDataFromCacheAsync qui utilisées en conjonction permettront d’éviter de re-télécharger le fichier all.json, ce qui peut prendre un certain temps.

 

Création d’une page de démarrage

Comme je le disais précédemment, le téléchargement du fichier all.json, peut prendre un certain temps, il est donc de bon ton, d’indiquer à l’utilisateur que les données sont en cours de chargement.

image

 

Pour ce faire, nous allons créer une vue à base d’un UserControl, que l’on nommera ExtendedSplachScreen, et qui aura pour rôle :

  1. D’afficher un message d’attente
  2. D’instancier le modèle de données et de s’y abonner
  3. De vérifier la présence dans le cache du fichier all.json
  4. et de donner la main à la 1ere vue qui affichera les données

Code Snippet

  1. <UserControl
  2.     x:Class="UrzaGatherer.Views.ExtendedSplachScreen"
  3.     xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
  4.     xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
  5.     xmlns:local="using:UrzaGatherer.Views"
  6.     xmlns:d="https://schemas.microsoft.com/expression/blend/2008"
  7.     xmlns:mc="https://schemas.openxmlformats.org/markup-compatibility/2006"
  8.     mc:Ignorable="d"
  9.     d:DesignHeight="1366"
  10.     d:DesignWidth="768">
  11.  
  12.     <Grid Background="White">
  13.         <Grid.RowDefinitions>
  14.             <RowDefinition/>
  15.             <RowDefinition Height="180"/>
  16.         </Grid.RowDefinitions>
  17.  
  18.         <Canvas Grid.Row="0">
  19.             <Image x:Name="extendedSplashImage" Source="../Assets/splashscreen.png"/>
  20.         </Canvas>
  21.                 
  22.         <StackPanel HorizontalAlignment="Center" Grid.Row="1">
  23.             <ProgressRing IsActive="True" FontSize="40" Foreground="Gray"/>
  24.             <TextBlock Foreground="Gray" FontFamily="Segoe UI Light" FontSize="40" TextWrapping="Wrap" TextAlignment="Center" Padding="5" HorizontalAlignment="Center" Text="Loading data... please wait" />
  25.         </StackPanel>
  26.     </Grid>
  27. </UserControl>

Code Snippet

  1. namespace UrzaGatherer.Views
  2. {
  3.     public sealed partial class ExtendedSplachScreen : UserControl
  4.     {
  5.         private Rect splashImageCoordinates; // Rect to store splash screen image coordinates.
  6.         private SplashScreen splash; // Variable to hold the splash screen object.
  7.         private bool dismissed = false; // Variable to track splash screen dismissal status.
  8.         private CoreDispatcher _dispatcher;
  9.         public ExtendedSplachScreen(SplashScreen splashScreen, bool dismissed)
  10.         {
  11.             this.InitializeComponent();
  12.             this.splashImageCoordinates = splashScreen.ImageLocation;
  13.             this.splash = splashScreen;
  14.             this.dismissed = dismissed;
  15.  
  16.             // Position the extended splash screen image in the same location as the splash screen image.
  17.             this.extendedSplashImage.SetValue(Canvas.LeftProperty, this.splashImageCoordinates.X);
  18.             this.extendedSplashImage.SetValue(Canvas.TopProperty, this.splashImageCoordinates.Y);
  19.             this.extendedSplashImage.Height = this.splashImageCoordinates.Height;
  20.             this.extendedSplashImage.Width = this.splashImageCoordinates.Width;
  21.             
  22.             _dispatcher = Window.Current.Dispatcher;
  23.            // LoadDataAsync();
  24.             
  25.         }
  26.  
  27.        internal void splashScreen_Dismissed(SplashScreen sender, object args)
  28.         {
  29.             this.dismissed = true;
  30.             //We have to synchronize with the main thread
  31.             _dispatcher.InvokeAsync(CoreDispatcherPriority.Normal,
  32.             new InvokedHandler((Object aSender, InvokedHandlerArgs e) =>
  33.                 {
  34.  
  35.                     LoadDataAsync();
  36.  
  37.                 }), this, null);
  38.             
  39.         }
  40.         async void  LoadDataAsync()
  41.         {
  42.             
  43.             UrzaGathererDataSource dataSource = new UrzaGathererDataSource();
  44.             dataSource.CardsLoaded += dataSource_CardsLoaded;
  45.             if (!await dataSource.IsCardsOnCache())
  46.             {
  47.                 dataSource.LoadRemoteCardsAsync();
  48.             }
  49.             else
  50.             {
  51.                 dataSource.ReadJsonDataFromCacheAsync();
  52.             }
  53.             
  54.         }
  55.  
  56.         void dataSource_CardsLoaded(object sender, CardsLoadEnventArgs e)
  57.         {
  58.  
  59.            
  60.                 var rootFrame = new Frame();
  61.  
  62.                 rootFrame.Navigate(typeof(Home), e.Blocks);
  63.  
  64.                 // Place the frame in the current Window and ensure that it is active
  65.                 Window.Current.Content = rootFrame;
  66.                 Window.Current.Activate();
  67.            
  68.           
  69.         }
  70.         
  71.     }
  72. }

Une fois que l’évènement CardsLoaded est levée, la méthode dataSource_CardLoaded() se déclenche. C’est elle qui à l’aide de l’élément Frame, va naviguer vers la page Home, en lui passant en paramètre, e.Blocks, contenant les données à afficher.

Vous noterez que nous utilisons la classe Frame, qui contiendra tout l’historique de navigation. Pas la peine alors de redévelopper son propre système, si vous souhaitez faire au plus vite.

 

Création de la page d’accueil

La 1ere page que l’on nommera Home, aura pour but d’afficher , sous forme d’une collection groupée, les blocs et leurs logos , ainsi que les expansions associées à chaque bloc.

Ici nous allons ajouter une nouvelle page, basée sur le modèle Grouped Items Page, car il nous fournit un bon point de démarrage pour afficher les données sous forme d’une collection de données groupées.

image

Une fois créée, nous modifions la liaison de données des éléments par défaut, par nos propres éléments de type expansion contenus dans un bloc.

Modifions l’attribut ItemsPath=”items” du CollectionViewSource, par notre ItemsPath=”expansions” , comme illustré sur l’extrait de XAML suivant.

Code Snippet

  1.     <UserControl.Resources>
  2.     <!-- Collection of grouped items displayed by this page -->
  3.     <CollectionViewSource
  4.         x:Name="groupedItemsViewSource"
  5.         Source="{Binding Groups}"
  6.         IsSourceGrouped="true"
  7.         ItemsPath="expansions"/>       
  8. </UserControl.Resources>

Note : expansions, étant définie comme une propriété de type ObservableCollection<JSONExpansion> de la classe JSONBlock

Code Snippet

  1. public ObservableCollection<JSONExpansion> expansions { get; set; }

La liaison proprement dite Source=”{Binding Groups}” est assurée, sur l’évènement OnNavigated de la page.

Code Snippet

  1. protected override void OnNavigatedTo(NavigationEventArgs e)
  2.         {
  3.             this.DefaultViewModel["Groups"] = e.Parameter;
  4.             (semanticZoom.ZoomedOutView as ListViewBase).ItemsSource = groupedItemsViewSource.View.CollectionGroups;                           
  5.         }

Note : La page dérive de la classe  LayoutAwarePage, qui entre autre offre un modèle de vue par défaut, nommé DefaultViewModel, et qui assure la liaison de données en liant les données avec le DataContext de la page. Le modèle s’appelle Groups, mais il peut bien évidement prendre le nom que vous souhaitez, pour peut que vous n’oubliez pas de le changer également dans le CollectionViewSource du fichier XAML.

 

L’affichage de nos données, se fait dans une GridView, qui est liée par défaut, avec le CollectionViewSource=”groupedItemsViewSource”.   Cette GridView, sera constituée d’un “Header” liée aux blocs, et d’un panel d’éléments qui sera liées aux expansions. D’ou la présence de deux Templates SemanticZoomOutItemTemplate et SemanticZoomOutHeaderTemplate qui vont influer sur la manière dont les données seront affichées.

Code Snippet

  1.       <GridView
  2.     IsItemClickEnabled="True"
  3.     ItemClick="ZoomedInGridView_ItemClick"
  4.     SelectionMode="None"
  5.     x:Name="ZoomedInGridView"              
  6.     Margin="0,0,0,46"
  7.     ItemsSource="{Binding Source={StaticResource groupedItemsViewSource}}"
  8.     ItemTemplate="{StaticResource SemanticZoomOutItemTemplate}"
  9.     >
  10.     <GridView.Transitions>
  11.         <TransitionCollection>
  12.             <AddDeleteThemeTransition></AddDeleteThemeTransition>
  13.         </TransitionCollection>
  14.     </GridView.Transitions>
  15.     <GridView.ItemsPanel>
  16.                                 <ItemsPanelTemplate>
  17.             <VirtualizingStackPanel Orientation="Horizontal" Margin="116,0,0,0"/>
  18.         </ItemsPanelTemplate>
  19.     </GridView.ItemsPanel>
  20.     
  21.     <GridView.GroupStyle>
  22.             <GroupStyle HeaderTemplate="{StaticResource SemanticZoomOutHeaderTemplate}">
  23.             
  24.             <GroupStyle.Panel>
  25.                 <ItemsPanelTemplate>
  26.                     <VariableSizedWrapGrid Orientation="Vertical" Margin="0,0,80,0"/>
  27.                 </ItemsPanelTemplate>
  28.             </GroupStyle.Panel>
  29.         </GroupStyle>
  30.     </GridView.GroupStyle>
  31. </GridView>

Par défaut l’attribut ItemTemplate, est liée avec le DataTemplate “Standard250x250ItemTemplate” contenu dans le fichier StandardStyles.xaml.

Nous allons modifier ce modèle afin que la liaison de données ainsi que l’affichage se fasse avec les éléments JSONBlock et JSONExpansion, pour ce faire, il suffit d’ajouter aux styles standard  le XAML suivant :

Code Snippet

  1. <Style x:Key="SemanticZoomOutControlContentStyle" TargetType="Button">
  2.     <Setter Property="Template">
  3.         <Setter.Value>
  4.                                                         <ControlTemplate TargetType="Button">
  5.                 <Border x:Name="Border" Background="Transparent" BorderThickness="2,2,2,2" BorderBrush="Black">
  6.                     <Grid HorizontalAlignment="Left" Width="250" Height="125">
  7.                         <Grid.RowDefinitions>
  8.                             <RowDefinition Height="95"/>
  9.                             <RowDefinition Height="30"/>
  10.                         </Grid.RowDefinitions>
  11.                         <Viewbox Stretch="Uniform" Width="Auto" Height="Auto" Grid.Row="0" VerticalAlignment="Center" HorizontalAlignment="Center">
  12.                             <Image Source="{Binding Path=logo}" Stretch="Fill"/>
  13.                         </Viewbox>
  14.  
  15.                         <Canvas Background="#FF2A2A2A" Grid.Row="1" VerticalAlignment="Stretch" >
  16.                             <TextBlock Text="{Binding name}" Foreground="{StaticResource ListViewItemOverlayTextBrush}"
  17.                                VerticalAlignment="Center" Style="{StaticResource TitleTextStyle}" Margin="10,0,0,0"/>
  18.                         </Canvas>
  19.                     </Grid>
  20.                 
  21.                 <VisualStateManager.VisualStateGroups>
  22.                         <VisualStateGroup x:Name="CommonStates">
  23.                             <VisualState x:Name="Normal"/>
  24.                             <VisualState x:Name="PointerOver">
  25.                                 <Storyboard>
  26.                                     <ObjectAnimationUsingKeyFrames Storyboard.TargetProperty="BorderBrush" Storyboard.TargetName="Border">
  27.                                         <DiscreteObjectKeyFrame KeyTime="0" Value="#FF7900FF"/>
  28.                                     </ObjectAnimationUsingKeyFrames>
  29.                                     <ObjectAnimationUsingKeyFrames Storyboard.TargetProperty="BorderThickness" Storyboard.TargetName="Border">
  30.                                         <DiscreteObjectKeyFrame KeyTime="0" Value="4,4,4,4"/>
  31.                                     </ObjectAnimationUsingKeyFrames>
  32.                                 </Storyboard>
  33.                             </VisualState>
  34.  
  35.  
  36.                         </VisualStateGroup>
  37.                     </VisualStateManager.VisualStateGroups>
  38.                 </Border>
  39.             </ControlTemplate>
  40.                 
  41.             </Setter.Value>
  42.     </Setter>
  43.  
  44. </Style>
  45. <DataTemplate x:Key="SemanticZoomOutItemTemplate">
  46.     <Button Style="{StaticResource SemanticZoomOutControlContentStyle}" />
  47.         
  48. </DataTemplate>
  49. <DataTemplate x:Key="SemanticZoomOutHeaderTemplate">
  50.     <Grid Margin="1,0,0,6">
  51.         <Grid.ColumnDefinitions>
  52.             <ColumnDefinition Width="150"/>
  53.             <ColumnDefinition Width="100"/>
  54.         </Grid.ColumnDefinitions>
  55.  
  56.         <TextBlock Height="50" HorizontalAlignment="Left" VerticalAlignment="Center" Margin="0,15,0,0" Text="{Binding name}" Style="{StaticResource HeaderHomePageTextStyle}" FontWeight="ExtraLight" Grid.Column="0" />
  57.         <Image Source="{Binding logo}" Width="60" Height="60" Grid.Column="1" HorizontalAlignment="Right" VerticalAlignment="Top" Margin="0,0,0,0"></Image>
  58.  
  59.     </Grid>
  60. </DataTemplate>
  61.  
  62. <DataTemplate x:Key="SemanticZoomInItemTemplate">
  63.                     <Grid HorizontalAlignment="Left" Width="300" Height="150" Background="#FF7900FF">
  64.             <TextBlock Text="{Binding Group.name}" HorizontalAlignment="Center" FontFamily="Segoe UI Light" FontSize="26.667" />
  65.                         <Image Source="{Binding Group.logo}" Width="50" Height="50" Stretch="UniformToFill" />
  66.     </Grid>
  67. </DataTemplate>

La liaison de données se faisant sur les champs logo (lié à un contrôle Image) et name ( lié à un contrôle TextBlock) , deux propriétés de nos blocs et de nos expansions. Vous noterez également la présence d’un VisualStateManager, qui permet de changer la bordure de l’élément (ici un bouton) à l’aide d’une animation, lorsque la souris passe au dessus de l’élément.

Pour les plus aguerrit, ils auront noté également la présence du style SemanticZoomInItemTemplate, que nous utiliseront lorsque nous mettrons en place le SemanticZoom.

Ajout du Zoom Sémantique

Comme nous venons de le voir, nos données sont structurées dans une GridView, organisée avec un entête constitué de nos blocs, et des expansions rattachées à chaque bloc. L’idée avec la vue sémantique, c’est de rajouter une autre GridView, qui affichera, comme on le voie sur l’image une vue filtrée par entête et qui permettra de naviguer rapidement sur le bloc sélectionné.

Cette fonctionnalité est appelée zoom sémantique (https://msdn.microsoft.com/en-us/library/windows/apps/hh465492.aspx) dans le jargon de développement d’une application Windows 8 Style Metro.

image

 

Pour ce faire nous allons utiliser tout simplement le contrôle XAML SemanticZoom, qui encapsulera dans la vue ZoomedInView, la 1ere GridView et dans la vue ZoomOutView la seconde GridView.

Cette seconde GridView, sera liée au modèle SemanticZoomInItemTemplate, que nous avons vu au préalablement.

Il est important de noter que la Liaison, utilise les chemins Group.name, et Group.logo, afin que l’affichage des données se fasse correctement.

Code Snippet

  1. <SemanticZoom IsZoomedInViewActive="True" Grid.Row="1" x:Name="semanticZoom">
  2.         <SemanticZoom.ZoomedInView>
  3.                              <GridView
  4.                 IsItemClickEnabled="True"
  5.                 ItemClick="ZoomedInGridView_ItemClick"
  6.                 SelectionMode="None"
  7.                 x:Name="ZoomedInGridView"              
  8.                 Margin="0,0,0,46"
  9.                 ItemsSource="{Binding Source={StaticResource groupedItemsViewSource}}"
  10.                 ItemTemplate="{StaticResource SemanticZoomOutItemTemplate}"
  11.                 >
  12.                 <GridView.Transitions>
  13.                     <TransitionCollection>
  14.                         <AddDeleteThemeTransition></AddDeleteThemeTransition>
  15.                     </TransitionCollection>
  16.                 </GridView.Transitions>
  17.                 <GridView.ItemsPanel>
  18.                                             <ItemsPanelTemplate>
  19.                         <VirtualizingStackPanel Orientation="Horizontal" Margin="116,0,0,0"/>
  20.                     </ItemsPanelTemplate>
  21.                 </GridView.ItemsPanel>
  22.                 
  23.                 <GridView.GroupStyle>
  24.                         <GroupStyle HeaderTemplate="{StaticResource SemanticZoomOutHeaderTemplate}">
  25.                         
  26.                         <GroupStyle.Panel>
  27.                             <ItemsPanelTemplate>
  28.                                 <VariableSizedWrapGrid Orientation="Vertical" Margin="0,0,80,0"/>
  29.                             </ItemsPanelTemplate>
  30.                         </GroupStyle.Panel>
  31.                     </GroupStyle>
  32.                 </GridView.GroupStyle>
  33.             </GridView>
  34.               </SemanticZoom.ZoomedInView>
  35.                 <SemanticZoom.ZoomedOutView>
  36.                 
  37.                 <GridView
  38.                         x:Name="ZoomedOutGridView" Margin="116,0,40,46"   
  39.                         ItemTemplate="{StaticResource SemanticZoomInItemTemplate}" />                                                                                                             
  40.                 </SemanticZoom.ZoomedOutView>
  41.             </SemanticZoom>

Enfin par code, nous allons indiqué sur l’évènement OnNavigatedTo() de la page Home, que la vue ZoomedOutView, doit se lier à source de données, contenant les entêtes de la Collection, c’est à dire nos blocs. C’est ce qui permettra cette navigation rapide d’un bloc à un autre.

Code Snippet

  1. (semanticZoom.ZoomedOutView as ListViewBase).ItemsSource = groupedItemsViewSource.View.CollectionGroups;

       

Note : Avec la souris, le zoom sémantique, s’active par CTRL + MOLETTE.

Enfin, il faut mettre en musique tout ce petit monde, sur l’évènement OnLaunched du fichier App.xaml.cs, ajoutez le code suivant :

Code Snippet

  1. protected override void OnLaunched(LaunchActivatedEventArgs args)
  2.         {
  3.             if (args.PreviousExecutionState == ApplicationExecutionState.Terminated)
  4.             {
  5.                 //TODO: Load state from previously suspended application
  6.             }
  7.            
  8.             SplashScreen splashScreen = args.SplashScreen;
  9.             ExtendedSplachScreen exSplash = new ExtendedSplachScreen(splashScreen, false);
  10.             
  11.             splashScreen.Dismissed += new TypedEventHandler<SplashScreen, object>(exSplash.splashScreen_Dismissed);
  12.             Window.Current.Content = exSplash;
  13.             Window.Current.Activate();
  14.         }

 

A Suivre :

Le prochain article introduira les fonctionnalités suivantes :
•La page des cartes
•La page des extensions
•Gestion du mode offline
•Gestion des settings