다음을 통해 공유


TimePicker

.NET 다중 플랫폼 앱 UI(.NET MAUI) TimePicker 는 플랫폼의 시간 선택 컨트롤을 호출하고 시간을 선택할 수 있도록 합니다.

TimePicker는 다음 속성을 정의합니다.

  • Time 형식 TimeSpan의 경우 선택한 시간이며 기본값은 0입니다 TimeSpan . 이 형식은 TimeSpan 자정 이후의 기간을 나타냅니다.
  • Format형식string, 표준 또는 사용자 지정 .NET 서식 문자열로, 기본값은 짧은 시간 패턴인 "t"입니다.
  • TextColor 형식 Color, 선택한 시간을 표시하는 데 사용되는 색입니다.
  • FontAttributes 형식 FontAttributes의 기본값은 .입니다 FontAtributes.None.
  • FontFamily 형식 string의 기본값은 .입니다 null.
  • FontSize 형식 double의 기본값은 -1.0입니다.
  • double 형식의 CharacterSpacingTimePicker 텍스트를 구성하는 문자 사이의 간격입니다.

이러한 모든 속성은 개체에 의해 BindableProperty 지원됩니다. 즉, 스타일을 지정할 수 있으며 속성은 데이터 바인딩의 대상이 될 수 있습니다. 속성에는 Time 기본 바인딩 모드 BindingMode.TwoWay가 있습니다. 즉, MVVM(Model-View-ViewModel) 패턴을 사용하는 애플리케이션에서 데이터 바인딩의 대상이 될 수 있습니다.

참고 항목

TimePicker 선택한 Time 새 값을 나타내는 이벤트는 포함되지 않습니다. 이에 대한 알림을 받아야 하는 경우 이벤트에 대한 PropertyChanged 이벤트 처리기를 추가할 수 있습니다.

또한 TimePicker 선택한 시간이 변경될 때 발생하는 이벤트를 정의 TimeSelected 합니다. TimeChangedEventArgs 이벤트 NewTime 와 함께 TimeSelected 제공되는 개체와 OldTime 새 시간과 이전 시간을 각각 지정하는 속성이 있습니다.

TimePicker 만들기

Time XAML에서 속성을 지정하면 값이 a TimeSpan 로 변환되고 밀리초 수가 0보다 크거나 같으며 시간 수가 24보다 작은지 확인합니다. 시간 구성 요소는 콜론으로 구분해야 합니다.

<TimePicker Time="4:15:26" />

속성이 BindingContext 명명 SelectedTime 된 형식 TimeSpan 의 속성을 포함하는 viewmodel의 인스턴스로 설정된 경우 다음과 같이 인스턴스화 TimePicker 할 수 있습니다.TimePicker

<TimePicker Time="{Binding SelectedTime}" />

이 예제에서는 속성이 Time viewmodel의 SelectedTime 속성으로 초기화됩니다. 속성의 Time 바인딩 모드 TwoWay가 있으므로 사용자가 선택한 모든 새 시간이 viewmodel에 자동으로 전파됩니다.

코드에서 속성을 형식 TimeSpan값으로 초기화 Time 할 수 있습니다.

TimePicker timePicker = new TimePicker
{
  Time = new TimeSpan(4, 15, 26) // Time set to "04:15:26"
};

글꼴 속성 설정에 대한 자세한 내용은 글꼴을 참조 하세요.

TimePicker 및 레이아웃

다음과 같이 CenterStart제약이 없는 가로 레이아웃 옵션을 사용할 수 있습니다 End TimePicker.

<TimePicker ···
            HorizontalOptions="Center" />

그러나 이는 권장되지 않습니다. 속성 설정 Format 에 따라 선택한 시간에 다른 표시 너비가 필요할 수 있습니다. 예를 들어 "T" 형식 문자열을 사용하면 TimePicker 보기에 긴 형식으로 시간이 표시되고 "오전 4시 15분 26분"은 "오전 4시 15분"의 짧은 시간 형식("t")보다 더 큰 표시 너비가 필요합니다. 플랫폼에 따라 이러한 차이로 인해 보기의 TimePicker 레이아웃 너비가 변경되거나 디스플레이가 잘리게 될 수 있습니다.

셀에 넣을 Grid TimePicker 때 너비 Auto 를 사용하지 않고 기본 HorizontalOptions 설정을 Fill TimePicker사용하는 것이 가장 좋습니다.

플랫폼 간 차이점

이 섹션에서는 컨트롤과 플랫폼별 차이점을 TimePicker 설명합니다.

Android에서는 속성이 Format 적용되며 컨트롤에 의해 표시됩니다. 그러나 컨트롤을 눌러 선택기 컨트롤이 표시되면 시간, 분 및 시간만 변경할 수 있습니다.