Fluent-Qt

API 레퍼런스

WindowChromeCompat

창 크롬 동작, 히트 테스트 및 시스템 배경을 위한 크로스 플랫폼 어댑터.

compatibility::WindowChromeOptions

플랫폼 창 크롬 통합 옵션.

필드

QRect titleBarRect

창 로컬 좌표 기준의 드래그 가능한 제목 표시줄 영역.

QVector<QRect> dragExclusionRects

제목 표시줄 내부에서 일반 클라이언트 영역으로 유지되는 자식 컨트롤 사각형 목록.

int resizeBorderWidth = 8

크기 조정 히트 테스트 테두리 너비 (장치 독립적 픽셀 단위).

bool useCustomWindowChrome = false

지원되는 플랫폼에서는 네이티브 창 관리를 우선 사용하면서 Fluent 사용자 정의 제목 표시줄 통합을 활성화합니다.

bool preferNativeMacControls = true

사용 가능한 경우 기본 macOS 신호등 창 제어 버튼을 유지합니다.

bool chromeInteractive = true

false일 때 창 이동 및 크기 조정을 잠급니다 (예: 모달 오버레이가 활성화된 동안).

QPointer<QAbstractButton> maximizeButton

기본 제목 표시줄 히트 테스트에 사용되는 최대화/복원 버튼.

compatibility::WindowChromeCompat

생성자

열거형

enum class Platform

창 크롬 정책 결정에 사용되는 런타임 플랫폼 계열입니다.

  • Windows
  • MacOS
  • Linux
  • Other
enum class HitTest

플랫폼별 히트 코드에 매핑되는 논리적 히트 테스트 결과.

  • Client
  • Caption
  • Left
  • Right
  • Top
  • Bottom
  • TopLeft
  • TopRight
  • BottomLeft
  • BottomRight

메서드

void configure(const WindowChromeOptions& options)

창 크롬 옵션을 업데이트하고 플랫폼 제목 표시줄 지오메트리를 동기화합니다.

void applyPlatformWindowFlags()

현재 크롬 구성에 필요한 플랫폼 창 플래그를 적용합니다.

bool systemBackdropSupported() const

이 플랫폼에서 반투명 시스템 배경을 지원하는지 여부.

BackdropCapabilities backdropCapabilities() const

현재 세션의 효과별 플랫폼 기능을 반환합니다.

bool applySystemBackdrop(BackdropEffect effect, bool dark, bool forceRecomposite = false)

요청된 시스템 배경 효과를 적용합니다 (레거시 헬퍼; 확인된 백엔드 세부 정보는 applySystemBackdropDetailed()를 사용하세요).

BackdropApplyResult applySystemBackdropDetailed(BackdropEffect effect, bool dark, bool forceRecomposite = false)

배경 효과를 적용하고 확인된 백엔드, 충실도 및 대체 사유를 반환합니다.

bool handleNativeEvent(const QByteArray& eventType, void* message, FluentNativeEventResult* result)

전달된 네이티브 이벤트를 처리하고, 처리된 경우 true를 반환합니다.

bool beginSystemMove(const QPoint& globalPos)

플랫폼 시스템 이동 작업을 시작합니다.

bool beginSystemResize(Qt::Edges edges, const QPoint& globalPos)

지정된 가장자리에 대해 플랫폼 시스템 크기 조정 작업을 시작합니다.

bool performTitleBarDoubleClick()

플랫폼 제목 표시줄 더블클릭 동작을 수행합니다.

bool showSystemMenu(const QPoint& globalPos)

지정된 전역 좌표에 플랫폼 시스템 메뉴를 표시합니다.

bool requestForegroundActivation()

플랫폼 창 관리자를 통해 포그라운드 활성화를 요청합니다.

HitTest hitTestLocal(const QPoint& localPos) const

설정한 제목 표시줄 및 크기 조절 영역을 기준으로 로컬 좌표를 분류합니다.

compatibility

타입 및 별칭

using FluentNativeEventResult = qintptr

Qt 버전 전반에서 QWidget::nativeEvent()에 사용되는 네이티브 이벤트 결과 타입.