텍스트 입력
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);import fluentqt
number = fluentqt.NumberBox()
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)API
선언 보기일치하는 API 멤버가 없습니다.
fluent::textfields::NumberBox
상속 대상 LineEdit
값 범위 제한, 수식 평가 및 스핀 버튼이 포함된 숫자 LineEdit.
생성자
열거형
enum class SpinButtonPlacementModeHiddenCompactInline
메서드
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() constLineEdit 입력 프레임과 포커스 밑줄 그리기 여부
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 frameVisibleLineEdit 입력 프레임과 포커스 밑줄 그리기 여부
읽기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 = 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재질, 고도 (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에 바인딩합니다.
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++ setter 호출에는 애니메이션이 적용되지 않습니다.
void clearBehavior(const char* propertyName)이후 관리되는 쓰기 작업의 기본 애니메이션을 제거합니다.
bool writeProperty(const char* propertyName, const QVariant& value)바인딩을 제거하지 않고 Behavior를 통해 호스트 속성을 씁니다.
Qt 기본 클래스 문서: QLineEdit