Traduction

Ce tutoriel est la traduction la plus fidèle possible du tutoriel original de Peter Bull, Microsoft Silverlight 4 - FlipPanel Custom Control in Silverlight.

Introduction

FlipPanel Control est un panneau à double face qui affiche un contenu sur le « recto », et un autre contenu sur le « verso » quand il est retourné.

Contrôle FlipPanel personnalisé en Silverlight

Étape 1

Démarrez Microsoft Visual Web Developer 2010 Express, ensuite sélectionnez Fichier puis Nouveau Projet… Sélectionnez Visual Basic puis Application Silverlight dans les modèles installés, sélectionnez un emplacement si vous le souhaitez, puis entrez un nom pour le projet et appuyez sur OK :

Image non disponible

Étape 2

Une nouvelle fenêtre Nouvelle application Silverlight devrait apparaître, décochez la case Héberger l'application Silverlight sur un nouveau site Web, puis sélectionnez la Version de Silverlight ciblée :

Image non disponible

Étape 3

Une page vierge nommée MainPage.xaml devrait alors apparaître :

Image non disponible

Étape 4

Sélectionnez Fichier puis Ajouter depuis le menu principal, puis Nouveau Projet… La fenêtre Nouveau Projet devrait apparaître, sélectionnez Bibliothèque de classes Silverlight puis saisissez le Nom « FlipPanel » :

Image non disponible

Étape 5

Dans « Sélectionnez la version de Silverlight à cibler dans la liste des Kits de développement Silverlight SDK installés », choisissez la même version de Silverlight, par exemple Silverlight 4, et cliquez sur OK.

Puis dans l'Explorateur de solutions pour FlipPanel, cliquez sur Class1.vb, puis allez dans Propriétés et modifiez le Nom de fichier en FlipPanel.vb :

Image non disponible

Étape 6

Dans « Vous renommez un fichier. Voulez-vous également renommer dans ce projet toutes les références à l'élément de code 'Class1' ? », choisissez Oui.

Faites un clic droit sur le projet FlipPanel (et non sur FlipPanel.vb) dans l'Explorateur de solutions et choisissez Ajouter puis Nouveau dossier, et nommez-le Themes :

Image non disponible

Étape 7

Faites un clic droit sur le dossier Themes du projet FlipPanel, et choisissez Ajouter, puis Nouvel élément…, sélectionnez Dictionnaire de ressources Silverlight puis saisissez le Nom « Generic.xaml » :

Image non disponible

Étape 8

Dans le volet XAML de Generic.xaml, dans la balise ResourceDictionary, tapez le code XAML namespace suivant :

 
Sélectionnez
xmlns:local="clr-namespace:FlipPanel"
Image non disponible

Étape 9

Toujours dans le volet XAML de Generic.xaml, au-dessus de la balise </ResourceDictionary> et en dessous de la balise <ResourceDictionary>, tapez le code XAML suivant :

 
Sélectionnez
<Style TargetType="local:FlipPanel">
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="local:FlipPanel">
        <Grid>
          <VisualStateManager.VisualStateGroups>
            <VisualStateGroup x:Name="ViewStates">
              <VisualStateGroup.Transitions>
                <VisualTransition To="Normal" From="Flipped" GeneratedDuration="0:0:0.7">
                  <Storyboard>
                    <DoubleAnimation Storyboard.TargetName="BackContentProjection"
                       Storyboard.TargetProperty="RotationY" To="-90" Duration="0:0:0.5"/>
                    <DoubleAnimation Storyboard.TargetName="FrontContentProjection"
                       Storyboard.TargetProperty="RotationY" To="0" BeginTime="0:0:0.5" Duration="0:0:0.5"/>
                  </Storyboard>
                </VisualTransition>
                <VisualTransition To="Flipped" From="Normal" GeneratedDuration="0:0:0.7">
                  <Storyboard>
                    <DoubleAnimation Storyboard.TargetName="FrontContentProjection"
                        Storyboard.TargetProperty="RotationY" To="90" Duration="0:0:0.5"/>
                    <DoubleAnimation Storyboard.TargetName="BackContentProjection"
                        Storyboard.TargetProperty="RotationY" To="0" BeginTime="0:0:0.5" Duration="0:0:0.5"/>
                  </Storyboard>
                </VisualTransition>
              </VisualStateGroup.Transitions>
              <VisualState x:Name="Normal">
                <Storyboard>
                  <DoubleAnimation Storyboard.TargetName="BackContentProjection"
                      Storyboard.TargetProperty="RotationY" To="-90" Duration="0"/>
                </Storyboard>
              </VisualState>
              <VisualState x:Name="Flipped">
                <Storyboard>
                  <DoubleAnimation Storyboard.TargetName="FrontContentProjection" 
                      Storyboard.TargetProperty="RotationY" To="90" Duration="0"/>
                  <DoubleAnimation Storyboard.TargetName="FlipButtonTransform" 
                      Storyboard.TargetProperty="Angle" To="90" Duration="0"/>
                </Storyboard>
              </VisualState>
            </VisualStateGroup>
          </VisualStateManager.VisualStateGroups>
          <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="Auto"/>
          </Grid.RowDefinitions>
          <Border BorderBrush="{TemplateBinding BorderBrush}"
              BorderThickness="{TemplateBinding BorderThickness}"
              CornerRadius="{TemplateBinding CornerRadius}"
              Background="{TemplateBinding Background}">
            <ContentPresenter Content="{TemplateBinding FrontContent}"/>
            <Border.Projection>
              <PlaneProjection x:Name="FrontContentProjection"/>
            </Border.Projection>
          </Border>
          <Border BorderBrush="{TemplateBinding BorderBrush}"
              BorderThickness="{TemplateBinding BorderThickness}"
              CornerRadius="{TemplateBinding CornerRadius}"
              Background="{TemplateBinding Background}">
            <ContentPresenter Content="{TemplateBinding BackContent}"/>
            <Border.Projection>
              <PlaneProjection x:Name="BackContentProjection"/>
            </Border.Projection>
          </Border>
          <ToggleButton Grid.Row="1" RenderTransformOrigin="0.5,0.5" Margin="0,10,0,0" x:Name="FlipButton">
            <ToggleButton.Template>
              <ControlTemplate>
                <Grid>
                  <Ellipse Width="20" Height="20" Stroke="#FFA9A9A9" Fill="AliceBlue"/>
                  <Path RenderTransformOrigin="0.5,0.5" HorizontalAlignment="Center" VerticalAlignment="Center" 
                      Data="M1,1.5L4.5,5 8,1.5" Stroke="#FF666666" StrokeThickness="2" />
                </Grid>
              </ControlTemplate>
            </ToggleButton.Template>
            <ToggleButton.RenderTransform>
              <RotateTransform Angle="-90" x:Name="FlipButtonTransform"/>
            </ToggleButton.RenderTransform>
          </ToggleButton>
        </Grid>
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>
Image non disponible
Image non disponible

Étape 10

Double-cliquez sur la classe FlipPanel.vb dans l'Explorateur de solutions du projet FlipPanel.

Dans la vue de code pour FlipPanel, au-dessus de la ligne Public Class FlipPanel, tapez le code suivant :

 
Sélectionnez
Imports System.Windows.Controls.Primitives
<TemplateVisualState(Name:="Normal", GroupName:="ViewStates"),
TemplateVisualState(Name:="Flipped", GroupName:="ViewStates"),
TemplatePart(Name:="FlipButton", Type:=GetType(ToggleButton)),
TemplatePart(Name:="FlipButtonAlternative", Type:=GetType(ToggleButton))>
Image non disponible

Étape 11

Puisque nous en sommes à la vue de code pour FlipPanel.vb, en dessous de la ligne Public Class FlipPanel, tapez le code suivant :

 
Sélectionnez
Inherits Control

Public Shared ReadOnly FrontContentProperty As DependencyProperty =
DependencyProperty.Register("FrontContent", GetType(Object),
GetType(FlipPanel), Nothing)

Public Shared ReadOnly BackContentProperty As DependencyProperty =
DependencyProperty.Register("BackContent", GetType(Object),
GetType(FlipPanel), Nothing)

Public Shared ReadOnly IsFlippedProperty As DependencyProperty =
DependencyProperty.Register("IsFlipped", GetType(Boolean),
GetType(FlipPanel), Nothing)

Public Shared ReadOnly CornerRadiusProperty As DependencyProperty =
DependencyProperty.Register("CornerRadius", GetType(CornerRadius),
GetType(FlipPanel), Nothing)
Image non disponible

Étape 12

En étant toujours dans la vue de code pour FlipPanel.vb, au-dessus du End Class pour Public Class FlipPanel, tapez les propriétés suivantes :

 
Sélectionnez
Public Property FrontContent() As Object
  Get
    Return GetValue(FrontContentProperty)
  End Get
  Set(ByVal value As Object)
    SetValue(FrontContentProperty, value)
  End Set
End Property

Public Property BackContent() As Object
  Get
    Return GetValue(BackContentProperty)
  End Get
  Set(ByVal value As Object)
    SetValue(BackContentProperty, value)
  End Set
End Property

Public Property IsFlipped() As Boolean
  Get
    Return CBool(GetValue(IsFlippedProperty))
  End Get
  Set(ByVal value As Boolean)
    SetValue(IsFlippedProperty, value)
    ChangeVisualState(True)
  End Set
End Property

Public Property CornerRadius() As CornerRadius
  Get
    Return CType(GetValue(CornerRadiusProperty), CornerRadius)
  End Get
  Set(ByVal value As CornerRadius)
    SetValue(CornerRadiusProperty, value)
  End Set
End Property
Image non disponible

Étape 13

Puisque nous en sommes toujours à la vue de code pour FlipPanel.vb, au-dessus du End Class pour Public Class FlipPanel, tapez le constructeur et le Sub suivants :

 
Sélectionnez
Public Sub New()
  DefaultStyleKey = GetType(FlipPanel)
End Sub

Private Sub ChangeVisualState(ByVal useTransitions As Boolean)
  If Not IsFlipped Then
    VisualStateManager.GoToState(Me, "Normal", useTransitions)
  Else
    VisualStateManager.GoToState(Me, "Flipped", useTransitions)
  End If
End Sub
Image non disponible

Étape 14

Encore une fois, en étant toujours dans la vue de code pour FlipPanel.vb, au-dessus du End Class pour Public Class FlipPanel, tapez les gestionnaires d'événements suivants :

 
Sélectionnez
Private Sub FlipButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
  Me.IsFlipped = Not Me.IsFlipped
  ChangeVisualState(True)
End Sub

Public Overrides Sub OnApplyTemplate()
  MyBase.OnApplyTemplate()
  Dim _flipButton As ToggleButton =
    TryCast(MyBase.GetTemplateChild("FlipButton"), ToggleButton)
  If _flipButton IsNot Nothing Then
    AddHandler _flipButton.Click, AddressOf FlipButton_Click
  End If
  Dim _flipButtonAlternate As ToggleButton =
    TryCast(MyBase.GetTemplateChild("FlipButtonAlternate"), ToggleButton)
  If _flipButtonAlternate IsNot Nothing Then
    AddHandler _flipButtonAlternate.Click, AddressOf FlipButton_Click
  End If
  Me.ChangeVisualState(False)
End Sub
Image non disponible

Étape 15

Sélectionnez Debug, puis l'option Build FlipPanel du menu :

Image non disponible

Étape 16

Retournez au concepteur de vues MainPage.xaml en sélectionnant l'onglet MainPage.xaml, ou double-cliquez sur l'entrée pour MainPage.xaml dans l'Explorateur de solutions du projet principal.

Puis dans la section Tous les contrôles Silverlight de la Boîte à outils, sélectionnez le contrôle Canvas :

Image non disponible

Étape 17

Dessinez un Canvas qui remplit toute la page ou dans le volet XAML entre les lignes <Grid> et </Grid>, tapez le code XAML suivant :

 
Sélectionnez
<Canvas Height="300" Width="400" HorizontalAlignment="Left" VerticalAlignment="Top" Name="Page">
</Canvas>

Voir ci-dessous :

Image non disponible

Étape 18

Puis dans la section Contrôles FlipPanel de la Boîte à outils, sélectionnez le contrôle FlipPanel :

Image non disponible

Étape 19

Dessinez un FlipPanel sur la page (Canvas) en le glissant de la Boîte à outils sur le Canvas, ensuite dans le volet XAML entre les balises <Canvas> et </Canvas>, modifiez le code XAML my:FlipPanel comme ceci :

 
Sélectionnez
<my:FlipPanel Canvas.Left="75" Canvas.Top="25" Height="250" Width="250">
  <my:FlipPanel.FrontContent>
    <StackPanel>
      <TextBlock Margin="4" FontWeight="Bold" Text="Front Content"/>
      <Button Margin="4" Padding="4" Content="Button One"/>
      <Button Margin="4" Padding="4" Content="Button Two"/>
      <Button Margin="4" Padding="4" Content="Button Three"/>
      <Button Margin="4" Padding="4" Content="Button Four"/>
    </StackPanel>
  </my:FlipPanel.FrontContent>
  <my:FlipPanel.BackContent>
    <StackPanel>
      <TextBlock Margin="4" FontWeight="Bold" Text="Back Content"/>
      <CheckBox Margin="4" Padding="4" Content="CheckBox One"/>
      <CheckBox Margin="4" Padding="4" Content="CheckBox Two"/>
      <CheckBox Margin="4" Padding="4" Content="CheckBox Three"/>
      <CheckBox Margin="4" Padding="4" Content="CheckBoxn Four"/>
    </StackPanel>
  </my:FlipPanel.BackContent>
</my:FlipPanel>

Voir ci-dessous :

Image non disponible

Étape 20

Enregistrez le projet maintenant que vous avez terminé l'application Silverlight. Sélectionnez Debug, puis Démarrer le débogage ou cliquez sur Démarrer le débogage :

Image non disponible

Une fois que vous l'aurez fait, ce qui suit apparaîtra dans une nouvelle fenêtre du navigateur :

Image non disponible

Étape 21

Cliquez sur le bouton rond avec la flèche pour pivoter le FlipPanel :

Image non disponible

Étape 22

Fermez l'application et la fenêtre du navigateur en cliquant sur le bouton Fermer Image non disponible en haut à droite de la fenêtre de l'application et du navigateur Web pour Arrêter l'application.

Conclusion

Ceci est un exemple simple de comment créer un contrôle FlipPanel ! Il peut être étendu pour ajouter davantage de propriétés et de fonctionnalités telles que pivoter horizontalement et verticalement - personnalisez-le !

Liens

Remerciements

Je tiens ici à remercier Peter Bull de m'avoir autorisé à traduire son tutoriel.
Je remercie tomlev pour sa relecture technique et ses propositions.
Je remercie également f-leb pour sa relecture orthographique et ses propositions.