基本入力
RatingControl 評価コントロール
星による評価の表示、設定、クリアを行います。
サンプル
プロパティプレビューを読み込めませんでした。もう一度「プロパティプレビュー」を選択して再試行してください。

使い方
評価値
value シグナルでキャプションと外部のステータスラベルの両方を更新できます。
#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;
auto* rating = new RatingControl(this);
rating->setCaption("312 ratings");
connect(rating, &RatingControl::valueChanged,
this, [=](double value) {
rating->setCaption("Your rating");
status->setText(QString("Value: %1").arg(value));
});import fluentqt
rating = fluentqt.RatingControl()
rating.setCaption('312 ratings')
rating.valueChanged.connect(
lambda value: (
rating.setCaption("Your rating"),
status.setText(
"Value: Unset"
if value < 0.0
else f"Value: {value:.1f} stars"
),
)
)API
宣言を表示一致する API メンバーはありません。
fluent::basicinput::RatingControl
継承元 QWidget · FluentElement · QMLPlus
半星精度、プレースホルダープレビュー、および任意のクリア操作に対応した星評価コントロール。
コンストラクタ
メソッド
double value() constユーザーが確定した選択済みの評価値です。
void setValue(double value)ユーザーが確定した選択済みの評価値です。
double placeholderValue() const最終値が選択されていないときにプレビュー表示される評価値。
void setPlaceholderValue(double value)最終値が選択されていないときにプレビュー表示される評価値。
QString caption() const評価グリフの横に表示される補足テキストです。
void setCaption(const QString& caption)評価グリフの横に表示される補足テキストです。
bool isClearEnabled() constユーザー操作によって現在の評価をクリアできるかどうか。
void setIsClearEnabled(bool enabled)ユーザー操作によって現在の評価をクリアできるかどうか。
bool isReadOnly() const表示を維持したままユーザー操作をブロックするかどうか。
void setIsReadOnly(bool readOnly)表示を維持したままユーザー操作をブロックするかどうか。
int maxRating() constコントロールが公開する最大評価値。
void setMaxRating(int rating)コントロールが公開する最大評価値。
int starSize() const評価グリフのサイズ(ピクセル単位)。
void setStarSize(int size)評価グリフのサイズ(ピクセル単位)。
Typography::FontRole fontRole() constテキストに使用される Fluent Typography プリセット。
void setFontRole(Typography::FontRole role)テキストに使用される Fluent Typography プリセット。
Typography::FontRole captionFontRole() const評価キャプションに使用される Fluent Typography プリセット。
void setCaptionFontRole(Typography::FontRole role)評価キャプションに使用される Fluent Typography プリセット。
プロパティ
double valueユーザーが確定した選択済みの評価値です。
読み取りvalue()書き込みsetValue()通知シグナルvalueChanged()double placeholderValue最終値が選択されていないときにプレビュー表示される評価値。
読み取りplaceholderValue()書き込みsetPlaceholderValue()通知シグナルplaceholderValueChanged()QString caption評価グリフの横に表示される補足テキストです。
読み取りcaption()書き込みsetCaption()通知シグナルcaptionChanged()bool isClearEnabledユーザー操作によって現在の評価をクリアできるかどうか。
読み取りisClearEnabled()書き込みsetIsClearEnabled()通知シグナルisClearEnabledChanged()bool isReadOnly表示を維持したままユーザー操作をブロックするかどうか。
読み取りisReadOnly()書き込みsetIsReadOnly()通知シグナルisReadOnlyChanged()int maxRatingコントロールが公開する最大評価値。
読み取りmaxRating()書き込みsetMaxRating()通知シグナルmaxRatingChanged()int starSize評価グリフのサイズ(ピクセル単位)。
読み取りstarSize()書き込みsetStarSize()通知シグナルstarSizeChanged()Typography::FontRole fontRoleテキストに使用される Fluent Typography プリセット。
読み取りfontRole()書き込みsetFontRole()通知シグナルfontRoleChanged()Typography::FontRole captionFontRole評価キャプションに使用される Fluent Typography プリセット。
読み取りcaptionFontRole()書き込みsetCaptionFontRole()通知シグナルcaptionFontRoleChanged()
シグナル
void valueChanged(double value)ユーザーが確定した選択済みの評価値です。
void placeholderValueChanged(double value)最終値が選択されていないときにプレビュー表示される評価値。
void captionChanged(const QString& caption)評価グリフの横に表示される補足テキストです。
void isClearEnabledChanged(bool enabled)ユーザー操作によって現在の評価をクリアできるかどうか。
void isReadOnlyChanged(bool readOnly)表示を維持したままユーザー操作をブロックするかどうか。
void maxRatingChanged(int rating)コントロールが公開する最大評価値。
void starSizeChanged(int size)評価グリフのサイズ(ピクセル単位)。
void fontRoleChanged()テキストに使用される Fluent Typography プリセット。
void captionFontRoleChanged()評価キャプションに使用される Fluent Typography プリセット。
protected メンバー
メソッド
fluent::FluentElement から継承
列挙型
enum Themeデザイントークン解決時に使用されるグローバルな視覚テーマ。
Light = 0Dark = 1HighContrast = 2
メソッド
static void setTheme(Theme theme)グローバルテーマを更新し、アクティブな FluentElement インスタンスに通知します。
static void setThemeDeferred(Theme theme)現在の操作をブロックせずに、可視要素を優先したバッチ処理でテーマの更新をスケジュールします。
static Theme currentTheme()現在有効なグローバルテーマを返します。
static bool themeUsesDarkAppearance(Theme theme)テーマがダークベースのクロームおよびマテリアルトークンを使用するかどうかを返します。
static void refreshTheme()デザイントークンの変更後に再描画するため、現在のテーマを再ブロードキャストします。
static int themeGeneration()テーマ変更ごとに加算される単調増加カウンターです。鮮度チェックに使用されます。
Theme effectiveTheme() const継承された QWidget の上書きを尊重し、この要素が使用するテーマを解決します。
bool effectiveThemeUsesDarkAppearance() constこの要素の有効なテーマがダークベースのクロームを使用するかどうかを返します。
bool setThemeOverrides(const QJsonObject& overrides)この要素のスパースな色、角丸半径、フォントトークンの上書きを置き換えます。
QJsonObject themeOverrides() constこの要素に設定されたオーバーライドを返します。
void clearThemeOverrides()すべてのトークンフィールドをグローバルテーマの既定値に復元します。
const Colors& themeColorsRef() const描画のホットパス向けにアクティブなカラーセットへ非コピーでアクセスします。
Material::AcrylicToken themeAcrylic() constマテリアル、エレベーション、およびアダプティブレイアウトのトークン。
QColor themeBackdrop(bool active) const指定されたアクティブ状態に対するウィンドウ chrome の背景色。
virtual void onThemeUpdated()グローバルテーマの変更後に呼び出されます。
型とエイリアス
struct Colorsコンポーネントに返されるデザイントークンのスナップショット。
fluent::QMLPlus から継承
メソッド
AnchorLayout::Anchors* anchors()QWidget ホストの変更可能なアンカーを返します。
void setState(const QString& name)登録済みの状態を名前で適用するか、@p name が空の場合はデフォルト状態を復元します。未知の名前は無視され、その状態を離れると既存のバインディングが再開されます。
void addState(const QMLState& state)名前付き状態定義を登録または置換します。アクティブな状態を置換した場合は即座に適用されます。
void evaluateStates()登録順に状態条件を再評価し、最初に一致した状態(一致しない場合はデフォルト状態)をアクティブにします。依存プロパティの変更通知時にも自動実行され、extend を使用する派生状態は、循環や欠損がない限り祖先の変更を継承します。
QMLPlusRuntime* runtime()このホストが所有し、遅延生成される状態オブザーバーを返します。
void setAnchors(const AnchorLayout::Anchors& anchors)すべてのホストアンカーを置き換え、親レイアウトを無効化します。
void resetAnchors()ホストのすべてのアンカーをクリアし、親レイアウトを無効化します。
void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)PropertyBinder::bind() を介して、@p source の @p sourceProp をこの QWidget ホストの @p targetProp にバインドします。
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {})この QWidget ホストに管理された直接バインディングを設定します。
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})この QWidget ホストに明示的依存関係を持つ C++ 式を設定します。
void addTransition(const StateTransition& transition)優先順位順に状態遷移を登録します。
void setBehavior(const char* propertyName, const PropertyAnimation& animation)writeProperty() またはバインディング経由で @p propertyName が書き込まれた際に使用されるデフォルトアニメーションを設定します。明示的な StateTransition ルールが優先され、C++ のセッターを直接呼び出した場合はアニメーションしません。
void clearBehavior(const char* propertyName)今後のマネージド書き込みに使用するデフォルトアニメーションを削除します。
bool writeProperty(const char* propertyName, const QVariant& value)バインディングを削除せずに Behavior 経由でホストプロパティに書き込みます。
Qt 基底クラスドキュメント:QWidget