TimePicker.Time Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Ottiene o imposta l'ora attualmente impostata nella selezione ora.

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" />

Valore della proprietà

TimeSpan TimeSpan

Ora attualmente impostata nella selezione ora.

Esempio

In questo caso, la Time proprietà viene usata per confrontare l'ora nel selettore con l'ora corrente.

<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);
    }
}

Commenti

Il controllo selezione ora include api Time/TimeChanged e SelectedTime/SelectedTimeChanged . La differenza tra queste è che Time non è nullable, mentre SelectedTime è nullable.

Il valore di SelectedTime viene usato per popolare la selezione ora ed è null per impostazione predefinita. Se SelectedTime è null, la Time proprietà è impostata su un intervallo di tempo pari a 0; in caso contrario, il Time valore viene sincronizzato con il SelectedTime valore . Quando SelectedTime è null, il selettore è "unset" e mostra i nomi dei campi anziché un'ora.

L'ora non incrementerà in tempo reale (come un orologio) a meno che non si fornisca un'associazione di codice a un valore che tiene traccia dell'ora corrente durante l'esecuzione dell'app.

Puoi impostare il valore di ora come attributo in XAML. Questo è probabilmente più semplice se stai già dichiarando l'oggetto TimePicker in XAML e non usi associazioni per il valore di ora. Usare una stringa nel formato Hh:Mm dove Hh è ore e può essere compresa tra 0 e 23 e Mm è di minuti e può essere compreso tra 0 e 59. Un "0" può essere il carattere iniziale in Hh o Mm ed è in genere incluso per maggiore chiarezza di qualsiasi valore compreso tra 0 e 9. Ad esempio, "9:5" e "09:05" sono entrambi validi e rappresentano la stessa ora, ma "09:05" è più facile da leggere nel markup.

Per impostare l'ora nel codice, sono disponibili tecniche diverse a seconda del linguaggio di programmazione. Il valore è rappresentato come System.TimeSpan per C# e Visual Basic o Windows.Foundation.TimeSpan per le estensioni del componente Visual C++ (C++/CX). Probabilmente il modo più semplice per produrre un valore System.TimeSpan appropriato Time consiste nell'usare il metodo statico TimeSpan.Parse. Usare una stringa nel formato Hh:Mm (ore:minuti).

Indipendentemente dal fatto che sia impostato nel codice o in XAML, la classe TimePicker ha la logica di coercizione per il valore che mantiene quando si tenta di impostarla. I valori dei giorni vengono ignorati. I valori dei secondi vengono ignorati (ad esempio, i secondi su 30 non vengono arrotondati per eccesso al minuto successivo). I secondi frazionari vengono ignorati. I valori non si eseguono il wrapping (ad esempio, il valore "24:00" non è valido). Il valore minimo all'interno TimeSpan di è un'ora di 0 (00:00, mezzanotte) e il valore massimo è 23:59. I valori al di fuori dell'intervallo generano eccezioni, ma a seconda delle eccezioni specifiche potrebbero provenire nella TimeSpan costruzione anziché dalla convalida e dalla coercizione di Time.

Per impostare il Time valore nelle estensioni del componente Visual C++ (C++/CX), impostare il Duration campo della struttura TimeSpan . Duration specifica un tempo in 100 unità di nanosecondo; scrivere una logica personalizzata per la conversione da e verso le rappresentazioni hours:minutes.

Qualsiasi valore impostato per Time nel codice o XAML specifica il valore iniziale visualizzato nel controllo . Nell'app in fase di esecuzione tale valore viene in genere impostato dall'utente nel riquadro a comparsa della selezione ora. L'ora selezionata dall'utente viene impostata e l'evento TimeChanged si verifica quando l'utente apporta una modifica e preme il pulsante segno di spunta nel riquadro a comparsa selezione ora per confermare la selezione.

Vedi anche

• TimeChanged
• SelectedTime
• SelectedTimeChanged