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
Значение свойства
Время с момента начала воспроизведения мультимедиа. По умолчанию используется TimeSpan со значением "0:0:0".
Комментарии
Задайте это свойство, чтобы задать определенную начальную позицию на носителе.
TimeSpan представляется как различные типы в зависимости от используемого языка программирования.
C# или Microsoft Visual Basic Используйте структуру System.TimeSpan . System.TimeSpan имеет служебные элементы, такие как Parse(String), которые упрощают создание, изменение или сравнение значений времени.
Расширения компонентов Visual C++ (C++/CX) Используйте структуру Windows::Foundation::TimeSpan . Эта структура имеет только один элемент поля (Duration), который измеряет 100 наносекундных единиц. Если вы планируете отображать значение Position в формате часы:минуты:секунды, необходимо написать собственную логику для преобразования в этот формат из единиц длительности .
Если вы не уверены, что текущий источник мультимедиа загружен как MediaElement.Source, всегда сначала проверка CanSeek. Источник мультимедиа потоковой передачи приводит к тому, что MediaElement сообщает о CanSeek как false, и в этом случае невозможно использовать позицию для задания точки воспроизведения.
Если параметр Position можно задать, применяются следующие ограничения значений:
- Если для параметра Position задано отрицательное значение, значение будет отменить изменения в TimeSpan со значением "0:0:0".
- Если для параметра Position задано значение, превышающее значение NaturalDuration носителя, то Position становится значением NaturalDuration.
Примечания по синтаксису XAML
Задание значения Position в XAML технически возможно, но не является распространенным явлением. Если в XAML задано значение Position, смоделируйте поведение преобразования типа FromString для TimeSpan, другими словами, укажите значение в формате "ЧЧ:ММ:СС".