Back to Qt.io
Contact Us Blog Download Qt

SwitchDelegate QML Type

켜거나 끌 수 있는 스위치 표시기가 있는 항목 델리게이트입니다. 더 보기...

Import Statement: import QtQuick.Controls
Inherits:

ItemDelegate

속성

상세 설명

스위치 델리게이트는 켜거나(체크) 끌 수 있는(체크 해제) 항목 델리게이트를 표시합니다. 스위치 델리게이트는 일반적으로 옵션 세트에서 하나 이상의 옵션을 선택하는 데 사용됩니다. 옵션 세트가 더 작거나 고유하게 식별할 수 있어야 하는 옵션의 경우 Switch 대신 사용하는 것이 좋습니다.

SwitchDelegate는 ItemDelegate 에서 API를 상속받으며, 이는 AbstractButton 에서 상속받습니다. 예를 들어 text 를 설정하고 AbstractButton API를 사용하여 clicks 에 반응할 수 있습니다. 스위치 델리게이트의 상태는 checked 프로퍼티로 설정할 수 있습니다.

ListView {
    model: ["Option 1", "Option 2", "Option 3"]
    delegate: SwitchDelegate {
        text: modelData
    }
}

스위치 델리게이트 및 델리게이트 컨트롤커스터마이징도참조하세요 .

프로퍼티 문서

position : real [read-only]

이 속성은 엄지 표시기의 논리적 위치를 저장합니다.

위치는 0.0 - 1.0 범위에서 표시기 크기의 일부분으로 표현됩니다. 이 위치는 예를 들어 엄지 손가락이 중간 지점을 지나 드래그되었는지 여부를 확인하는 데 사용할 수 있습니다. 엄지 손가락 표시기를 시각화하려면 오른쪽에서 왼쪽으로 인식되는 visualPosition 을 대신 사용해야 합니다.

visualPosition도 참조하세요 .


visualPosition : real [read-only]

이 속성은 엄지 표시기의 시각적 위치를 유지합니다.

위치는 0.0 - 1.0 범위에서 표시기 크기의 일부분으로 표시됩니다. 컨트롤이 mirrored 인 경우 값은 1.0 - position 과 같습니다. 이 값은 오른쪽에서 왼쪽 지원을 고려한 엄지 표시기를 시각화하는 데 적합합니다. 예를 들어 엄지 손가락이 중간 지점을 지나 드래그되었는지 여부를 확인하려면 논리적 position 을 대신 사용해야 합니다.

position 를참조하세요 .


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.