StyleReader QML Type

특정 컨트롤에 대한 활성 스타일에서 속성을 읽습니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• checked : bool
• controlType : enumeration
• enabled : bool
• focused : bool
• font : font
• global : ControlStyleProperties
• highlighted : bool
• hovered : bool
• palette : palette
• pressed : bool
• vertical : bool

자세한 설명

StyleReader는 컨트롤과 Qt Quick Controls 와 active style 사이의 다리 역할을 합니다. 컨트롤과 그 델리게이트가 바인딩해야 하는 모든 스타일 속성( backgrounds, indicators, handles, text, padding 등)을 노출합니다. 모든 내장된 StyleKit 컨트롤은 이 목적을 위해 내부적으로 스타일리더를 사용합니다.

상태 속성( hovered, pressed, focused, checked, highlighted 등)은 컨트롤이 어떤 상태인지 StyleReader에 알려줍니다. 이를 사용하여 Themes, StyleVariations, fallback types, 그리고 속성 전파를 고려하여 Style 에서 올바른 속성 값을 확인하고 읽습니다.

CustomControl 를 구현할 때는 기본 제공 컨트롤과 동일한 접근 방식을 따를 수 있습니다:

// Main.qml

component CustomButton : Rectangle {
    StyleReader {
        id: styleReader
        controlType: StyleReader.Button
        hovered: hoverHandler.hovered
        pressed: tapHandler.pressed
        palette: app.palette
    }

    implicitWidth: styleReader.background.implicitWidth
    implicitHeight: styleReader.background.implicitHeight
    color: styleReader.background.color
    radius: styleReader.background.radius

    HoverHandler { id: hoverHandler }
    TapHandler { id: tapHandler }

    Text {
        font: styleReader.font
        anchors.centerIn: parent
        text: "ok"
    }
}

CustomControl, Style, StyleVariation.controlType 를참조하세요 .

속성 문서

checked : bool

컨트롤이 선택되었는지 여부입니다.

이를 컨트롤의 checked 속성에 바인딩합니다.

기본값은 false 입니다.

ControlStateStyle.checked 를참조하세요 .

controlType : enumeration

이 리더가 속성을 읽을 Style 에서 어떤 제어 유형을 식별합니다. 아래 사전 정의된 값 중 하나로 설정하거나 Style 에 정의된 custom control type 로 설정할 수 있습니다.

StyleVariation.controlType 를참조하세요 .

enabled : bool

컨트롤이 활성화되었는지 여부입니다.

이 값을 컨트롤의 enabled 속성에 바인딩합니다.

기본값은 true 입니다.

ControlStyleState.disabled도 참조하십시오 .

focused : bool

컨트롤에 활성 초점이 있는지 여부입니다.

이를 컨트롤의 activeFocus 속성에 바인딩합니다.

기본값은 false 입니다.

ControlStateStyle.focused 를참조하세요 .

font : font [read-only]

style 에 정의된 대로 이 컨트롤 유형의 유효 글꼴입니다. 또한 스타일의 text 속성에 설정된 모든 글꼴 오버라이드도 고려합니다.

컨트롤의 font 속성을 이 속성에 바인딩합니다.

global : ControlStyleProperties [read-only]

진행 중인 transition 을 우회하여 스타일 속성에 직접 액세스할 수 있습니다.

상태 전환이 진행 중인 동안 StyleReader 에서 읽은 스타일 속성은 보간된 값을 반환할 수 있습니다. 속성 경로 앞에 global 을 추가하면 전환을 우회하고 즉시 최종 상태 값을 가져올 수 있습니다.

예를 들어 hovered 에서 pressed 으로 전환할 때 background.color 은 hovered 상태의 color 과 pressed 상태의 색상 사이의 보간된 값을 반환할 수 있습니다. global.background.color 반면에 , 는 눌린 상태의 색을 바로 반환합니다.

transitionsEnabled 를참조하세요 .

highlighted : bool

컨트롤이 강조 표시되는지 여부입니다.

이 값을 컨트롤의 highlighted 속성에 바인딩합니다.

기본값은 false 입니다.

ControlStateStyle.highlighted 를참조하세요 .

hovered : bool

컨트롤이 마우스오버되었는지 여부.

이 값을 컨트롤의 hovered 속성에 바인딩합니다.

기본값은 false 입니다.

ControlStateStyle.hovered 를참조하세요 .

palette : palette

StyleKit 은 이를 사용하여 Style 에서 palette 을 바인딩하는 색상 속성을 확인합니다.

이것을 컨트롤의 palette 속성에 바인딩합니다.

Style.palette 를참조하세요 .

pressed : bool

컨트롤을 눌렀는지 여부.

이를 컨트롤의 pressed 속성에 바인딩합니다.

기본값은 false 입니다.

ControlStateStyle.pressed 를참조하세요 .

vertical : bool

컨트롤의 방향이 세로인지 여부.

이를 컨트롤의 orientation 에 바인딩합니다.

기본값은 false 입니다.

ControlStateStyle.vertical 를참조하세요 .