Fluent-Qt

텍스트 입력

NumberBox 숫자 입력 상자

스핀 버튼과 인라인 수식 입력을 지원하는 숫자 입력 컨트롤입니다.

예제

NumberBox 숫자 입력 상자: 드래그하여 값 조정

사용법

드래그하여 값 조정

setScrubbingEnabled(true)를 호출해 핸들을 드래그하며 값을 실시간으로 조정합니다. Shift 키로 미세 조정하고 Escape 키로 원래 값을 복원합니다.

#include <FluentQt/TextFields.h>
using namespace fluent::textfields;

auto* number = new NumberBox(this);
number->setObjectName("scrubNumber");
number->setAccessibleName("Rotation angle");
number->setHeader("Rotation angle");
number->setRange(-180, 180);
number->setValue(30);
number->setScrubbingEnabled(true);
number->setScrubSensitivity(0.5);
number->setDisplayPrecision(1);
number->setFixedWidth(260);

fluent::textfields::NumberBox

상속 대상 LineEdit

값 범위 제한, 수식 평가 및 스핀 버튼이 포함된 숫자 LineEdit.

생성자

열거형

메서드

double value() const

입력에서 현재 커밋된 숫자 값.

void setValue(double value)

입력에서 현재 커밋된 숫자 값.

double minimum() const

입력값과 단계 증감값을 제한하는 데 사용되는 하한값.

void setMinimum(double minimum)

입력값과 단계 증감값을 제한하는 데 사용되는 하한값.

double maximum() const

입력값과 단계 값을 제한하는 데 사용되는 상한

void setMaximum(double maximum)

입력값과 단계 값을 제한하는 데 사용되는 상한

double smallChange() const

스핀 버튼 한 번 클릭 또는 작은 키보드 단위에 사용되는 증가분

void setSmallChange(double change)

스핀 버튼 한 번 클릭 또는 작은 키보드 단위에 사용되는 증가분

double largeChange() const

큰 단위 키보드 동작에 사용되는 증가분

void setLargeChange(double change)

큰 단위 키보드 동작에 사용되는 증가분

QString header() const

숫자 입력 행 위에 표시되는 선택적 레이블 텍스트.

void setHeader(const QString& header)

숫자 입력 행 위에 표시되는 선택적 레이블 텍스트.

bool acceptsExpression() const

입력한 산술 식을 커밋 전에 계산할지 여부.

void setAcceptsExpression(bool accepts)

입력한 산술 식을 커밋 전에 계산할지 여부.

SpinButtonPlacementMode spinButtonPlacementMode() const

숨김, 콤팩트 또는 인라인 스핀 버튼의 배치 모드.

void setSpinButtonPlacementMode(SpinButtonPlacementMode mode)

숨김, 콤팩트 또는 인라인 스핀 버튼의 배치 모드.

QSize spinButtonSize() const

외부 스핀 버튼의 크기입니다.

void setSpinButtonSize(const QSize& size)

외부 스핀 버튼의 크기입니다.

QSize inlineSpinButtonSize() const

인라인 스핀 버튼의 크기입니다.

void setInlineSpinButtonSize(const QSize& size)

인라인 스핀 버튼의 크기입니다.

int spinButtonRightMargin() const

인라인 스핀 버튼과 프레임 사이에 확보된 오른쪽 여백.

void setSpinButtonRightMargin(int margin)

인라인 스핀 버튼과 프레임 사이에 확보된 오른쪽 여백.

int compactSpinButtonReservedWidth() const

입력 상자 내부의 컴팩트 스핀 버튼용으로 예약된 너비.

void setCompactSpinButtonReservedWidth(int width)

입력 상자 내부의 컴팩트 스핀 버튼용으로 예약된 너비.

int spinButtonSpacing() const

인접한 스핀 버튼 사이의 간격입니다.

void setSpinButtonSpacing(int spacing)

인접한 스핀 버튼 사이의 간격입니다.

int spinButtonTextGap() const

텍스트 콘텐츠와 인라인 스핀 버튼 외형 사이의 간격.

void setSpinButtonTextGap(int gap)

텍스트 콘텐츠와 인라인 스핀 버튼 외형 사이의 간격.

int spinButtonIconSize() const

스핀 버튼 셰브론에 사용되는 아이콘 글리프 크기

void setSpinButtonIconSize(int size)

스핀 버튼 셰브론에 사용되는 아이콘 글리프 크기

int displayPrecision() const

값을 서식 지정할 때 사용하는 소수점 이하 자릿수.

void setDisplayPrecision(int precision)

값을 서식 지정할 때 사용하는 소수점 이하 자릿수.

double formatStep() const

값 변경 후 표시 반올림을 정규화하는 데 사용되는 단계 크기입니다.

void setFormatStep(double step)

값 변경 후 표시 반올림을 정규화하는 데 사용되는 단계 크기입니다.

bool isScrubbingEnabled() const

별도의 가로 드래그 핸들을 활성화합니다. 텍스트 선택은 그대로 유지됩니다.

void setScrubbingEnabled(bool enabled)

별도의 가로 드래그 핸들을 활성화합니다. 텍스트 선택은 그대로 유지됩니다.

double scrubSensitivity() const

논리 픽셀당 값 단위 (유한한 양수여야 함)

void setScrubSensitivity(double sensitivity)

논리 픽셀당 값 단위 (유한한 양수여야 함)

bool isScrubbing() const

드래그 트랜잭션 활성 상태 여부

QRect scrubHandleRect() const

논리적 핸들 지오메트리이며, 비활성화 상태에서는 비어 있습니다.

void cancelScrub()

초기 빈 값을 포함하여 진행 중인 드래그를 롤백합니다.

void commitInput()

범위 및 표현식 규칙을 사용하여 현재 텍스트를 파싱하고 커밋합니다.

속성

double value

입력에서 현재 커밋된 숫자 값.

읽기 value()쓰기 setValue()알림 신호 valueChanged()
double minimum

입력값과 단계 증감값을 제한하는 데 사용되는 하한값.

읽기 minimum()쓰기 setMinimum()알림 신호 minimumChanged()
double maximum

입력값과 단계 값을 제한하는 데 사용되는 상한

읽기 maximum()쓰기 setMaximum()알림 신호 maximumChanged()
double smallChange

스핀 버튼 한 번 클릭 또는 작은 키보드 단위에 사용되는 증가분

읽기 smallChange()쓰기 setSmallChange()알림 신호 smallChangeChanged()
double largeChange

큰 단위 키보드 동작에 사용되는 증가분

읽기 largeChange()쓰기 setLargeChange()알림 신호 largeChangeChanged()
QString header

숫자 입력 행 위에 표시되는 선택적 레이블 텍스트.

읽기 header()쓰기 setHeader()알림 신호 headerChanged()
bool acceptsExpression

입력한 산술 식을 커밋 전에 계산할지 여부.

읽기 acceptsExpression()쓰기 setAcceptsExpression()알림 신호 acceptsExpressionChanged()
SpinButtonPlacementMode spinButtonPlacementMode

숨김, 콤팩트 또는 인라인 스핀 버튼의 배치 모드.

읽기 spinButtonPlacementMode()쓰기 setSpinButtonPlacementMode()알림 신호 spinButtonPlacementModeChanged()
QSize spinButtonSize

외부 스핀 버튼의 크기입니다.

읽기 spinButtonSize()쓰기 setSpinButtonSize()알림 신호 spinButtonSizeChanged()
QSize inlineSpinButtonSize

인라인 스핀 버튼의 크기입니다.

읽기 inlineSpinButtonSize()쓰기 setInlineSpinButtonSize()알림 신호 inlineSpinButtonSizeChanged()
int spinButtonRightMargin

인라인 스핀 버튼과 프레임 사이에 확보된 오른쪽 여백.

읽기 spinButtonRightMargin()쓰기 setSpinButtonRightMargin()알림 신호 spinButtonRightMarginChanged()
int compactSpinButtonReservedWidth

입력 상자 내부의 컴팩트 스핀 버튼용으로 예약된 너비.

읽기 compactSpinButtonReservedWidth()쓰기 setCompactSpinButtonReservedWidth()알림 신호 compactSpinButtonReservedWidthChanged()
int spinButtonSpacing

인접한 스핀 버튼 사이의 간격입니다.

읽기 spinButtonSpacing()쓰기 setSpinButtonSpacing()알림 신호 spinButtonSpacingChanged()
int spinButtonTextGap

텍스트 콘텐츠와 인라인 스핀 버튼 외형 사이의 간격.

읽기 spinButtonTextGap()쓰기 setSpinButtonTextGap()알림 신호 spinButtonTextGapChanged()
int spinButtonIconSize

스핀 버튼 셰브론에 사용되는 아이콘 글리프 크기

읽기 spinButtonIconSize()쓰기 setSpinButtonIconSize()알림 신호 spinButtonIconSizeChanged()
int displayPrecision

값을 서식 지정할 때 사용하는 소수점 이하 자릿수.

읽기 displayPrecision()쓰기 setDisplayPrecision()알림 신호 displayPrecisionChanged()
double formatStep

값 변경 후 표시 반올림을 정규화하는 데 사용되는 단계 크기입니다.

읽기 formatStep()쓰기 setFormatStep()알림 신호 formatStepChanged()
bool scrubbingEnabled

별도의 가로 드래그 핸들을 활성화합니다. 텍스트 선택은 그대로 유지됩니다.

읽기 isScrubbingEnabled()쓰기 setScrubbingEnabled()알림 신호 scrubbingEnabledChanged()
double scrubSensitivity

논리 픽셀당 값 단위 (유한한 양수여야 함)

읽기 scrubSensitivity()쓰기 setScrubSensitivity()알림 신호 scrubSensitivityChanged()
bool scrubbing

드래그 트랜잭션 활성 상태 여부

읽기 isScrubbing()알림 신호 scrubbingChanged()

시그널

void valueChanged(double value)

입력에서 현재 커밋된 숫자 값.

void minimumChanged(double minimum)

입력값과 단계 증감값을 제한하는 데 사용되는 하한값.

void maximumChanged(double maximum)

입력값과 단계 값을 제한하는 데 사용되는 상한

void smallChangeChanged(double change)

스핀 버튼 한 번 클릭 또는 작은 키보드 단위에 사용되는 증가분

void largeChangeChanged(double change)

큰 단위 키보드 동작에 사용되는 증가분

void headerChanged()

숫자 입력 행 위에 표시되는 선택적 레이블 텍스트.

void acceptsExpressionChanged(bool accepts)

입력한 산술 식을 커밋 전에 계산할지 여부.

void spinButtonPlacementModeChanged(SpinButtonPlacementMode mode)

숨김, 콤팩트 또는 인라인 스핀 버튼의 배치 모드.

void spinButtonSizeChanged(const QSize& size)

외부 스핀 버튼의 크기입니다.

void inlineSpinButtonSizeChanged(const QSize& size)

인라인 스핀 버튼의 크기입니다.

void spinButtonRightMarginChanged(int margin)

인라인 스핀 버튼과 프레임 사이에 확보된 오른쪽 여백.

void compactSpinButtonReservedWidthChanged(int width)

입력 상자 내부의 컴팩트 스핀 버튼용으로 예약된 너비.

void spinButtonSpacingChanged(int spacing)

인접한 스핀 버튼 사이의 간격입니다.

void spinButtonTextGapChanged(int gap)

텍스트 콘텐츠와 인라인 스핀 버튼 외형 사이의 간격.

void spinButtonIconSizeChanged(int size)

스핀 버튼 셰브론에 사용되는 아이콘 글리프 크기

void displayPrecisionChanged(int precision)

값을 서식 지정할 때 사용하는 소수점 이하 자릿수.

void formatStepChanged(double step)

값 변경 후 표시 반올림을 정규화하는 데 사용되는 단계 크기입니다.

void scrubbingEnabledChanged(bool enabled)

별도의 가로 드래그 핸들을 활성화합니다. 텍스트 선택은 그대로 유지됩니다.

void scrubSensitivityChanged(double sensitivity)

논리 픽셀당 값 단위 (유한한 양수여야 함)

void scrubbingChanged(bool scrubbing)

드래그 트랜잭션 활성 상태 여부

void scrubStarted(double initialValue)

드래그 스크럽이 시작될 때 발생하며, valueChanged()는 실시간 변경 사항을 계속 보고합니다.

void scrubFinished(double initialValue, double finalValue, bool canceled)

드래그 스크럽이 끝날 때 발생하며, 취소 시 먼저 initialValue로 복원됩니다.

보호된 멤버

메서드

fluent::textfields::LineEdit에서 상속됨

메서드

QMargins contentMargins() const

텍스트 주위의 콘텐츠 여백 (가로 값에는 Qt의 내부 텍스트 인셋이 포함됨).

void setContentMargins(const QMargins& margins)

텍스트 주위의 콘텐츠 여백 (가로 값에는 Qt의 내부 텍스트 인셋이 포함됨).

Typography::FontRole fontRole() const

텍스트에 사용되는 Fluent Typography 프리셋.

void setFontRole(Typography::FontRole role)

텍스트에 사용되는 Fluent Typography 프리셋.

bool isClearButtonEnabled() const

후행 지우기 버튼 활성화 여부.

void setClearButtonEnabled(bool enabled)

후행 지우기 버튼 활성화 여부.

int clearButtonSize() const

지우기 버튼의 크기로, 기본값은 24 논리 픽셀입니다.

void setClearButtonSize(int size)

지우기 버튼의 크기로, 기본값은 24 논리 픽셀입니다.

QPoint clearButtonOffset() const

지우기 버튼에 적용되는 픽셀 오프셋.

void setClearButtonOffset(const QPoint& offset)

지우기 버튼에 적용되는 픽셀 오프셋.

int focusedBorderWidth() const

포커스 상태일 때의 하단 테두리 너비.

void setFocusedBorderWidth(int width)

포커스 상태일 때의 하단 테두리 너비.

int unfocusedBorderWidth() const

포커스되지 않았을 때의 하단 테두리 너비; 기본값은 0 (밑줄 없음).

void setUnfocusedBorderWidth(int width)

포커스되지 않았을 때의 하단 테두리 너비; 기본값은 0 (밑줄 없음).

bool isFrameVisible() const

LineEdit 입력 프레임과 포커스 밑줄 그리기 여부

void setFrameVisible(bool visible)

LineEdit 입력 프레임과 포커스 밑줄 그리기 여부

void setTrailingText(const QString& text)

후행 가장자리에 일반 텍스트 접미사를 표시하고 기존 후행 위젯을 대체합니다.

bool setTrailingWidget(QWidget* widget, WidgetOwnership ownership)

WidgetOwnership을 사용하여 정리 방식을 지정하는 사용자 정의 후행 위젯을 설정합니다 (자기 자신 또는 상위 위젯은 거부됩니다). 소유권 모드를 전환하기 전에 takeTrailingWidget()을 호출하세요.

QWidget* takeTrailingWidget()

호출자가 관리하거나 삭제할 수 있도록 후행 위젯을 제거하고 반환합니다.

void releaseTrailingWidget()

후행 위젯을 제거하고 WidgetOwnership 모드에 따라 정리를 처리합니다.

속성

QMargins contentMargins

텍스트 주위의 콘텐츠 여백 (가로 값에는 Qt의 내부 텍스트 인셋이 포함됨).

읽기 contentMargins()쓰기 setContentMargins()알림 신호 contentMarginsChanged()
Typography::FontRole fontRole

텍스트에 사용되는 Fluent Typography 프리셋.

읽기 fontRole()쓰기 setFontRole()알림 신호 fontRoleChanged()
bool clearButtonEnabled

후행 지우기 버튼 활성화 여부.

읽기 isClearButtonEnabled()쓰기 setClearButtonEnabled()알림 신호 clearButtonEnabledChanged()
int clearButtonSize

지우기 버튼의 크기로, 기본값은 24 논리 픽셀입니다.

읽기 clearButtonSize()쓰기 setClearButtonSize()알림 신호 clearButtonSizeChanged()
QPoint clearButtonOffset

지우기 버튼에 적용되는 픽셀 오프셋.

읽기 clearButtonOffset()쓰기 setClearButtonOffset()알림 신호 clearButtonOffsetChanged()
int focusedBorderWidth

포커스 상태일 때의 하단 테두리 너비.

읽기 focusedBorderWidth()쓰기 setFocusedBorderWidth()알림 신호 focusedBorderWidthChanged()
int unfocusedBorderWidth

포커스되지 않았을 때의 하단 테두리 너비; 기본값은 0 (밑줄 없음).

읽기 unfocusedBorderWidth()쓰기 setUnfocusedBorderWidth()알림 신호 unfocusedBorderWidthChanged()
bool frameVisible

LineEdit 입력 프레임과 포커스 밑줄 그리기 여부

읽기 isFrameVisible()쓰기 setFrameVisible()알림 신호 frameVisibleChanged()
QString trailingText
읽기 trailingText()쓰기 setTrailingText()알림 신호 trailingTextChanged()
QWidget* trailingWidget
읽기 trailingWidget()알림 신호 trailingWidgetChanged()
fluent::WidgetOwnership trailingWidgetOwnership
읽기 trailingWidgetOwnership()알림 신호 trailingWidgetOwnershipChanged()
QString clearButtonAccessibleName
읽기 clearButtonAccessibleName()쓰기 setClearButtonAccessibleName()알림 신호 clearButtonAccessibleNameChanged()
Qt::FocusPolicy clearButtonFocusPolicy
읽기 clearButtonFocusPolicy()쓰기 setClearButtonFocusPolicy()알림 신호 clearButtonFocusPolicyChanged()

시그널

void contentMarginsChanged()

텍스트 주위의 콘텐츠 여백 (가로 값에는 Qt의 내부 텍스트 인셋이 포함됨).

void fontRoleChanged()

텍스트에 사용되는 Fluent Typography 프리셋.

void clearButtonEnabledChanged()

후행 지우기 버튼 활성화 여부.

void clearButtonSizeChanged()

지우기 버튼의 크기로, 기본값은 24 논리 픽셀입니다.

void clearButtonOffsetChanged()

지우기 버튼에 적용되는 픽셀 오프셋.

void focusedBorderWidthChanged()

포커스 상태일 때의 하단 테두리 너비.

void unfocusedBorderWidthChanged()

포커스되지 않았을 때의 하단 테두리 너비; 기본값은 0 (밑줄 없음).

void frameVisibleChanged()

LineEdit 입력 프레임과 포커스 밑줄 그리기 여부

fluent::FluentElement에서 상속됨

열거형

enum Theme

디자인 토큰을 해석할 때 사용되는 전역 시각적 테마.

  • Light = 0
  • Dark = 1
  • HighContrast = 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

재질, 고도 (elevation) 및 적응형 레이아웃 토큰.

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에 바인딩합니다.

void addTransition(const StateTransition& transition)

우선순위 순서대로 상태 전환을 등록합니다.

void setBehavior(const char* propertyName, const PropertyAnimation& animation)

writeProperty() 또는 바인딩을 통해 @p propertyName에 쓸 때 사용되는 기본 애니메이션을 설정합니다. 명시적 StateTransition 규칙이 우선하며, 직접 C++ setter 호출에는 애니메이션이 적용되지 않습니다.

void clearBehavior(const char* propertyName)

이후 관리되는 쓰기 작업의 기본 애니메이션을 제거합니다.

bool writeProperty(const char* propertyName, const QVariant& value)

바인딩을 제거하지 않고 Behavior를 통해 호스트 속성을 씁니다.

Qt 기본 클래스 문서: QLineEdit