Accessible QML Type

QML 항목의 접근성을 활성화합니다. 더 보기...

Import Statement: import QtQuick

상속된 멤버를 포함한 모든 멤버 목록
접근 가능은 접근성 클래스의 일부입니다.

속성

checkStateMixed : bool
checkable : bool
checked : bool
defaultButton : bool
description : string
editable : bool
focusable : bool
focused : bool
id : string
ignored : bool
multiLine : bool
name : string
passwordEdit : bool
pressed : bool
readOnly : bool
role : enumeration
searchEdit : bool
selectable : bool
selectableText : bool
selected : bool

신호

자세한 설명

사용자가 상호 작용하거나 사용자에게 정보를 제공하는 항목은 접근성 프레임워크에 해당 정보를 노출해야 합니다. 그러면 보조 도구가 해당 정보를 사용하여 사용자가 애플리케이션과 다양한 방식으로 상호 작용할 수 있습니다. 예를 들어 Qt Quick 애플리케이션을 화면 리더와 함께 사용할 수 있습니다.

가장 중요한 속성은 name, description 및 role 입니다.

간단한 버튼의 구현 예시:

Rectangle {
    id: myButton
    Text {
        id: label
        text: "next"
    }
    Accessible.role: Accessible.Button
    Accessible.name: label.text
    Accessible.description: "shows the next page"
    Accessible.onPressAction: {
        // do a button click
    }
}

role 은 Button 으로 설정되어 컨트롤 유형을 나타냅니다. name 은 가장 중요한 정보이며 버튼의 텍스트에 바인딩됩니다. 이름은 컨트롤에 대한 짧고 간결한 설명이며 시각적 레이블을 반영해야 합니다. 이 경우 이름만으로는 버튼이 무엇을 하는지 명확하지 않으므로 description 에 설명이 포함되어 있습니다. 또한 보조 도구에서 버튼을 트리거하기 위해 호출할 수 있는 신호 처리기( Accessible.pressAction )도 있습니다. 이 신호 처리기는 버튼을 탭하거나 클릭하는 것과 동일한 효과를 가져야 합니다.

접근성을참조하세요 .

속성 문서

checkStateMixed : bool

이 속성은 이 항목이 부분적으로 체크된 상태인지 여부를 저장합니다.

기본적으로 이 속성은 false 입니다.

checked 및 checkable 을참조하세요 .

checkable : bool

이 속성은 이 항목이 체크 박스 또는 일부 버튼과 같이 체크할 수 있는지 여부를 저장합니다.

기본적으로 이 속성은 false 입니다.

checked도 참조하세요 .

checked : bool

이 속성은 이 항목이 현재 선택되어 있는지 여부를 저장합니다.

기본적으로 이 속성은 false 입니다.

checkable도 참조하세요 .

defaultButton : bool

이 속성은 이 항목이 대화 상자의 기본 버튼인지 여부를 저장합니다.

기본적으로 이 속성은 false 입니다.

description : string

이 속성은 접근 가능한 설명을 설정합니다. 이름과 마찬가지로 항목을 설명합니다. 설명은 좀 더 장황할 수 있으며 항목의 기능(예: 설명하는 버튼의 기능)을 알려줄 수 있습니다.

editable : bool

이 속성은 이 항목에 편집 가능한 텍스트가 있는지 여부를 보유합니다.

기본적으로 이 속성은 false 입니다.

focusable : bool

이 속성은 이 항목에 초점을 맞출 수 있는지 여부를 저장합니다.

기본적으로 이 속성은 CheckBox, RadioButton, Button, MenuItem, PageTab, EditableText, SpinBox, ComboBox, Terminal 또는 ScrollBar 중 하나의 역할이 있는 항목을 제외하고는 false 입니다.

focused도 참조하세요 .

focused : bool

이 속성은 이 항목이 현재 활성 포커스를 가지고 있는지 여부를 보유합니다.

기본적으로 이 속성은 false 이지만 QQuickItem::hasActiveFocus()가 true 을 반환하는 항목의 경우 true 을 반환합니다.

focusable도 참조하세요 .

id : string

이 속성은 객체의 식별자를 설정합니다. UI 테스트에 안정적인 식별자를 제공하는 데 사용할 수 있습니다. 기본적으로 식별자는 QML 객체의 ID로 설정됩니다. ID가 설정되지 않은 경우 기본값인 QAccessible::Identifier 이 사용됩니다.

ignored : bool

이 속성은 접근성 프레임워크에서 이 항목을 무시할지 여부를 보유합니다.

때로는 항목이 하나의 항목으로 취급되어야 하는 항목 그룹의 일부인 경우가 있습니다. 예를 들어 두 개의 레이블이 시각적으로 나란히 배치되어 있지만 별도의 항목일 수 있습니다. 접근성 목적상 이 두 항목은 하나의 항목으로 취급되어야 하므로 올바른 형상을 가진 세 번째 보이지 않는 항목으로 표시됩니다.

예를 들어 속도 표시에는 "m/s"를 더 작은 레이블로 추가합니다:

Row {
    Label {
        id: speedLabel
        text: "Speed: 5"
        Accessible.ignored: true
    }
    Label {
        text: qsTr("m/s")
        Accessible.ignored: true
    }
    Accessible.role: Accessible.StaticText
    Accessible.name: speedLabel.text + " meters per second"
}

기본적으로 이 속성은 false 입니다.

multiLine : bool

이 속성은 이 항목에 여러 텍스트 줄이 있는지 여부를 보유합니다.

기본적으로 이 속성은 false 입니다.

name : string

이 속성은 접근 가능한 이름을 설정합니다. 예를 들어 버튼의 경우 텍스트에 바인딩이 있어야 합니다. 일반적으로 이 속성은 간단하고 간결하지만 사람이 읽을 수 있는 이름으로 설정해야 합니다. 표현하려는 컨트롤의 유형은 포함하지 말고 이름만 포함하세요.

passwordEdit : bool

이 속성은 이 항목이 비밀번호 텍스트 편집인지 여부를 보유합니다.

기본적으로 이 속성은 false 입니다.

pressed : bool

이 속성은 이 항목이 눌렀는지 여부(예: 마우스 클릭 중 버튼)를 보유합니다.

기본적으로 이 속성은 false 입니다.

readOnly : bool

이 속성은 텍스트 필드가 읽기 전용임을 나타냅니다.

이 속성은 역할이 QAccessible::EditableText 이고 읽기 전용으로 설정된 경우와 관련이 있습니다. 기본적으로 이 속성은 false 입니다.

role : enumeration

이 플래그는 위젯의 시맨틱 유형을 설정합니다. 예를 들어 버튼의 유형은 "Button"입니다. 값은 QAccessible::Role 중 하나여야 합니다.

일부 역할에는 특별한 시맨틱이 있습니다. 예를 들어 체크 박스를 구현하려면 "체크됨" 속성이 필요합니다.

역할	속성 및 신호	설명
모든 인터랙티브 요소	focusable 과 focused	사용자가 상호 작용할 수 있는 모든 요소는 포커스 가능을 `true` 으로 설정하고 `focus` 을 `true` 으로 설정해야 합니다. 화면 리더는 항목 간에 이동할 수 있는 가상 포커스를 구현하는 경우가 많으므로 이는 터치 전용 장치에서 실행되는 애플리케이션에서도 중요합니다.
버튼, CheckBox, RadioButton	Accessible.pressAction	버튼에는 `onPressAction` 이라는 이름의 신호 핸들러가 있어야 합니다. 이 신호는 화면 리더와 같은 보조 도구에서 방출될 수 있습니다. 구현은 마우스 클릭 또는 버튼 탭과 동일하게 동작해야 합니다.
CheckBox, RadioButton	checkable, checked, Accessible.toggleAction	확인란의 선택 상태입니다. 누르기, 선택 및 선택 취소 동작에 대해 업데이트되었습니다.
슬라이더, SpinBox, 다이얼, ScrollBar	`value`, `minimumValue`, `maximumValue`, `stepSize`	이러한 속성은 요소의 상태와 가능한 값을 반영합니다.
슬라이더, SpinBox, 다이얼, ScrollBar	Accessible.increaseAction, Accessible.decreaseAction	요소의 값을 늘리거나 줄이는 동작입니다.

searchEdit : bool

이 속성은 이 항목이 검색 쿼리에 대한 입력인지 여부를 보유합니다. 이 속성은 편집 가능한 텍스트에만 영향을 줍니다.

기본적으로 이 속성은 false 입니다.

selectable : bool

이 속성은 이 항목을 선택할 수 있는지 여부를 저장합니다.

기본적으로 이 속성은 false 입니다.

selected 를참조하세요 .

selectableText : bool

이 속성은 이 항목에 선택 가능한 텍스트가 포함되어 있는지 여부를 저장합니다.

기본적으로 이 속성은 false 입니다.

selected : bool

이 속성은 이 항목이 선택되었는지 여부를 보유합니다.

기본적으로 이 속성은 false 입니다.

selectable도 참조 하세요.

신호 문서

decreaseAction()

이 신호는 화면 리더와 같은 보조 도구에서 감소 동작이 수신될 때 발생합니다.

참고: 해당 핸들러는 onDecreaseAction 입니다.

increaseAction()

이 신호는 화면 리더와 같은 보조 도구에서 증가 동작이 수신될 때 발생합니다.

참고: 해당 핸들러는 onIncreaseAction 입니다.

nextPageAction()

이 신호는 화면 리더와 같은 보조 도구에서 다음 페이지 동작이 수신될 때 발생합니다.

참고: 해당 핸들러는 onNextPageAction 입니다.

pressAction()

이 신호는 화면 리더와 같은 보조 도구에서 누르기 동작이 수신될 때 발생합니다.

참고: 해당 핸들러는 onPressAction 입니다.

previousPageAction()

이 신호는 화면 리더와 같은 보조 도구에서 이전 페이지 동작이 수신될 때 발생합니다.

참고: 해당 핸들러는 onPreviousPageAction 입니다.

scrollDownAction()

이 신호는 화면 리더와 같은 보조 도구에서 아래로 스크롤 동작이 수신될 때 발생합니다.

참고: 해당 핸들러는 onScrollDownAction 입니다.

scrollLeftAction()

이 신호는 화면 리더와 같은 보조 도구에서 스크롤 왼쪽 동작이 수신될 때 발생합니다.

참고: 해당 핸들러는 onScrollLeftAction 입니다.

scrollRightAction()

이 신호는 화면 리더와 같은 보조 도구에서 오른쪽으로 스크롤 동작이 수신될 때 발생합니다.

참고: 해당 핸들러는 onScrollRightAction 입니다.

scrollUpAction()

이 신호는 화면 리더와 같은 보조 도구에서 스크롤 위로 동작이 수신될 때 발생합니다.

참고: 해당 핸들러는 onScrollUpAction 입니다.

toggleAction()

이 신호는 화면 리더와 같은 보조 도구에서 토글 동작이 수신될 때 발생합니다.

참고: 해당 핸들러는 onToggleAction 입니다.

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