MusicProperties.Rating プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
音楽ファイルに関連付けられている評価を取得または設定します。
public:
property unsigned int Rating { unsigned int get(); void set(unsigned int value); };uint32_t Rating();
void Rating(uint32_t value);public uint Rating { get; set; }var uInt32 = musicProperties.rating;
musicProperties.rating = uInt32;Public Property Rating As UIntegerプロパティ値
メディア ファイルの評価 (0 ~ 99 の値)。
注釈
このメディア ファイルの種類の評価プロパティは、 Windows ファイルのプロパティ (特に System.Rating) から取得されます。 System.Rating の値は 0 から 99 です。 値 0 は、ファイルが評価されていないことを示します。
多くの場合、評価情報は "star" メタファーとしてユーザーに表示されます。ここで、star評価は 0 ~ 5 個の星にすることができます。 これは、5 つのstar図形のアウトラインとして表示され、現在の評価は 5 star図形内の水平カラー バーで示されます。 詳細については、「 評価コントロールのガイドライン」を参照してください。
HTML UI の場合、Rating コントロールはstar評価動作を実装しますが、Rating プロパティの値を Rating コントロールがプロパティに使用するstarカウント値に変換します。
XAML UI の場合、Windows ランタイム XAML ボキャブラリに既定の評価コントロールはありません。 ただし、複数のサード パーティ製コントロール ベンダーが XAML 評価コントロールを作成しています。
Rating プロパティの 0 から 99 の可能な値を、5 star UI プレゼンテーションメタファーに適した 0 ~ 5 の整数値に変換し、Rating コントロールuint starRating = rating == 0 ? 0 : (uint)Math.Round((double)rating / 25.0) + 1; に対して推奨されるロジックを次に示します。