库位置常量
注意
本部分介绍专为在线商店使用而设计的功能。 不支持在在线商店上下文之外使用此功能。
库位置常量是在 contentpartner.h 中定义的全局字符串变量。 它们由 IWMPContentPartner 和 IWMPContentPartnerCallback 接口的某些方法以及 外部 对象的某些方法使用。 这些常量用于指示以下类型。
- 库位置类型：这是由Windows 媒体播放器显示的库视图的类型。 例如，玩家可能会显示特定专辑的视图 (g_szCPAlbumID) 或所有流派 (g_szAllCPGenreIDs) 的视图。
- 所选项类型：这是库视图中选择的项的类型。 例如，用户可以在所有专辑的视图中选择特定专辑 (g_szCPAlbumID) 。
- 列表类型：这是从内容合作伙伴插件请求的列表的类型。 例如，Windows 媒体播放器可能会要求插件提供与特定播放列表关联的项目列表 (g_szCPListID) 。
- 列表项类型：从内容合作伙伴插件请求的各个列表项的类型。 例如，Windows 媒体播放器可能会要求插件在特定播放列表中提供曲目列表 (g_szCPTrackID) 。
下表提供每个常量的名称和值，以及库位置或类型的简短说明。 在使用 contentpartner.h 头文件编译的 C 或 C++ 代码中，可以使用常量的名称或值。 最好使用名称，因为编译器将检测拼写错误。 例如，在脚本 (调用 外部 对象) 的方法时，不能使用常量的名称;必须使用该值。
| 名称 | 值 | 位置或类型 |
|---|---|---|
| g_szUnknownLocation | UnknownLocation | 一组既不是专辑也不是播放列表的曲目。 Windows 媒体播放器在无法确定有效位置的罕见事件中也使用此常量。 |
| g_szRootLocation | RootLocation | 库树视图控件中的顶部节点 |
| g_szFlyoutMenu | FlyoutMenu | 当前在线商店的浮出控件菜单 |
| g_szOnlineStore | OnlineStore | 所有在线商店 |
| g_szCPListID | CPListID | 单个列表 |
| g_szAllCPListIDs | AllCPListIDs | 所有列表 |
| g_szCPTrackID | CPTrackID | 单个轨道 |
| g_szAllCPTrackIDs | AllCPTrackIDs | 所有曲目 |
| g_szCPArtistID | CPArtistID | 个人艺术家 |
| g_szAllCPArtistIDs | AllCPArtistIDs | 所有艺术家 |
| g_szCPAlbumID | CPAlbumID | 单个专辑 |
| g_szAllCPAlbumIDs | AllCPAlbumIDs | 所有专辑 |
| g_szCPGenreID | CPGenreID | 单个流派 |
| g_szAllCPGenreIDs | AllCPGenreIDs | 所有流派 |
| g_szCPAlbumSubGenreID | CPAlbumSubGenreID | 单个子根 |
| g_szAllCPAlbumSubGenreIDs | AllCPAlbumSubGenreIDs | 所有子genres |
| g_szReleaseDateYear | ReleaseDateYear | 目录内容已发布的单个年份 |
| g_szAllReleaseDateYears | AllReleaseDateYears | 目录内容发布的所有年份 |
| g_szCPRadioID | CPRadioID | 单个无线电流 |
| g_szAllCPRadioIDs | AllCPRadioIDs | 所有无线电流 |
| g_szAuthor | 作者 | 个人作者 |
| g_szAllAuthors | AllAuthors | 所有作者 |
| g_szWMParentalRating | WMParentalRating | 单个家长分级 |
| g_szAllWMParentalRatings | AllWMParentalRatings | 所有家长分级 |
| g_szUserEffectiveRatingStars | UserEffectiveRatingStars | 单个用户分级，以星数为单位 |
| g_szAllUserEffectiveRatingStarss | AllUserEffectiveRatingStarss | 所有用户分级 |
相关主题