API 레퍼런스
QMLPlus
QWidget 기반 컨트롤에 앵커, 속성 바인딩 및 간단한 상태를 추가하는 믹스인입니다. 상태와 runtime()에는 QObject 호스트가 필요하며, 앵커 및 호스트 대상 바인딩 도우미에는 QWidget이 필요합니다.
일치하는 API 멤버가 없습니다.
fluent::AnchorLayout
상속 대상 QLayout
QWidget 컨트롤용 경량 앵커 기반 레이아웃입니다. 자식별 가장자리 앵커를 저장하고 레이아웃 패스 중에 위젯 지오메트리를 계산합니다.
생성자
소멸자
열거형
enum class Edge앵커링 가능한 가장자리 또는 중심선.
NoneLeftRightTopBottomHCenterVCenter
메서드
Anchors anchorsForWidget(QWidget* widget) const등록된 위젯의 현재 앵커를 반환합니다.
bool setWidgetAnchors(QWidget* widget, const Anchors& anchors)등록된 위젯의 앵커를 교체하고 레이아웃을 무효화합니다.
타입 및 별칭
struct Anchor한 가장자리에서 대상 위젯 가장자리로의 단일 앵커 관계.
struct Anchors단일 자식 위젯의 전체 앵커 집합.
Qt 기본 클래스 문서: QLayout
fluent::AnchorLayout::Anchor
한 가장자리에서 대상 위젯 가장자리로의 단일 앵커 관계.
생성자
필드
fluent::AnchorLayout::Anchors
단일 자식 위젯의 전체 앵커 집합.
생성자
필드
fluent::PropertyLink
상속 대상 QObject
한 QObject 속성을 다른 속성과 동기화하는 런타임 연결입니다.
생성자
메서드
Qt 기본 클래스 문서: QObject
fluent::BindingDependency
계산된 바인딩 또는 상태 조건에 대한 관찰 가능한 속성 종속성입니다. 해당 속성은 호출 스레드에서 읽을 수 있어야 하며 NOTIFY 시그널이 있어야 합니다.
필드
fluent::BindingOptions
바인딩의 초기 활성화 상태 및 선택적 이벤트 루프 병합 설정
필드
fluent::BindingHandle
대상 객체가 관리하는 속성 바인딩에 대한 복사 가능한 핸들입니다. 핸들을 복사하거나 소멸해도 바인딩은 해제되지 않으며, 영구적으로 제거하려면 unbind()를 호출해야 합니다.
생성자
메서드
bool isValid() const바인딩과 해당 엔드포인트가 유효한 상태로 유지되는지 여부를 보고합니다.
bool isEnabled() const일시 중지 또는 상태 보류와 무관하게 활성화 여부를 반환합니다.
bool isSuspended() const수동 일시 중지 또는 활성 상태 재정의 여부를 보고합니다.
void setEnabled(bool enabled) const동기화를 활성화하거나 비활성화합니다. 활성화하면 즉시 새로 고칩니다.
void pause() const활성화 상태를 유지하면서 현재 표시된 값을 유지합니다.
void resume() const수동 일시 중지를 해제하고 활성화되어 있으며 덮어쓰이지 않은 바인딩을 새로 고칩니다.
void refresh() const지연 스케줄링을 건너뛰고 활성 바인딩을 즉시 평가합니다.
void unbind() const바인딩을 영구적으로 제거하고 현재 표시된 값을 유지합니다.
fluent::PropertyBinder
Qt 메타 속성 및 NOTIFY를 통한 관리형 속성 동기화입니다. 유효한 교체는 기존 바인딩 핸들을 무효화하며, 유효하지 않은 요청은 기존 바인딩을 그대로 유지합니다.
열거형
enum Direction바인딩 방향.
OneWayTwoWay
메서드
static void bind(QObject* source, const char* sPropName, QObject* target, const char* tPropName, Direction dir = OneWay)사용 가능한 NOTIFY 시그널을 사용하여 @p source의 @p sPropName을 @p target의 @p tPropName에 바인딩합니다. 두 객체 모두 호출 스레드에 있어야 하며, 유효한 호출은 대상 속성의 기존 바인딩을 대체합니다.
static BindingHandle bindManaged(QObject* source, const char* sourceProp, QObject* target, const char* targetProp, Direction direction = OneWay, BindingOptions options = {})관리되는 직접 바인딩을 설치하고 초기값을 즉시 동기화합니다. 두 객체 모두 호출 스레드에 있어야 하며, @p sourceProp에는 NOTIFY가 필요하고 @p targetProp은 쓰기 가능해야 합니다 (TwoWay의 경우 양방향 모두 읽기, 쓰기 및 알림이 가능해야 합니다).
static BindingHandle bindComputed(QObject* target, const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})명시적 @p dependencies로 구동되는 C++ 표현식 바인딩을 설치합니다. 대상 속성은 읽기 및 쓰기가 가능해야 하며, 종속성 중 하나라도 소멸되면 바인딩이 영구적으로 무효화됩니다.
fluent::PropertyChange
QMLPlus state가 적용하는 속성 할당.
필드
fluent::AnchorChange
상태에 의해 적용 및 복원되는 전체 대체 앵커 집합.
필드
fluent::QMLState
이름이 지정된 속성 변경 집합.
필드
fluent::PropertyAnimation
MotionPolicy를 준수하는 관리형 속성 쓰기의 애니메이션 설정.
필드
fluent::StateTransition
일치하는 상태 변경에 대해 선택되는 애니메이션입니다. properties 목록이 비어 있으면 모든 속성과 일치합니다. 비어 있는 from/to는 기본 상태와 일치하고 "*"는 모든 상태와 일치하며, anchor 변경에는 애니메이션이 적용되지 않습니다.
필드
fluent::QMLPlusRuntime
상속 대상 QObject
QObject 호스트가 소유하며 필요 시 지연 생성되는 QMLPlus 상태 전환 관찰자입니다. 중단되지 않는 한 즉시 전환을 포함해 전환이 완료되면 transitionFinished()를 한 번 발생시킵니다.
소멸자
메서드
QString state() const애니메이션이 완료되기 전의 논리적 대상 상태를 반환합니다.
bool isTransitionRunning() const관리되는 상태 전환 애니메이션이 실행 중인지 여부를 보고합니다.
속성
QString state애니메이션이 완료되기 전의 논리적 대상 상태를 반환합니다.
읽기state()알림 신호stateChanged()bool transitionRunning관리되는 상태 전환 애니메이션이 실행 중인지 여부를 보고합니다.
읽기isTransitionRunning()알림 신호transitionRunningChanged()
시그널
void stateChanged(const QString& state)애니메이션이 완료되기 전의 논리적 대상 상태를 반환합니다.
void transitionRunningChanged(bool running)관리되는 상태 전환 애니메이션이 실행 중인지 여부를 보고합니다.
Qt 기본 클래스 문서: QObject
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를 통해 호스트 속성을 씁니다.