位置和所选项目

  • 项目

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能，Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

Windows 媒体播放器使用以下五项来描述其当前在线商店内容视图：

  • task
  • 库位置类型
  • 库位置 ID
  • 所选项目类型
  • 所选项目 ID

通常，可以将 Windows 媒体播放器 中的视图视为项的容器。 容器具有 类型，项具有 类型。 容器中的所有项具有相同的类型。 位置类型和项类型均由 库位置常量指定。 例如，如果当前视图显示单个相册，则库位置类型为 CPAlbumID，并且由于相册包含曲目，因此所选项目类型为 CPTrackID。

下表显示了多个容器的位置和项类型。

容器说明 库位置类型 所选项目类型
作为轨道容器的专辑 CPAlbumID CPTrackID
作为轨道容器的列表 CPListID CPTrackID
作为相册容器的列表 CPListID CPAlbumID
作为列表容器的无线电站 CPRadioID CPListID
所有相册的集合，它是相册的容器 AllCPAlbumIDs CPAlbumID
所有流派的集合，它是流派的容器 AllCPGenreIDs CPGenreID

 

Windows 媒体播放器中的选项卡表示不同的任务。 播放器在三个不同的任务窗格中显示在线商店内容： “库”、“ 刻录”和 “同步”。“库”任务窗格也称为“ 浏览 ”任务窗格。 有时，任务窗格称为 功能，因此你可能会在此文档中看到“ 刻录功能 ”和“ 同步功能” 等术语。

以下示例演示Windows 媒体播放器如何使用五条信息 (任务、库位置类型、库位置 ID、所选项类型、所选项 ID) 来描述不同的视图。

在 “刻录 ”任务窗格中，Player 将相册显示为曲目容器。 该专辑的 ID 为 250。 在视图中，所选项是 ID 为 800 的曲目。 请注意，800 是在线商店目录中曲目的 ID，而不是相册中曲目编号。

Item 值
task 刻录
库位置类型 CPAlbumID
库位置 ID 250
所选项目类型 CPTrackID
所选项目 ID 800

 

在 “同步 ”任务窗格中，Player 显示所有相册的集，这是相册的容器。 在视图中，所选项目是 ID 为 300 的相册。 请注意，库位置 ID 不适用于此视图。

Item 值
task 同步
库位置类型 AllCPAlbumIDs
库位置 ID 空值
所选项目类型 CPAlbumID
所选项目 ID 300

 

在树视图控件中，选择了在线商店的根节点。 在这种情况下，没有容器，因此没有项。 整个 “库 ”任务窗格显示一个发现页。

Item 值
task 浏览
库位置类型 RootLocation
库位置 ID 空值
所选项目类型 UnknownLocation
所选项目 ID 空值

 

在 “同步 ”任务窗格中，播放器将 2002 年显示为轨道容器。 在视图中，所选项是 ID 为 450 的轨道。

Item 值
task 同步
库位置类型 ReleaseDateYear
库位置 ID 2002
所选项目类型 CPTrackID
所选项目 ID 450

 

关于类型 1 在线商店

发现页面