Gérer gracieusement l’entrée de données numériques dans les applications WPF

Lors du développement d’applications avec Windows Presentation Foundation (WPF), un défi courant que les développeurs rencontrent est la gestion de l’entrée de valeurs numériques. Ce problème est particulièrement évident lorsque l’on ne souhaite pas s’appuyer sur des contrôles externes ou tiers pour une fonctionnalité NumericUpDown.

Dans cet article, nous allons explorer une solution simple pour gérer l’entrée numérique en utilisant le contrôle standard TextBox, tout en garantissant une interface propre et conviviale.

Le problème : Gérer l’entrée numérique dans WPF

Sans la commodité d’un contrôle NumericUpDown, comment pouvons-nous nous assurer que les utilisateurs saisissent uniquement des valeurs numériques dans un TextBox ? Les développeurs ont souvent recours à la gestion manuelle des événements de touche, ce qui se traduit généralement par un code encombrant et moins lisible. Beaucoup se sont retrouvés à implémenter des gestionnaires d’événements pour intercepter les entrées clavier de manière à s’assurer que seuls les chiffres soient traités.

Voici un extrait de code couramment utilisé que les développeurs ont mis en œuvre pour valider l’entrée numérique :

private void NumericEditPreviewKeyDown(object sender, KeyEventArgs e)
{
    bool isNumPadNumeric = (e.Key >= Key.NumPad0 && e.Key <= Key.NumPad9) || e.Key == Key.Decimal;
    bool isNumeric = (e.Key >= Key.D0 && e.Key <= Key.D9) || e.Key == Key.OemPeriod;

    if ((isNumeric || isNumPadNumeric) && Keyboard.Modifiers != ModifierKeys.None)
    {
        e.Handled = true;
        return;
    }

    bool isControl = ((Keyboard.Modifiers != ModifierKeys.None && Keyboard.Modifiers != ModifierKeys.Shift)
        || e.Key == Key.Back || e.Key == Key.Delete || e.Key == Key.Insert
        || e.Key == Key.Down || e.Key == Key.Left || e.Key == Key.Right || e.Key == Key.Up
        || e.Key == Key.Tab
        || e.Key == Key.PageDown || e.Key == Key.PageUp
        || e.Key == Key.Enter || e.Key == Key.Return || e.Key == Key.Escape
        || e.Key == Key.Home || e.Key == Key.End);

    e.Handled = !isControl && !isNumeric && !isNumPadNumeric;
}

Bien que cette solution puisse sembler initialement satisfaisante, elle est tout sauf élégante. Le code peut rapidement devenir difficile à lire et à maintenir. Heureusement, il existe une alternative plus élégante.

La solution : Validation numérique simplifiée

Au lieu de plonger dans les complexités de la gestion de chaque pression de touche possible, nous pouvons simplifier le processus de validation en utilisant l’événement OnPreviewTextInput. Cette approche permet une mise en œuvre beaucoup plus propre. Voici comment vous pouvez y parvenir :

Étape 1 : Surcharger la méthode OnPreviewTextInput

Vous pouvez facilement valider si l’entrée consiste en des caractères numériques valides en surchargant la méthode OnPreviewTextInput de votre TextBox.

protected override void OnPreviewTextInput(System.Windows.Input.TextCompositionEventArgs e)
{
    e.Handled = !AreAllValidNumericChars(e.Text);
    base.OnPreviewTextInput(e);
}

Étape 2 : Créer une méthode d’assistance pour la validation des caractères

Voici une méthode d’assistance simple qui vérifie si tous les caractères de la chaîne saisie sont numériques :

private bool AreAllValidNumericChars(string str)
{
    foreach(char c in str)
    {
        if(!Char.IsNumber(c)) return false; // Retourne false si un caractère non numérique est trouvé
    }

    return true; // Retourne true si tous les caractères sont numériques
}

Conclusion

En utilisant la méthode OnPreviewTextInput avec une méthode de validation dédiée, nous pouvons gérer efficacement l’entrée numérique dans les applications WPF sans encombrer notre code avec une gestion extensive des événements de touches. Cette approche améliore non seulement la lisibilité du code, mais améliore également l’expérience utilisateur en garantissant que seules les entrées numériques valides sont acceptées.

Mettre en œuvre une solution propre et efficace permet aux développeurs de se concentrer davantage sur la fonctionnalité principale de leurs applications plutôt que de se perdre dans des mécanismes de validation d’entrée complexes.

N’est-il pas temps de rationaliser votre logique d’entrée de données numériques dans WPF ? Essayez cette approche et profitez d’une base de code plus claire et d’une meilleure expérience utilisateur !