MediaElement.Position 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
미디어 재생 시간을 통해 진행률의 현재 위치를 가져오거나 설정합니다.
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 에서 CanSeek 을 false로 보고하며, 이 경우 위치를 사용하여 재생 지점을 설정할 수 없습니다.
Position을 설정할 수 있는 경우 다음 값 제약 조건이 적용됩니다.
- Position을 음수 값으로 설정하면 값이 "0:0:0" 값이 있는 TimeSpan으로 되돌리기.
- Position이 미디어의 NaturalDuration보다 큰 값으로 설정된 경우 Position은 NaturalDuration 값이 됩니다.
XAML 구문에 대한 참고 사항
XAML에서 Position 값을 설정하는 것은 기술적으로 가능하지만 일반적이지는 않습니다. XAML에서 Position을 설정하는 경우 TimeSpan에 대한 "FromString" 형식 변환 동작을 시뮬레이션합니다. 즉, "HH:MM:SS" 형식의 값을 지정합니다.