doc de Convertisseurs

Sources/MauiSpark/Convertisseurs/CouleurVersCouleurMAUI.cs

@@ -3,15 +3,50 @@ using System.Globalization;
 
 namespace MauiSpark.Convertisseurs
 {
+    /// <summary>
+    /// Convertisseur de couleur qui implémente l'interface IValueConverter.
+    /// Cette classe permet de convertir des valeurs de type Couleur en valeurs de type Color (et vice versa).
+    /// </summary>
     public class CouleurVersCouleurMAUI : IValueConverter
     {
+        /// <summary>
+        /// Obtient la couleur rouge.
+        /// </summary>
         public static Color Rouge { get; private set; } = Color.FromArgb("#F75353");
+
+        /// <summary>
+        /// Obtient la couleur verte.
+        /// </summary>
         public static Color Vert { get; private set; } = Color.FromArgb("#53F769");
+
+        /// <summary>
+        /// Obtient la couleur bleue.
+        /// </summary>
         public static Color Bleu { get; private set; } = Color.FromArgb("#535AF3");
+
+        /// <summary>
+        /// Obtient la couleur jaune.
+        /// </summary>
         public static Color Jaune { get; private set; } = Color.FromArgb("#E9FE67");
+
+        /// <summary>
+        /// Obtient la couleur noire.
+        /// </summary>
         public static Color Noir { get; private set; } = Color.FromArgb("#241E1E");
+
+        /// <summary>
+        /// Obtient la couleur blanche.
+        /// </summary>
         public static Color Blanc { get; private set; } = Color.FromArgb("#FFFFFF");
 
+        /// <summary>
+        /// Convertit une valeur de type Couleur en une valeur de type Color.
+        /// </summary>
+        /// <param name="value">La valeur à convertir.</param>
+        /// <param name="targetType">Le type cible de la conversion.</param>
+        /// <param name="parameter">Un paramètre facultatif utilisé pour la conversion.</param>
+        /// <param name="culture">La culture à utiliser pour la conversion.</param>
+        /// <returns>Une valeur de type Color correspondant à la valeur de type Couleur.</returns>
         public object Convert(object? value, Type targetType, object? parameter, CultureInfo culture)
         {
             if (value is not Couleur) 
@@ -36,6 +71,14 @@ namespace MauiSpark.Convertisseurs
             }
         }
 
+        /// <summary>
+        /// Convertit une valeur de type Color en une valeur de type Couleur.
+        /// </summary>
+        /// <param name="value">La valeur à convertir.</param>
+        /// <param name="targetType">Le type cible de la conversion.</param>
+        /// <param name="parameter">Un paramètre facultatif utilisé pour la conversion.</param>
+        /// <param name="culture">La culture à utiliser pour la conversion.</param>
+        /// <returns>Une valeur de type Couleur correspondant à la valeur de type Color.</returns>
         public object ConvertBack(object? value, Type targetType, object? parameter, CultureInfo culture)
         {
             if (value is not Color) return Couleur.Noir;

Sources/MauiSpark/Convertisseurs/IndicateurVersCouleurMAUI.cs

@@ -3,11 +3,30 @@ using System.Globalization;
 
 namespace MauiSpark.Convertisseurs
 {
+    /// <summary>
+    /// Convertisseur d'indicateur en couleur qui implémente l'interface IValueConverter.
+    /// Cette classe permet de convertir des valeurs de type Indicateur en valeurs de type Color.
+    /// </summary>
     public class IndicateurVersCouleurMAUI : IValueConverter
     {
-
+        /// <summary>
+        /// Obtient la couleur noire.
+        /// </summary>
         public static Color Noir { get; private set; } = Color.FromArgb("#000000");
+
+        /// <summary>
+        /// Obtient la couleur blanche.
+        /// </summary>
         public static Color Blanc { get; private set; } = Color.FromArgb("#FFFFFF");
+
+        /// <summary>
+        /// Convertit une valeur de type Indicateur en une valeur de type Color.
+        /// </summary>
+        /// <param name="value">La valeur à convertir.</param>
+        /// <param name="targetType">Le type cible de la conversion.</param>
+        /// <param name="parameter">Un paramètre facultatif utilisé pour la conversion.</param>
+        /// <param name="culture">La culture à utiliser pour la conversion.</param>
+        /// <returns>Une valeur de type Color correspondant à la valeur de type Indicateur.</returns>
         public object Convert(object? value, Type targetType, object? parameter, CultureInfo culture)
         {
             if (value is not Indicateur) return Noir;
@@ -23,6 +42,14 @@ namespace MauiSpark.Convertisseurs
             }
         }
 
+        /// <summary>
+        /// Convertit une valeur de type Color en une valeur de type Indicateur.
+        /// </summary>
+        /// <param name="value">La valeur à convertir.</param>
+        /// <param name="targetType">Le type cible de la conversion.</param>
+        /// <param name="parameter">Un paramètre facultatif utilisé pour la conversion.</param>
+        /// <param name="culture">La culture à utiliser pour la conversion.</param>
+        /// <returns>Non implémenté. Lance une NotImplementedException.</returns>
         public object ConvertBack(object? value, Type targetType, object? parameter, CultureInfo culture)
         {
             throw new NotImplementedException();

Sources/MauiSpark/Convertisseurs/TexteVersTexteMajuscule.cs

@@ -2,8 +2,21 @@
 
 namespace MauiSpark.Convertisseurs
 {
+    /// <summary>
+    /// Convertisseur de texte en texte en majuscules qui implémente l'interface IValueConverter.
+    /// Cette classe permet de convertir une chaîne de caractères en majuscules.
+    /// </summary>
     public class TexteVersTexteMajuscule : IValueConverter
     {
+
+        /// <summary>
+        /// Convertit une chaîne de caractères en majuscules.
+        /// </summary>
+        /// <param name="value">La valeur à convertir.</param>
+        /// <param name="targetType">Le type cible de la conversion.</param>
+        /// <param name="parameter">Un paramètre facultatif utilisé pour la conversion.</param>
+        /// <param name="culture">La culture à utiliser pour la conversion.</param>
+        /// <returns>Une chaîne de caractères en majuscules.</returns>
         public object Convert(object? value, Type targetType, object? parameter, CultureInfo culture)
         {
             if (value is not string) 
@@ -12,6 +25,14 @@ namespace MauiSpark.Convertisseurs
             return ((string)value).ToUpper();
         }
 
+        /// <summary>
+        /// Non implémenté. Lance une NotImplementedException.
+        /// </summary>
+        /// <param name="value">La valeur à convertir.</param>
+        /// <param name="targetType">Le type cible de la conversion.</param>
+        /// <param name="parameter">Un paramètre facultatif utilisé pour la conversion.</param>
+        /// <param name="culture">La culture à utiliser pour la conversion.</param>
+        /// <returns>Non implémenté. Lance une NotImplementedException.</returns>
         public object ConvertBack(object? value, Type targetType, object? parameter, CultureInfo culture)
         {
             throw new NotImplementedException();