Media.name

Artikel
06/21/2023

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die name-Eigenschaft gibt den Namen des Medienelements an oder ruft diesen ab.

Syntax

player. currentMedia. Namen

Mögliche Werte

Diese Eigenschaft ist eine Zeichenfolge mit Lese-/Schreibzugriff, die den Namen des Medienelements enthält.

Bemerkungen

Um den Wert dieser Eigenschaft abzurufen, ist Lesezugriff auf die Bibliothek erforderlich. Um den Wert dieser Eigenschaft anzugeben, ist voller Zugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.

Bevor Sie diese Methode zum Angeben des Namens eines Medienelements verwenden, verwenden Sie isReadOnlyItem , um zu bestimmen, ob der Name festgelegt werden kann.

Windows Medienwiedergabe 10 Mobile: Diese Eigenschaft ist schreibgeschützt.

Beispiele

Im folgenden JScript-Beispiel wird Media verwendet. name , um den Namen des aktuellen Medienelements zu ändern. Ein HTML-TEXT-Eingabeelement namens NameText ermöglicht es dem Benutzer, eine Textzeichenfolge für den neuen Namen einzugeben. Das Player-Objekt wurde mit der ID = "Player" erstellt.

<!<entity type="mdash"/>-Create an HTML BUTTON element to execute the name change. -->
<INPUT type = "BUTTON"  id = "NewName"  name = "NewName"  value = "Change Name" 
    onClick = "

        /* Store the current media item. */
        var cm = Player.currentMedia;

        /* Change the name. */
        cm.name = NameText.value;
">

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Version 7.0 oder höher.
DLL	Wmp.dll

Siehe auch

Medienobjekt
Settings.mediaAccessRights
Settings.requestMediaAccessRights