MediaCollection.getAttributeStringCollection メソッド

  • [アーティクル]

[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能な場合は SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

getAttributeStringCollection メソッドは、指定したメディアの種類内の指定した属性のすべての値のセットを表す StringCollection オブジェクトを取得します。

構文

retVal = MediaCollection.getAttributeStringCollection(
  attribute,
  mediaType
)

パラメーター

属性 [in]

属性を指定する文字列。

mediaType [in]

メディアの種類を表す文字列。 "Audio"、"Video"、"Playlist"、または "Other" のいずれかの値が含まれます。

戻り値

このメソッドは StringCollection オブジェクトを返します。

解説

このメソッドを使用するには、ライブラリへの読み取りアクセスが必要です。 詳細については、「 ライブラリ アクセス」を参照してください。

Windows メディア プレーヤーでサポートされる属性の詳細については、「属性リファレンス」セクションを参照してください。

例

次の JScript の例では 、MediaCollection を使用します。メディア コレクション内のオーディオ項目の特定の属性に対応する値の一覧を表示する getAttributeStringCollection 。 ID = "Attribute" で作成された HTML SELECT 要素を使用すると、ユーザーはアーティスト、ジャンル、アルバムなどの属性を選択できます。 ID = "AttributeVals" で作成された HTML TEXTAREA 要素は、結果を表示します。 Player オブジェクトは ID = "Player" で作成されました。

// Clear the text in the display area.
AttributeVals.value = "";

// Store the mediaCollection object.
var library = Player.mediaCollection;

// Get the string collection for the attribute type the user selects.
var all = library.getAttributeStringCollection(Attribute.value, "Audio");

// Loop through the string collection.
for (i = 0; i < all.count; i++){

    // Display the items one line at a time.
    AttributeVals.value += all.item(i);
    AttributeVals.value += "\n";
}

要件

要件 値
Version
 バージョン 7.0 以降Windows メディア プレーヤー。
[DLL]
Wmp.dll

関連項目

MediaCollection オブジェクト

Settings.mediaAccessRights

Settings.requestMediaAccessRights

StringCollection オブジェクト