QAccessibleInterface Class

멤버 함수 문서

[virtual noexcept protected] QAccessibleInterface::~QAccessibleInterface()

QAccessibleInterface 를 파괴합니다.

QAccessibleActionInterface *QAccessibleInterface::actionInterface()

[virtual] QColor QAccessibleInterface::backgroundColor() const

해당되는 경우 접근 가능성의 배경색을 반환하거나 잘못된 QColor 을 반환합니다.

foregroundColor()도 참조하세요 .

[pure virtual] QAccessibleInterface *QAccessibleInterface::child(int index) const

인덱스가 index 로 접근 가능한 자식을 반환합니다. 0 기반 인덱스를 반환합니다. 객체의 자식 수는 childCount 으로 확인할 수 있습니다.

유효하지 않은 자식을 요청하는 경우(예: 그 사이에 자식이 유효하지 않게 된 경우) nullptr 를 반환합니다.

childCount() 및 parent()도 참조하세요 .

[pure virtual] QAccessibleInterface *QAccessibleInterface::childAt(int x, int y) const

화면 좌표(x, y)를 포함하는 자식의 QAccessibleInterface 을 반환합니다. 이 위치에 자식이 없는 경우 이 함수는 nullptr 을 반환합니다. 반환되는 접근 가능 객체는 자식이어야 하지만 반드시 직접 자식일 필요는 없습니다.

이 함수는 보이는 객체에 대해서만 신뢰할 수 있습니다(보이지 않는 객체는 올바르게 배치되지 않을 수 있음).

모든 시각적 객체는 이 정보를 제공합니다.

QAccessibleObject 을 상속하는 객체에 대한 기본 구현이 제공됩니다. 이 함수는 모든 자식에 대해 반복됩니다. 위젯이 자식(예: 테이블)을 관리하는 경우 특수 구현을 작성하는 것이 더 효율적입니다.

rect()도 참조하세요 .

[pure virtual] int QAccessibleInterface::childCount() const

이 객체에 속하는 자식 수를 반환합니다. 자식은 자체적으로 접근성 정보를 제공하거나(예: 자식 위젯) 이 접근성 객체의 하위 요소일 수 있습니다.

모든 객체는 이 정보를 제공합니다.

indexOfChild()도 참조하세요 .

[virtual] QAccessibleInterface *QAccessibleInterface::focusChild() const

키보드 포커스가 있는 개체를 반환합니다.

반환되는 객체는 자신을 포함한 모든 하위 객체가 될 수 있습니다.

[virtual] QColor QAccessibleInterface::foregroundColor() const

해당되는 경우 접근 가능한 전경색을 반환하거나 잘못된 QColor 을 반환합니다.

backgroundColor()도 참조하세요 .

[pure virtual] int QAccessibleInterface::indexOfChild(const QAccessibleInterface *child) const

이 객체의 자식 목록에 있는 child 객체의 0 기반 인덱스를 반환하거나 child 이 객체의 자식이 아닌 경우 -1을 반환합니다.

모든 객체는 자식에 대한 이 정보를 제공합니다.

childCount()도 참조하세요 .

[virtual] void *QAccessibleInterface::interface_cast(QAccessible::InterfaceType type)

일반 QAccessibleInterface 에서 특수 접근성 인터페이스 type 를 반환합니다.

이 함수는 특수 인터페이스를 통해 위젯이나 객체에 대한 자세한 정보를 제공할 때 다시 구현해야 합니다. 예를 들어 줄 편집은 QAccessibleTextInterface 을 구현해야 합니다.

QAccessible::InterfaceType, QAccessibleTextInterface, QAccessibleValueInterface, QAccessibleActionInterface, QAccessibleTableInterface, QAccessibleTableCellInterface 를참조하세요 .

[pure virtual] bool QAccessibleInterface::isValid() const

이 인터페이스 구현을 사용하는 데 필요한 모든 데이터가 유효하면 true 을 반환하고(예: 모든 포인터가 널이 아닌 경우), 그렇지 않으면 false 을 반환합니다.

object()도 참조하세요 .

[pure virtual] QObject *QAccessibleInterface::object() const

이 인터페이스 구현이 정보를 제공하는 QObject 에 대한 포인터를 반환합니다.

isValid()도 참조하세요 .

[pure virtual] QAccessibleInterface *QAccessibleInterface::parent() const

접근 가능한 객체 계층 구조에서 상위의 QAccessibleInterface 을 반환합니다.

부모가 존재하지 않는 경우(예: 최상위 애플리케이션 객체의 경우) nullptr 을 반환합니다.

child()도 참조하세요 .

[pure virtual] QRect QAccessibleInterface::rect() const

개체의 지오메트리를 반환합니다. 지오메트리는 화면 좌표입니다.

이 함수는 보이는 객체에 대해서만 신뢰할 수 있습니다(보이지 않는 객체는 올바르게 배치되지 않을 수 있음).

모든 시각적 객체는 이 정보를 제공합니다.

childAt()도 참조하세요 .

[virtual] QList<QPair<QAccessibleInterface *, QAccessible::Relation>> QAccessibleInterface::relations(QAccessible::Relation match = QAccessible::AllRelations) const

다른 위젯과의 의미 있는 관계를 반환합니다. 일반적으로 트리 보기와 같은 특정 방식으로 처리되지 않는 한 부모/자식 관계는 반환하지 않습니다. 일반적으로 레이블 기준 및 레이블 관계를 반환합니다.

선택적 매개 변수 match 를 사용하여 관계를 필터링할 수 있습니다. 이 함수는 절대로 자체적으로 반환해서는 안 됩니다.

parent() 및 child()도 참조하세요 .

[pure virtual] QAccessible::Role QAccessibleInterface::role() const

객체의 역할을 반환합니다. 객체의 역할은 일반적으로 정적입니다.

액세스 가능한 모든 객체에는 역할이 있습니다.

text() 및 state()도 참조하세요 .

[since 6.5] QAccessibleSelectionInterface *QAccessibleInterface::selectionInterface()

이 기능은 Qt 6.5에 도입되었습니다.

[pure virtual] void QAccessibleInterface::setText(QAccessible::Text t, const QString &text)

개체의 텍스트 속성 t 을 text 으로 설정합니다.

대부분의 개체의 텍스트 속성은 읽기 전용이므로 이 함수를 호출해도 효과가 없을 수 있습니다.

text()도 참조하세요 .

[pure virtual] QAccessible::State QAccessibleInterface::state() const

객체의 현재 상태를 반환합니다. 반환되는 값은 QAccessible::StateFlag 열거형에 있는 플래그의 조합입니다.

접근 가능한 모든 객체에는 상태가 있습니다.

text() 및 role()도 참조하세요 .

QAccessibleTableCellInterface *QAccessibleInterface::tableCellInterface()

QAccessibleTableInterface *QAccessibleInterface::tableInterface()

[pure virtual] QString QAccessibleInterface::text(QAccessible::Text t) const

객체의 텍스트 속성 t 값을 반환합니다.

QAccessible::Name 은 클라이언트가 사용자가 액세스할 수 있는 객체를 식별, 검색 또는 알리기 위해 사용하는 문자열입니다. 모든 객체는 컨테이너 내에서 고유한 이름을 가져야 합니다. 이름은 클라이언트에 따라 다르게 사용될 수 있으므로 이름은 개체에 대한 간단한 설명을 제공하면서 고유해야 합니다.

접근 가능한 개체의 QAccessible::Description 는 개체의 시각적 모양에 대한 텍스트 정보를 제공합니다. 설명은 주로 시각 장애가 있는 사용자에게 더 많은 컨텍스트를 제공하기 위해 사용되지만 컨텍스트 검색이나 다른 애플리케이션에도 사용됩니다. 모든 객체에 설명이 있는 것은 아닙니다. '확인' 버튼에는 설명이 필요하지 않지만 스마일 그림을 표시하는 도구 버튼에는 설명이 필요합니다.

접근 가능한 개체의 QAccessible::Value 는 해당 개체에 포함된 시각적 정보(예: 줄 편집의 텍스트)를 나타냅니다. 일반적으로 이 값은 사용자가 수정할 수 있습니다. 정적 텍스트 레이블처럼 모든 개체에 값이 있는 것은 아니며, 토글 버튼처럼 이미 값이 있는 상태인 개체도 있습니다.

QAccessible::Help 텍스트는 접근 가능한 개체의 기능 및 사용법에 대한 정보를 제공합니다. 모든 객체가 이 정보를 제공하는 것은 아닙니다.

QAccessible::Accelerator 은 개체의 기본 동작을 활성화하는 키보드 단축키입니다. 키보드 단축키는 메뉴, 메뉴 항목 또는 위젯의 텍스트에 밑줄이 그어진 문자로, 문자 자체 또는 이 문자와 Alt, Ctrl 또는 Shift와 같은 수정자 키의 조합입니다. 도구 버튼과 같은 명령 컨트롤에도 단축키가 있으며 일반적으로 도구 설명에 단축키가 표시됩니다.

QAccessible::Identifier 을 명시적으로 설정하여 보조 기술에 ID를 제공할 수 있습니다. 이는 UI 테스트에 특히 유용할 수 있습니다. 식별자가 명시적으로 설정되지 않은 경우 해당 인터페이스에서 QObject::objectName 또는 해당 클래스 이름과 QObject::objectName 또는 부모 체인에 있는 부모의 클래스 이름을 기반으로 한 ID로 식별자가 설정됩니다.

모든 객체는 QAccessible::Name 에 대한 문자열을 제공합니다.

setText(), role() 및 state()도 참조하세요 .

QAccessibleTextInterface *QAccessibleInterface::textInterface()

QAccessibleValueInterface *QAccessibleInterface::valueInterface()

[virtual] QWindow *QAccessibleInterface::window() const

기본 객체와 연관된 창을 반환합니다. 예를 들어 QAccessibleWidget 은 이를 재구현하여 QWidget 의 windowHandle() 을 반환합니다.

일부 플랫폼에서는 상태 변경에 대해 AT 클라이언트에 알리기 위해 사용됩니다. 백엔드는 창을 찾을 때까지 모든 조상을 거슬러 올라갑니다. (즉, 조상 중 하나 이상의 인터페이스가 유효한 QWindow 포인터를 반환해야 합니다).

기본 구현은 nullptr 을 반환합니다.