QStyleHints Class

속성 문서

[read-only, since 6.10] accessibility : const QAccessibilityHints*

이 속성은 애플리케이션의 접근성 힌트를 포함합니다.

이 접근성 힌트는 사용자가 애플리케이션의 고대비 모드를 사용할지 여부와 같은 플랫폼별 접근성 설정을 포함합니다.

이 열거형은 Qt 6.10에서 도입되었습니다.

액세스 함수:

QAccessibilityHints도 참조하십시오 .

[since 6.5] colorScheme : Qt::ColorScheme

이 속성은 애플리케이션에서 사용하는 색상 구성표를 저장합니다.

기본적으로 이 속성은 시스템의 기본 색상 구성(외관이라고도 함)을 따르며, 시스템 색상 구성이 변경될 때(예: 해질녘이나 새벽) 함께 변경됩니다. 색상 구성표를 명시적인 값으로 설정하면 시스템 설정이 무시되고 시스템 색상 구성표의 변경 사항도 반영되지 않습니다. 그러나 이는 시스템에 대한 힌트일 뿐이며, 색상 구성표 재정의는 모든 플랫폼에서 지원되는 것은 아닙니다.

이 속성을 재설정하거나 ` Qt::ColorScheme::Unknown`로 설정하면 재정의가 해제되고 애플리케이션이 다시 시스템 기본값을 따르게 됩니다. 속성 값은 시스템의 현재 색 구성표로 변경됩니다.

이 속성이 변경되면 Qt는 시스템 팔레트를 읽어 기본 팔레트를 업데이트하지만, 애플리케이션에서 명시적으로 설정한 팔레트 항목은 덮어쓰지 않습니다. colorSchemeChange() 신호가 발생했을 때, 이전 팔레트는 여전히 유효합니다.

애플리케이션 고유의 색상은 현재 색상 구성표를 고려하여 유효한 팔레트와 잘 어울리도록 선택해야 합니다. 유효한 팔레트가 변경될 때 애플리케이션 고유의 색상을 업데이트하려면 PaletteChange 또는 ApplicationPaletteChange 이벤트를 처리하십시오.

이 열거형은 Qt 6.5에서 도입되었습니다.

액세스 함수:

Notifier 신호:

Qt::ColorScheme, QGuiApplication::palette(), QEvent::PaletteChange도 참조하십시오 .

[since 6.8] contextMenuTrigger : Qt::ContextMenuTrigger

컨텍스트 메뉴 이벤트를 트리거하는 데 사용되는 마우스 이벤트.

UNIX 시스템의 기본 설정은 마우스 버튼 누름 이벤트 시 컨텍스트 메뉴를 표시하는 반면, Windows에서는 마우스 버튼 놓음 이벤트 시 표시됩니다. 이 속성을 사용하면 플랫폼의 기본 동작을 재정의할 수 있습니다.

이 열거형은 Qt 6.8에서 도입되었습니다.

액세스 함수:

Notifier 신호:

Qt::ContextMenuTrigger도 참조하십시오 .

[read-only] cursorFlashTime : int

이 속성은 텍스트 커서의 깜빡임(블링크) 시간을 밀리초 단위로 저장합니다.

깜빡임 시간은 캐럿을 표시하고, 반전시키고, 원래 상태로 복원하는 데 소요되는 시간입니다. 일반적으로 텍스트 커서는 커서 깜빡임 시간의 절반 동안 표시된 후, 동일한 시간 동안 숨겨집니다.

액세스 함수:

알림 신호:

[read-only] fontSmoothingGamma : const qreal

이 속성은 글꼴 스무딩에 사용되는 감마 값을 저장합니다.

액세스 함수:

[read-only, since 6.5] keyboardAutoRepeatRateF : const qreal

이 속성은 키를 누르고 있는 동안 추가적인 반복 키 입력이 자동으로 생성되는 빈도(초당 이벤트 수)를 지정합니다.

이 열거형은 Qt 6.5에서 도입되었습니다.

액세스 함수:

[read-only] keyboardInputInterval : int

이 속성은 단일 키 입력과 연속된 두 번의 키 입력을 구분하는 시간 제한(밀리초 단위)을 지정합니다.

액세스 함수:

알림 신호:

[read-only, since 6.10] menuSelectionWraps : const bool

메뉴 선택이 순환됩니다.

메뉴 선택이 순환하는 경우 ` true `를 반환합니다. 즉, 마지막 메뉴 항목에 도달한 후 키 탐색을 통해 선택 항목이 다시 첫 번째 메뉴 항목으로 이동하는지, 또는 그 반대의 경우도 마찬가지인지 여부를 나타냅니다.

이 열거형은 Qt 6.10에서 도입되었습니다.

액세스 함수:

[read-only] mouseDoubleClickDistance : const int

이 속성은 두 번의 연속된 마우스 클릭 사이에 마우스를 이동할 수 있는 최대 거리(픽셀 단위)를 나타내며, 이 범위 내에서만 더블 클릭으로 인식됩니다.

액세스 함수:

[read-only] mouseDoubleClickInterval : int

이 속성은 더블 클릭과 연속된 두 번의 마우스 클릭을 구분하는 시간 제한(밀리초 단위)을 지정합니다.

액세스 함수:

Notifier 신호:

[read-only] mousePressAndHoldInterval : int

이 속성은 길게 누르기 동작이 활성화되는 시간 제한(밀리초 단위)을 지정합니다.

액세스 함수:

알림 신호:

mouseQuickSelectionThreshold : int

QLineEdit 의 마우스 빠른 선택 임계값.

이 속성은 일반 텍스트 선택 시( QLineEdit ) 마우스 커서를 Y축 방향으로 얼마나 이동해야 빠른 선택이 활성화되는지를 정의합니다.

속성 값이 0 이하인 경우, 빠른 선택 기능이 비활성화됩니다.

액세스 함수:

알림 신호:

[read-only] passwordMaskCharacter : const QChar

이 속성은 비밀번호 모드에서 텍스트 입력 필드에 입력된 문자를 가리기 위해 사용되는 문자를 저장합니다.

액세스 함수:

[read-only] passwordMaskDelay : const int

이 속성은 비밀번호 모드에서 텍스트 입력 필드에 입력된 문자가 가려지지 않은 상태로 표시되는 시간을 밀리초 단위로 나타냅니다.

액세스 함수:

[read-only] setFocusOnTouchRelease : const bool

이 속성은 포커스 대상에 입력 포커스를 설정해야 하는 이벤트를 포함합니다.

터치/마우스 해제 후 포커스 대상(라인 에디트 등)이 입력 포커스를 받아야 하는 경우, 이 속성은 ` true `입니다. 이는 터치 플랫폼에서 일반적인 동작입니다. 데스크톱 플랫폼의 경우, 터치/마우스 누름 시점에 이미 포커스를 설정하는 것이 표준입니다.

액세스 함수:

[read-only] showIsFullScreen : const bool

이 속성은 플랫폼이 기본적으로 창을 전체 화면으로 표시하는지 여부를 나타냅니다.

플랫폼이 기본적으로 창을 전체 화면으로 표시하도록 설정된 경우 이 속성은 ` true `이며, 그렇지 않은 경우 ` false`입니다.

액세스 함수:

QWindow::show() 및 showIsMaximized()도 참조하십시오 .

[read-only] showIsMaximized : const bool

이 속성은 플랫폼이 기본적으로 창을 최대화 상태로 설정하는지 여부를 나타냅니다.

플랫폼이 기본적으로 창을 최대화하는 경우 이 속성은 ` true `이며, 그렇지 않은 경우 ` false`입니다.

액세스 함수:

QWindow::show() 및 showIsFullScreen()도 참조하십시오 .

showShortcutsInContextMenus : bool

true 플랫폼이 일반적으로 컨텍스트 메뉴에 단축키 조합을 표시하는 경우, 그렇지 않은 경우 false.

Qt 5.13부터는 setShowShortcutsInContextMenus() 함수를 사용하여 플랫폼의 기본 설정을 재정의할 수 있습니다.

액세스 함수:

Notifier 신호:

Qt::AA_DontShowShortcutsInContextMenus도 참조하십시오 .

[read-only] singleClickActivation : const bool

이 속성은 항목이 단 한번의 클릭으로 활성화되는지, 아니면 두 번 클릭해야 활성화되는지를 결정합니다.

항목을 단일 클릭으로 활성화하려면 이 속성의 값은 ` true `이며, 이중 클릭으로 활성화하려면 ` false `입니다.

액세스 함수:

[read-only] startDragDistance : int

이 속성은 드래그 앤 드롭 작업이 시작되기 전에 마우스 버튼을 누른 상태로 커서를 이동해야 하는 거리(픽셀 단위)를 나타냅니다.

애플리케이션에서 드래그 앤 드롭을 지원하며, 사용자가 버튼을 누른 상태로 커서를 일정 거리만큼 이동한 후에 드래그 앤 드롭 작업을 시작하고자 한다면, 이 속성의 값을 필요한 최소 거리로 사용해야 합니다.

예를 들어, 클릭 시 마우스 위치가 ` startPos `에 저장되어 있고 현재 위치(예: 마우스 이동 이벤트 내)가 ` currentPos`인 경우, 다음과 같은 코드를 사용하여 드래그를 시작해야 하는지 확인할 수 있습니다:

if ((startPos - currentPos).manhattanLength() >=
        QApplication::startDragDistance())
    startTheDrag();

액세스 함수:

Notifier 신호:

startDragTime, QPoint::manhattanLength() 및 드래그 앤 드롭항목도 참조하십시오 .

[read-only] startDragTime : int

이 속성은 드래그 앤 드롭 작업이 시작되기 전에 마우스 버튼을 누르고 있어야 하는 시간을 밀리초 단위로 지정합니다.

애플리케이션에서 드래그 앤 드롭을 지원하고, 사용자가 마우스 버튼을 일정 시간 동안 누르고 난 후에 드래그 앤 드롭 작업을 시작하려면 이 속성의 값을 지연 시간으로 사용해야 합니다.

액세스 함수:

Notifier 신호:

startDragDistance 및 드래그 앤 드롭항목도 참조하십시오.

[read-only] startDragVelocity : const int

이 속성은 드래그 앤 드롭 작업이 시작되기 위해 마우스 버튼을 누른 상태에서 마우스를 이동할 수 있는 최대 속도(초당 픽셀 단위)를 지정합니다. 값이 0이면 이러한 제한이 없음을 의미합니다.

액세스 함수:

startDragDistance 및 드래그 앤 드롭항목도 참조하십시오.

[read-only] tabFocusBehavior : Qt::TabFocusBehavior

이 속성은 탭 키를 누를 때의 포커스 동작을 제어합니다.

액세스 함수:

알림 신호:

[since 6.12] toolTipWakeUpDelay : std::chrono::milliseconds

이 속성은 툴팁이 표시되기까지의 지연 시간을 지정합니다.

이 열거형은 Qt 6.12에서 도입되었습니다.

액세스 함수:

Notifier 신호:

QWidget::toolTip 및 QtQuick.Controls::ToolTip::delay도 참조하십시오 .

[read-only, since 6.12] toolTipWakeUpDelayAsMSec : int

이 속성은 툴팁이 표시되기까지의 지연 시간(밀리초 단위)을 지정합니다.

이 열거형은 Qt 6.12에서 도입되었습니다.

액세스 함수:

Notifier 신호:

toolTipWakeUpDelay 및 QtQuick.Controls::ToolTip::delay도 참조하십시오 .

[read-only] touchDoubleTapDistance : const int

이 속성은 두 번의 연속된 탭 사이에서 손가락을 최대 몇 픽셀까지 이동시켜도 더블 탭으로 인식되는지 여부를 나타냅니다.

액세스 함수:

useHoverEffects : bool

이 속성은 UI 요소가 호버 효과를 사용할지 여부를 결정합니다.

UI 요소가 호버 효과를 사용해야 하는 경우 이 속성은 ` true `입니다. 이는 마우스 포인터가 있는 데스크톱 플랫폼에서의 표준 동작인 반면, 터치 플랫폼에서는 호버 이벤트 전달에 따른 부하를 피할 수 있습니다.

액세스 함수:

Notifier 신호:

[read-only] useRtlExtensions : const bool

이 속성은 글쓰기 방향을 나타냅니다.

이 속성은 오른쪽에서 왼쪽으로 쓰는 방향이 활성화된 경우 ` true `이며, 그렇지 않은 경우 ` false`입니다.

액세스 함수:

[read-only] wheelScrollLines : int

휠을 한 번 클릭할 때마다 기본적으로 스크롤되는 줄 수.

액세스 함수:

알림 신호: