Verwenden des Windows Medienwiedergabe-Steuerelements mit Visual Basic

  • Artikel

[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.]

In diesem Abschnitt wird beschrieben, wie Sie das ActiveX-Steuerelement Windows Medienwiedergabe 9 Serie oder höher in Anwendungen verwenden, die mit Microsoft Visual Basic 6.0 erstellt wurden.

Erste Schritte

Um das Windows Medienwiedergabe-Steuerelement zur Toolbox hinzuzufügen, wählen Sie zunächst komponenten im Menü Projekt aus. Aktivieren Sie im Dialogfeld Komponenten das Kontrollkästchen neben "Windows Medienwiedergabe". Vergewissern Sie sich am unteren Rand des Dialogfelds, dass die ausgewählte Datei wmp.dll ist. Nach dem Schließen des Dialogfelds können Sie eine instance des Windows Medienwiedergabe-Steuerelements in Ihrem Formular auf die übliche Weise platzieren.

Sie können viele Steuerelementeigenschaften mit dem Eigenschaftenfenster festlegen. Um einige Eigenschaften festzulegen, müssen Sie das Dialogfeld Windows Medienwiedergabe Eigenschaften verwenden, das Sie mit dem Element "(Benutzerdefiniert)" im Eigenschaftenfenster öffnen.

Objektverweise

Sie verwenden bestimmte Eigenschaften des Player-Steuerelements, um Verweise auf bestimmte Objekte abzurufen. Die cdromCollection-Eigenschaft gibt beispielsweise einen Verweis auf ein CdromCollection-Objekt zurück. Sie müssen einen solchen Verweis einer Variablen zuweisen, die Sie als entsprechende Schnittstelle deklariert haben. Im Fall der cdromCollection-Eigenschaft weisen Sie beispielsweise ihren Rückgabewert einer Variablen vom Typ IWMPCdromCollection zu.

Lesen Sie das Thema Schnittstellen in der Objektmodellreferenz für C++ , um zu ermitteln, welche Objekte mehrere Schnittstellen implementieren. In diesen Fällen müssen Sie eine Objektvariable als die in diesem SDK dokumentierte Schnittstelle mit der höchsten Nummer deklarieren, um Zugriff auf alle Eigenschaften und Methoden dieses Objekts zu haben. Beispielsweise sollten Sie den Wert der Windows Medienwiedergabe steuerelement currentMedia-Eigenschaft einer variablen zuweisen, die als IWMPMedia3 deklariert wurde, um sicherzustellen, dass Sie Zugriff auf die Methoden getAttributeCountByType und getItemInfoByType haben.

Hinweis

Das WindowsMediaPlayer-Objekt implementiert alle Eigenschaften und Methoden der Schnittstellen IWMPCore, IWMPCore2, IWMPCore3, IWMPPlayer, IWMPPlayer2, IWMPPlayer3 und IWMPPlayer4 . Sie müssen keine separaten Variablen für eine dieser Schnittstellen deklarieren. Sie können auf alle mitglieder zugreifen, indem Sie den Namen verwenden, den Sie Ihrem WindowsMediaPlayer-instance zugewiesen haben.

 

Im Visual Basic-Objektbrowser sehen Sie viele Schnittstellen, die für die private Verwendung durch das Windows Medienwiedergabe-Steuerelement vorgesehen sind, einschließlich einiger, die Skin-Entwickler unterstützen. Sie sollten nur die Objekte, Eigenschaften, Methoden und Ereignisse verwenden, die in diesem SDK dokumentiert sind.

Weitere Tipps

  • Die Referenzdokumentation zeigt die JScript-Syntax. In JScript werden Argumente, die an Methoden übergeben werden, immer in Klammern eingeschlossen. In Visual Basic 6.0 dürfen Argumente, die an Methoden übergeben werden, die keinen Wert zurückgeben, nicht in Klammern eingeschlossen werden.

  • Einige Eigenschaften oder Methoden werden im Code-Editor von Visual Basic möglicherweise nicht im Feature Zur Automatischen Liste der Codevervollständigung angezeigt. Sie können diese Member weiterhin verwenden, indem Sie ihre Namen genau so eingeben, wie sie in dieser Dokumentation angezeigt werden.

  • Verwalten Sie die visuelle Darstellung des Steuerelements mithilfe der uimode-Eigenschaft . Dies kann auf zwei Arten erfolgen. Sie können die Dropdownliste Modus auswählen im Dialogfeld eigenschaften der Windows Medienwiedergabe verwenden oder den richtigen Wert in die Eigenschaftenfenster eingeben.

    Verwenden Sie insbesondere nicht die visible-Eigenschaft , um das Steuerelement auszublenden. Weisen Sie stattdessen der Uimode-Eigenschaft den Wert "unsichtbar" zu.

Leitfaden zur Playersteuerung