評価制御

評価コントロールを使用すると、ユーザーは評価の確認と設定を簡単に行うことができます。評価には、コンテンツやサービスに関する満足度が反映されます。 ユーザーは、タッチ、ペン、マウス、ゲームパッド、またはキーボードを使用して評価コントロールを操作できます。 次のガイダンスでは、評価コントロールの機能を使用して柔軟性とカスタマイズを提供する方法を示します。

評価コントロールの例

概要

評価コントロールを使用して評価を入力するか、読み取り専用にして評価を表示できます。

プレースホルダー値を含む編集可能な評価

おそらく、評価コントロールを使用する最も一般的な方法は、ユーザーが独自の評価値を入力できるようにしながら、平均評価を表示する方法です。 このシナリオでは、評価コントロールは、最初に、特定のサービスまたはコンテンツの種類 (音楽、ビデオ、書籍など) のすべてのユーザーの平均満足度評価を反映するように設定されます。 ユーザーが項目を個別に評価するという目標を持つコントロールと対話するまで、この状態が維持されます。 この操作により、評価コントロールの状態が変更され、ユーザーの個人の満足度評価が反映されます。

初期平均評価状態

初期平均評価状態

設定後のユーザー評価の表現

設定後のユーザー評価の表現

読み取り専用評価モード

推奨コンテンツに表示されるコンテンツや、コメントの一覧とそれに対応する評価を表示する場合など、セカンダリ コンテンツの評価を表示する必要がある場合があります。 この場合、ユーザーは評価を編集できてはならないため、コントロールを読み取り専用にします。 読み取り専用モードは、UI の設計とパフォーマンスの両方の理由から、非常に大規模な仮想化されたコンテンツ リストで使用される場合に評価コントロールを使用する際にも推奨される方法です。

リードオンリーの長いリスト

評価コントロールを作成する

WinUI 3 ギャラリー アイコン

WinUI 3 ギャラリー アプリには、WinUI コントロールと機能の対話型の例が含まれています。 Microsoft Store からアプリを取得するか、GitHub でソース コードを参照します。

編集可能な評価コントロール

このコードでは、プレースホルダー値を使用して編集可能な評価コントロールを作成する方法を示します。

<RatingControl x:Name="MyRating" ValueChanged="RatingChanged"/>

private void RatingChanged(RatingControl sender, object args)
{
    if (sender.Value == null)
    {
        MyRating.Caption = "(" + SomeWebService.HowManyPreviousRatings() + ")";
    }
    else
    {
        MyRating.Caption = "Your rating";
    }
}

評価コントロール (読み取り専用)

このコードでは、読み取り専用の評価コントロールを作成する方法を示します。

<RatingControl IsReadOnly="True"/>

その他の機能

評価コントロールには、使用できる多くの追加機能があります。 これらの機能の使用方法について詳しくは、リファレンス ドキュメントをご覧ください。 追加機能の包括的でない一覧を次に示します。

• 長いリスト処理の優れた性能
• タイトな UI シナリオ向けのコンパクトなサイズ設定
• 連続値埋め込みと評価
• 間隔のカスタマイズ
• 拡大アニメーションを無効にする
• 星の数のカスタマイズ