MediaElement.Position Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur posisi kemajuan saat ini melalui waktu pemutaran media.
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
Nilai Properti
Jumlah waktu sejak awal media. Defaultnya adalah TimeSpan dengan nilai "0:0:0".
Keterangan
Atur properti ini untuk mengatur posisi mulai-putar tertentu di dalam media.
TimeSpan direpresentasikan sebagai jenis yang berbeda tergantung pada bahasa pemrograman yang Anda gunakan.
C# atau Microsoft Visual Basic Gunakan struktur System.TimeSpan . System.TimeSpan memiliki anggota utilitas seperti Parse(String) yang memudahkan untuk membuat, mengubah, atau membandingkan nilai waktu.
Ekstensi komponen Visual C++ (C++/CX) Gunakan struktur Windows::Foundation::TimeSpan . Struktur ini hanya memiliki satu anggota bidang (Durasi), yang mengukur 100 unit nanodetik. Jika Anda ingin menampilkan nilai Posisi dalam format jam:menit:detik, Anda harus menulis logika Anda sendiri untuk mengonversi ke format tersebut dari unit Durasi .
Jika Anda tidak yakin dengan sumber media saat ini yang dimuat sebagai MediaElement.Source, selalu periksa CanSeek terlebih dahulu. Sumber media streaming menghasilkan MediaElement melaporkan CanSeek sebagai false, dan dalam hal ini Anda tidak dapat menggunakan Posisi untuk mengatur titik pemutaran.
Jika Posisi dapat diatur, maka batasan nilai ini berlaku:
- Jika Posisi diatur ke nilai negatif, nilai akan kembali ke TimeSpan dengan nilai "0:0:0".
- Jika Posisi diatur ke nilai yang lebih besar dari NaturalDuration media, maka Posisi menjadi nilai NaturalDuration.
Catatan tentang sintaks XAML
Mengatur nilai Posisi di XAML secara teknis dimungkinkan tetapi tidak umum. Jika Anda mengatur Posisi di XAML, simulasikan perilaku konversi jenis "FromString" untuk TimeSpan, dengan kata lain tentukan nilai dalam formulir "HH:MM:SS".