TimePicker.Time Propriété

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é

Heure actuellement définie dans le sélecteur d’heure.

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 du sélecteur d’heure a les Time/ 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 n’incrémente pas en temps réel (comme 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. Cela est probablement le plus simple si vous déclarez déjà l’objet TimePicker en XAML et n’utilisez pas de liaisons pour la valeur de temps. Utilisez une chaîne sous la forme Hh :Mm où Hh est heures et peut être comprise entre 0 et 23 et Mm et peut être comprise entre 0 et 59. Un « 0 » peut être le caractère initial dans Hh ou Mm et est généralement inclus pour la clarté des valeurs 0 à 9. Par exemple, « 9:5 » et « 09:05 » sont valides et représentent la même fois, mais « 09:05 » est plus facile à lire dans le balisage.

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

Si elle est définie dans du code ou du code 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 seconde sont ignorées. Les valeurs ne sont pas encapsulées (par exemple, une valeur de « 24:00 » n’est pas valide.) La valeur minimale dans le TimeSpan délai est de 0 (00:00, minuit) et la valeur maximale est 23:59. Les valeurs en dehors de la plage lèvent des exceptions, mais en fonction des spécificités des exceptions peuvent provenir de la TimeSpan construction plutôt que de la validation et du forçage de Time.

Pour définir la Time valeur en C++, vous définissez le Duration champ de la structure TimeSpan . Duration spécifie une durée en 100 nanosecondes ; écrivez votre propre logique pour la conversion en heures :minutes de représentations.

Toute valeur que vous définissez Time 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 coche dans le menu volant du sélecteur d’heure pour valider sa sélection.

Voir aussi

• TimeChanged
• SelectedTime
• SelectedTimeChanged