MediaElement.Position 속성

정의

미디어 재생 시간을 통해 진행률의 현재 위치를 가져오거나 설정합니다.

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

void Position(TimeSpan value);
public System.TimeSpan Position { get; set; }
var timeSpan = mediaElement.position;
mediaElement.position = timeSpan;
Public Property Position As TimeSpan

속성 값

미디어가 시작된 이후의 시간입니다. 기본값은 값이 "0:0:0"인 TimeSpan 입니다.

설명

미디어 내에서 특정 시작 플레이 위치를 설정하려면 이 속성을 설정합니다.

TimeSpan은 사용 중인 프로그래밍 언어에 따라 다른 형식으로 표시됩니다.

C# 또는 Microsoft Visual BasicSystem.TimeSpan 구조를 사용합니다. System.TimeSpan 에는 시간 값을 쉽게 만들거나 변경하거나 비교할 수 있는 Parse(String) 와 같은 유틸리티 멤버가 있습니다.

Visual C++ 구성 요소 확장(C++/CX)Windows::Foundation::TimeSpan 구조를 사용합니다. 이 구조체에는 100나노초 단위로 측정되는 하나의 필드 멤버(기간)만 있습니다. Position 값을 시간:분:초 형식으로 표시하려면 Duration 단위에서 해당 형식으로 변환하기 위한 고유한 논리를 작성해야 합니다.

MediaElement.Source로 로드된 현재 미디어 원본을 잘 모르는 경우 항상 CanSeek을 먼저 검사. 스트리밍 미디어 원본은 MediaElement 에서 CanSeekfalse로 보고하며, 이 경우 위치를 사용하여 재생 지점을 설정할 수 없습니다.

Position을 설정할 수 있는 경우 다음 값 제약 조건이 적용됩니다.

  • Position을 음수 값으로 설정하면 값이 "0:0:0" 값이 있는 TimeSpan으로 되돌리기.
  • Position이 미디어의 NaturalDuration보다 큰 값으로 설정된 경우 Position은 NaturalDuration 값이 됩니다.

XAML 구문에 대한 참고 사항

XAML에서 Position 값을 설정하는 것은 기술적으로 가능하지만 일반적이지는 않습니다. XAML에서 Position을 설정하는 경우 TimeSpan에 대한 "FromString" 형식 변환 동작을 시뮬레이션합니다. 즉, "HH:MM:SS" 형식의 값을 지정합니다.

적용 대상

추가 정보