이 페이지에서

RadioButton QML Type

켜거나 끌 수 있는 배타적 라디오 버튼. 더 보기...

Import Statement: import QtQuick.Controls
Inherits:

AbstractButton

상세 설명

RadioButton은 켜기(선택) 또는 끄기(선택 해제)로 전환할 수 있는 옵션 버튼을 제공합니다. 라디오 버튼은 일반적으로 여러 옵션 중에서 하나의 옵션을 선택하는 데 사용됩니다.

RadioButton은 AbstractButton 에서 API를 상속받습니다. 예를 들어, text 을 설정하고 AbstractButton API를 사용하여 clicks 에 반응할 수 있습니다. 라디오 버튼의 상태는 checked 속성을 사용하여 설정할 수 있습니다.

라디오 버튼은 기본적으로 배타적( auto-exclusive )입니다. 동일한 부모 항목에 속한 라디오 버튼 중 한 번에 하나의 버튼만 선택할 수 있으며, 다른 버튼을 선택하면 이전에 선택된 버튼의 선택이 자동으로 해제됩니다. 공통 부모 항목이 없는 라디오 버튼의 경우, ButtonGroup 를 사용하여 배타성을 관리할 수 있습니다.

RadioDelegate 는 RadioButton과 유사하지만, 일반적으로 뷰에서 사용된다는 점이 다릅니다.

ColumnLayout {
    RadioButton {
        checked: true
        text: qsTr("First")
    }
    RadioButton {
        text: qsTr("Second")
    }
    RadioButton {
        text: qsTr("Third")
    }
}

ButtonGroup, Customizing RadioButton, Button Controls 및 RadioDelegate항목도 참조하십시오 .

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