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 :
É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 :
Étape 3▲
Une page vierge nommée MainPage.xaml devrait alors apparaître :
É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 » :
É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 :
É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 :
É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 » :
Étape 8▲
Dans le volet XAML de Generic.xaml, dans la balise ResourceDictionary, tapez le code XAML namespace suivant :
xmlns:local="clr-namespace:FlipPanel"
É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 :
<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>
É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 :
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))>
É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 :
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
)
É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 :
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
É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 :
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
É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 :
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
Étape 15▲
Sélectionnez Debug, puis l'option Build FlipPanel du menu :
É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 :
É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 :
<Canvas
Height
=
"300"
Width
=
"400"
HorizontalAlignment
=
"Left"
VerticalAlignment
=
"Top"
Name
=
"Page"
>
</Canvas>
Voir ci-dessous :
Étape 18▲
Puis dans la section Contrôles FlipPanel de la Boîte à outils, sélectionnez le contrôle FlipPanel :
É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 :
<
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 :
É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 :
Une fois que vous l'aurez fait, ce qui suit apparaîtra dans une nouvelle fenêtre du navigateur :
Étape 21▲
Cliquez sur le bouton rond avec la flèche pour pivoter le FlipPanel :
Étape 22▲
Fermez l'application et la fenêtre du navigateur en cliquant sur le bouton Fermer 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.