ImageProperties.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 = imageProperties.rating;
imageProperties.rating = uInt32;

Public Property Rating As UInteger

屬性值

UInt32

unsigned int

uint32_t

媒體檔案評等，以介於 0 到 99 之間的值。

備註

此媒體檔案類型的 rating 屬性是從 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 可能值轉換成介於 0 到 5 之間的整數值，適用于 5 star UI 呈現隱喻，以及評分控制項： uint starRating = rating == 0 ? 0 : (uint)Math.Round((double)rating / 25.0) + 1; 。

另請參閱

• 評分控制項的指導方針