이 페이지에서

SwitchDelegate QML Type

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

Import Statement: import QtQuick.Controls
Inherits:

ItemDelegate

속성

상세 설명

SwitchDelegate는 켜기(선택) 또는 끄기(선택 해제)로 전환할 수 있는 항목 델리게이트를 제공합니다. Switch 델리게이트는 일반적으로 일련의 옵션 중에서 하나 이상의 옵션을 선택하는 데 사용됩니다. 옵션의 수가 적거나, 각 옵션을 고유하게 식별해야 하는 경우에는 대신 Switch 를 사용하는 것을 고려해 보십시오.

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

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

'SwitchDelegate 및 Delegate 컨트롤사용자 지정' 항목도 참조하십시오 .

속성 설명서

position : real [read-only]

이 속성은 썸 인디케이터의 논리적 위치를 나타냅니다.

이 위치는 표시기의 크기에 대한 비율로 표현되며, 범위는 0.0 - 1.0 입니다. 이 위치는 예를 들어 썸이 중간 지점을 넘어 드래그되었는지 여부를 판단하는 데 사용할 수 있습니다. 썸 표시기를 시각화하려면, 대신 오른쪽에서 왼쪽으로의 방향성을 지원하는 visualPosition 를 사용해야 합니다.

visualPosition도 참조하십시오 .

visualPosition : real [read-only]

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

이 위치는 인디케이터 크기의 비율로 표현되며, 범위는 0.0 - 1.0 입니다. 컨트롤이 mirrored 상태일 때, 이 값은 1.0 - position 과 같습니다. 이를 통해 오른쪽에서 왼쪽으로 읽는 환경을 고려하여 썸 인디케이터를 시각화하는 데 이 값을 적절히 활용할 수 있습니다. 예를 들어, 썸이 중간 지점을 넘어 드래그되었는지 여부를 판단하려면, 대신 논리형 position 를 사용해야 합니다.

position도 참조하십시오 .

© 2026 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.