QStyleHints Class

속성 문서

[since 6.5] colorScheme : Qt::ColorScheme

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

기본적으로 시스템의 기본 색 구성표(모양이라고도 함)를 따르며, 시스템 색 구성표가 변경되면(예: 해질녘 또는 새벽) 변경됩니다. 색 구성표를 명시적 값으로 설정하면 시스템 설정이 무시되고 시스템 색 구성표의 변경 사항이 무시됩니다. 그러나 이렇게 하면 시스템에 힌트가 되며 색 구성표 재정의는 모든 플랫폼에서 지원되지 않습니다.

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

이 속성이 변경되면 Qt는 시스템 팔레트를 읽고 기본 팔레트를 업데이트하지만 응용 프로그램에서 명시적으로 설정한 팔레트 항목은 덮어쓰지 않습니다. colorSchemeChange() 신호가 발생하면 이전 팔레트는 여전히 유효합니다.

애플리케이션별 색상은 현재 색 구성표를 고려하여 유효 색상표와 잘 작동하도록 선택해야 합니다. 유효 색상표가 변경될 때 애플리케이션별 색상을 업데이트하려면 PaletteChange 또는 ApplicationPaletteChange 이벤트를 처리하세요.

이 속성은 Qt 6.5에 도입되었습니다.

액세스 함수:

알림 신호:

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

[since 6.8] contextMenuTrigger : Qt::ContextMenuTrigger

마우스 이벤트를 사용하여 컨텍스트 메뉴 이벤트를 트리거합니다.

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

이 프로퍼티는 Qt 6.8에 도입되었습니다.

액세스 함수:

알림 신호:

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

[read-only] cursorFlashTime : const int

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

깜박임 시간은 캐럿 표시를 표시, 반전 및 복원하는 데 사용되는 시간입니다. 일반적으로 텍스트 커서는 커서 깜박임 시간의 절반 동안 표시된 후 같은 시간 동안 숨겨집니다.

기능에 액세스합니다:

알림 신호:

[read-only] fontSmoothingGamma : const qreal

이 프로퍼티에는 글꼴 평활화에 사용되는 감마 값이 저장됩니다.

액세스 함수:

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

이 속성은 키를 누르고 있는 경우 추가로 반복되는 키 누름이 자동으로 생성되는 비율을 초당 이벤트 단위로 저장합니다.

이 프로퍼티는 Qt 6.5에 도입되었습니다.

액세스 함수:

[read-only] keyboardInputInterval : const int

이 속성은 한 번의 키 누름과 두 번의 연속 키 누름을 구분하는 시간 제한(밀리초)을 저장합니다.

액세스 기능:

알림 신호:

[read-only] mouseDoubleClickDistance : const int

이 속성은 두 번의 연속 마우스 클릭 사이에 마우스를 이동하고도 더블 클릭으로 감지할 수 있는 최대 거리를 픽셀 단위로 저장합니다.

액세스 함수입니다:

[read-only] mouseDoubleClickInterval : const int

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

액세스 기능:

알림 신호:

[read-only] mousePressAndHoldInterval : const int

이 속성은 길게 누르기를 활성화하는 시간 제한을 밀리초 단위로 설정합니다.

기능에 액세스합니다:

알림 신호:

mouseQuickSelectionThreshold : const 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() 함수를 사용하여 플랫폼 기본값을 재정의할 수 있습니다.

함수에 액세스합니다:

알림 신호:

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

[read-only] singleClickActivation : const bool

이 속성은 항목이 한 번 클릭으로 활성화되는지 두 번 클릭으로 활성화되는지를 저장합니다.

항목이 한 번 클릭으로 활성화되어야 하는 경우 이 속성은 true, 두 번 클릭으로 활성화되어야 하는 경우 false 입니다.

액세스 기능:

[read-only] startDragDistance : const int

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

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

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

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

기능에 액세스합니다:

알림 신호:

startDragTime, QPoint::manhattanLength() 및 드래그 앤 드롭도참조하세요 .

[read-only] startDragTime : const int

이 속성은 끌어서 놓기 작업이 시작되기 전에 마우스 버튼을 누르고 있어야 하는 시간(밀리초)을 저장합니다.

애플리케이션에서 끌어서 놓기를 지원하고 사용자가 일정 시간 동안 마우스 버튼을 누른 후에 끌어서 놓기 작업을 시작하려는 경우 이 속성 값을 지연 시간으로 사용해야 합니다.

액세스 기능

알림 신호:

startDragDistance 및 드래그 앤 드롭을참조하세요 .

[read-only] startDragVelocity : const int

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

기능에 접근하기:

startDragDistance 및 드래그 앤 드롭을참조하세요 .

[read-only] tabFocusBehavior : const Qt::TabFocusBehavior

이 속성은 탭 키를 눌렀을 때 포커스 동작을 유지합니다.

함수에 액세스합니다:

알림 신호:

[read-only] touchDoubleTapDistance : const int

이 속성은 두 번의 연속 탭 사이에서 손가락을 움직이면서도 더블 탭으로 감지될 수 있는 최대 거리(픽셀)를 나타냅니다.

기능에 액세스합니다:

useHoverEffects : bool

이 프로퍼티는 UI 요소에 호버 효과를 사용할지 여부를 저장합니다.

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

액세스 기능:

알림 신호:

[read-only] useRtlExtensions : const bool

이 속성은 쓰기 방향을 저장합니다.

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

액세스 함수:

[read-only] wheelScrollLines : const int

휠을 클릭할 때마다 기본적으로 스크롤할 줄 수입니다.

액세스 기능:

알림 신호: