MusicProperties.Rating プロパティ

定義

名前空間:

Windows.Storage.FileProperties

音楽ファイルに関連付けられている評価を取得または設定します。

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

プロパティ値

UInt32

unsigned int

uint32_t

メディア ファイルの評価 (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; に対して推奨されるロジックを次に示します。

こちらもご覧ください

• 評価コントロールのガイドライン