Accessible QML Type (Uncreatable)

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

참고: 이 타입은 생성할 수 없는 타입입니다. QML에서 인스턴스를 생성할 수 없습니다.

• 상속된 멤버를 포함한 모든 멤버 목록
• Accessible은 Accessibility 클래스의 일부입니다.

속성

• checkStateMixed : bool
• checkable : bool
• checked : bool
• defaultButton : bool
• description : string
• editable : bool
• expandable : bool (since 6.12)
• expanded : bool (since 6.12)
• focusable : bool
• focused : bool
• id : string
• ignored : bool
• labelFor : Item (since 6.10)
• labelledBy : Item (since 6.10)
• multiLine : bool
• name : string
• passwordEdit : bool
• pressed : bool
• readOnly : bool
• role : enumeration
• searchEdit : bool
• selectable : bool
• selectableText : bool
• selected : bool

신호

• decreaseAction()
• increaseAction()
• nextPageAction()
• pressAction()
• previousPageAction()
• scrollDownAction()
• scrollLeftAction()
• scrollRightAction()
• scrollUpAction()
• showOnScreenAction()
• toggleAction()

방법

• void announce(string message, AnnouncementPoliteness politeness) (since 6.8)

상세 설명

이 클래스는 ' Qt Quick 애플리케이션의 접근성'의 일부입니다.

사용자가 상호작용하거나 사용자에게 정보를 제공하는 항목은 해당 정보를 접근성 프레임워크에 공개해야 합니다. 그러면 보조 기술이 해당 정보를 활용하여 사용자가 다양한 방식으로 애플리케이션과 상호작용할 수 있게 됩니다. 이를 통해 예를 들어 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 는 가장 중요한 정보이며 버튼의 텍스트와 바인딩됩니다. 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`입니다.

expandable : bool [since 6.12]

이 속성은 해당 항목이 확장 가능한지 여부를 나타냅니다.

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

이 속성은 Qt 6.12에서 도입되었습니다.

expanded도 참조하십시오 .

expanded : bool [since 6.12]

이 속성은 해당 항목이 현재 펼쳐져 있는지 여부를 나타냅니다.

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

이 속성은 Qt 6.12에서 도입되었습니다.

expandable도 참조하십시오 .

focusable : bool

이 속성은 해당 항목에 포커스를 줄 수 있는지 여부를 나타냅니다.

기본적으로 이 속성은 ` false `이지만, 역할이 ` CheckBox`, ` RadioButton`, ` Switch`, ` Button`, ` MenuItem`, ` PageTab`, ` EditableText`, ` SpinBox`, ` ComboBox`, ` Terminal ` 또는 ` ScrollBar` 중 하나인 항목은 예외입니다.

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`입니다.

labelFor : Item [since 6.10]

이 속성은 이 항목이 라벨로 표시하는 항목을 저장합니다.

이 속성을 설정하면 다른 객체의 ' labelledBy ' 관계가 자동으로 설정됩니다.

기본적으로 이 속성의 값은 ` undefined`입니다.

이 속성은 Qt 6.10에서 도입되었습니다.

labelledBy : Item [since 6.10]

이 속성은 해당 항목의 레이블로 사용되는 항목을 포함합니다.

이 속성을 설정하면 다른 객체의 ‘ labelFor ’ 관계가 자동으로 설정됩니다.

기본적으로 이 속성의 값은 undefined 입니다.

이 속성은 Qt 6.10에서 도입되었습니다.

multiLine : bool

이 속성은 해당 항목에 여러 줄의 텍스트가 포함되어 있는지 여부를 나타냅니다.

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

name : string

이 속성은 접근 가능한 이름을 설정합니다. 예를 들어, 버튼의 경우 이 속성은 버튼의 텍스트와 바인딩되어야 합니다. 일반적으로 이 속성은 간단하고 간결하면서도 사람이 읽기 쉬운 이름으로 설정해야 합니다. 표현하려는 컨트롤의 유형은 포함하지 말고, 이름만 기재하십시오.

passwordEdit : bool

이 속성은 해당 항목이 비밀번호 텍스트 편집기인지 여부를 나타냅니다.

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

pressed : bool

이 속성은 해당 항목이 눌려져 있는지 여부를 나타냅니다(예: 마우스 클릭 시 버튼).

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

readOnly : bool

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

이 속성은 역할이 ' QAccessible::EditableText '이고 읽기 전용으로 설정된 경우에 적용됩니다. 기본적으로 이 속성의 값은 ' false'입니다.

role : enumeration

이 플래그는 위젯의 의미적 유형을 설정합니다. 예를 들어, 버튼의 유형은 “Button”입니다. 값은 다음 중 하나여야 합니다 QAccessible::Role.

일부 역할은 특별한 의미론을 가집니다. 예를 들어, 체크박스를 구현하려면 "checked" 속성이 필요합니다.

searchEdit : bool

이 속성은 해당 항목이 검색 쿼리의 입력 대상인지 여부를 나타냅니다. 이 속성은 편집 가능한 텍스트에만 영향을 미칩니다.

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

selectable : bool

이 속성은 해당 항목을 선택할 수 있는지 여부를 나타냅니다.

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

selected도 참조하십시오 .

selectableText : bool

이 속성은 해당 항목에 선택할 수 있는 텍스트가 포함되어 있는지 여부를 나타냅니다.

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

selected : bool

이 속성은 해당 항목이 선택되었는지 여부를 나타냅니다.

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

selectable도 참조하십시오 .

Signal 문서

decreaseAction()

이 신호는 스크린 리더와 같은 보조 도구로부터 축소 동작이 수신되었을 때 발생합니다.

increaseAction()

이 신호는 스크린 리더와 같은 보조 도구로부터 ‘증가’ 동작이 수신되었을 때 발생합니다.

nextPageAction()

이 신호는 스크린 리더와 같은 보조 기술 도구로부터 다음 페이지 이동 동작이 수신되었을 때 발생합니다.

pressAction()

이 신호는 스크린 리더와 같은 보조 도구로부터 누름 동작이 수신되었을 때 발생합니다.

previousPageAction()

이 신호는 스크린 리더와 같은 보조 도구로부터 이전 페이지 동작이 수신되었을 때 발생합니다.

scrollDownAction()

이 신호는 스크린 리더와 같은 보조 도구에서 스크롤 다운 동작이 감지되었을 때 발생합니다.

scrollLeftAction()

이 신호는 스크린 리더와 같은 보조 도구로부터 왼쪽 스크롤 동작이 수신되었을 때 발생합니다.

scrollRightAction()

이 신호는 스크린 리더와 같은 보조 도구로부터 오른쪽으로 스크롤하는 동작이 수신되었을 때 발생합니다.

scrollUpAction()

이 신호는 스크린 리더와 같은 보조 도구에서 위로 스크롤 동작이 감지되었을 때 발생합니다.

showOnScreenAction()

이 신호는 스크린 리더와 같은 보조 도구가 부분적으로만 보이는 요소를 감지하고, 해당 요소가 완전히 보이도록 요청할 때 발생합니다.

toggleAction()

이 신호는 스크린 리더와 같은 보조 도구로부터 토글 동작이 수신되었을 때 발생합니다.

메서드 문서

[since 6.8] void announce(string message, AnnouncementPoliteness politeness)

politeness 의 예의 수준이 적용된 message 를 포함한 알림 이벤트를 발생시킵니다.

이 메서드는 Qt 6.8에서 도입되었습니다.

QAccessibleAnnouncementEvent도 참조하십시오 .