Media.setItemInfo メソッド

  • [アーティクル]

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

setItemInfo メソッドは、現在のメディアアイテムに指定された属性の値を設定します。

構文

Media.setItemInfo(
  attribute,
  value
)

パラメーター

属性 [in]

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

value [in]

新しい値を含む文字列。

戻り値

このメソッドは値を返しません。

解説

attributeCount プロパティには、特定の Media オブジェクトで使用できる属性の数が含まれます。 その後、 getAttributeName メソッドと共にインデックス番号を使用して、このメソッドで使用できる組み込み属性の名前を決定できます。

このメソッドを使用する前 に、isReadOnlyItem メソッドを使用して、特定の属性を設定できるかどうかを判断します。

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

注:

Windows メディア プレーヤー コントロールをアプリケーションに埋め込む場合、ユーザーがWindows メディア プレーヤー実行されるまで、変更したファイル属性はデジタル メディア ファイルに書き込まれません。 C++ で記述されたリモート アプリケーションで コントロールを使用する場合、変更したファイル属性は、変更を行った直後にデジタル メディア ファイルに書き込まれます。 どちらの場合も、変更はライブラリを介してコードですぐに使用できます。

Windows メディア プレーヤー 10 Mobile: このメソッドは実装されていません。

例

次の JScript の例では 、Media を使用します。setItemInfo を使用して、現在のメディアアイテムの Genre 属性の値を変更します。 genText という名前の HTML TEXT 入力要素を使用すると、ユーザーはテキスト文字列を入力でき、属性情報の変更に使用されます。 Player オブジェクトは ID = "Player" で作成されました。

<!-- Create the button element. -->
<INPUT type = "BUTTON"  id = "NEWGEN"  name = "NEWGEN"  value = "Change Genre" 
onClick = "
    /* Store the current media item. */
    var cm = Player.currentMedia;

    /* Get the user input from the text box. */
    var atValue = genText.value;

    /* Test for read-only status of the attribute. */
    if(cm.isReadOnlyItem('Genre') == false){

        /* Change the attribute value. */
        cm.setItemInfo('Genre' ,atValue);
    } 
">

必要条件

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

関連項目

Media オブジェクト

Media.getItemInfo

Media.isReadOnlyItem

Settings.mediaAccessRights

Settings.requestMediaAccessRights