TimePicker.Time Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Obtient ou définit l’heure actuellement définie dans le sélecteur de temps.

public:
 property TimeSpan Time { TimeSpan get(); void set(TimeSpan value); };

TimeSpan Time();

void Time(TimeSpan value);

public System.TimeSpan Time { get; set; }

var timeSpan = timePicker.time;
timePicker.time = timeSpan;

Public Property Time As TimeSpan

<TimePicker Time="timeSpanString" />

Valeur de propriété

TimeSpan TimeSpan

Heure actuellement définie dans le sélecteur de temps.

Exemples

Ici, la Time propriété est utilisée pour comparer l’heure dans le sélecteur à l’heure actuelle.

<StackPanel>
    <TimePicker x:Name="checkTimePicker"/>
    <Button Content="Check time" Click="{x:Bind CheckTime}"/>
    <TextBlock x:Name="resultText"/>
</StackPanel>

private void CheckTime()
{
    // Using the Time property.
    DateTime myTime = DateTime.Today + checkTimePicker.Time;
    if (DateTime.Now >= myTime)
    {
        resultText.Text = "Your selected time has already past.";
    }
    else
    {
        string hrs = (myTime - DateTime.Now).Hours.ToString();
        string mins = (myTime - DateTime.Now).Minutes.ToString();
        resultText.Text = string.Format("Your selected time is {0} hours, {1} minutes from now.", hrs, mins);
    }
}

Remarques

Le contrôle sélecteur d’heure possède à la fois Time/ les API TimeChanged et SelectedTime/SelectedTimeChanged. La différence entre les deux est que Time n’est pas nullable, tandis que SelectedTime est nullable.

La valeur de SelectedTime est utilisée pour remplir le sélecteur d’heure et est null par défaut. Si SelectedTime est null, la propriété Time est définie sur un TimeSpan de 0 ; sinon, la valeur de Time est synchronisée avec la valeur de SelectedTime. Quand SelectedTime est null, le sélecteur est « non défini » et montre les noms des champs au lieu d’une heure.

L’heure ne s’incrémente pas en temps réel (comme le ferait une horloge), sauf si vous fournissez une liaison de code à une valeur qui effectue le suivi de l’heure actuelle pendant l’exécution de l’application.

Vous pouvez définir la valeur de l’heure en tant qu’attribut en XAML. C’est probablement plus simple si vous déclarez déjà l’objet TimePicker en XAML et que vous n’utilisez pas de liaisons pour la valeur de temps. Utilisez une chaîne au format Hh:Mm où Hh est en heures et peut être compris entre 0 et 23 et Mm en minutes et peut être compris entre 0 et 59. Un « 0 » peut être le caractère initial en Hh ou Mm et est généralement inclus pour la clarté des valeurs 0 à 9. Par exemple, « 9:5 » et « 09:05 » sont tous deux valides et représentent la même heure, mais « 09:05 » est plus facile à lire dans le balisage.

Pour définir l’heure dans le code, vous disposez de différentes techniques en fonction de votre langage de programmation. La valeur est représentée sous la forme d’extensions de composant System.TimeSpan pour C# et Visual Basic ou Windows.Foundation.TimeSpan pour Visual C++ (C++/CX). Le moyen le plus simple de produire une valeur System.TimeSpan appropriée est Time probablement d’utiliser la méthode statique TimeSpan.Parse. Utilisez une chaîne au format Hh:Mm (heures:minutes).

Qu’elle soit définie en code ou en XAML, la classe TimePicker a une logique de contrainte pour la valeur qu’elle conserve lorsque vous tentez de la définir. Toutes les valeurs de jours sont ignorées. Les valeurs de secondes sont ignorées (par exemple, les secondes supérieures à 30 ne sont pas arrondies à la minute suivante). Les fractions de secondes sont ignorées. Les valeurs ne sont pas encapsulées (par exemple, la valeur « 24:00 » n’est pas valide.) La valeur minimale dans le TimeSpan est une heure de 0 (00:00, minuit) et la valeur maximale est 23:59. Les valeurs en dehors de la plage lèvent des exceptions, mais selon les spécificités, les exceptions peuvent provenir de la construction plutôt que de la TimeSpan validation et de la contrainte de Time.

Pour définir la valeur dans les Time extensions de composant Visual C++ (C++/CX), vous définissez le Duration champ de la structure TimeSpan . Duration spécifie un temps en unités de 100 nanosecondes ; écrivez votre propre logique pour la conversion vers et à partir de représentations heures:minutes.

Toute valeur que Time vous définissez dans le code ou XAML spécifie la valeur initiale indiquée dans le contrôle. Dans l’application au moment de l’exécution, cette valeur est généralement définie par l’utilisateur dans le menu volant du sélecteur de temps. L’heure sélectionnée par l’utilisateur est définie et l’événement TimeChanged se produit lorsque l’utilisateur apporte une modification et appuie sur le bouton marque case activée dans le menu volant du sélecteur de temps pour valider sa sélection.

Remarques pour les versions précédentes

Dans les versions antérieures à l’introduction de la propriété SelectedTime dans Windows 10, version 1809 (SDK 17763), la valeur par défaut pour Time est le moment où l’objet TimePicker est instancié lorsque l’application exécute ou charge cet objet spécifique.