QAccessibleTextInterface Class

QAccessibleTextInterface クラスは、テキスト処理のサポートを実装しています。詳細...

ヘッダー #include <QAccessibleTextInterface>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

パブリック関数

virtual ~QAccessibleTextInterface()
virtual void addSelection(int startOffset, int endOffset) = 0
virtual QString attributes(int offset, int *startOffset, int *endOffset) const = 0
virtual int characterCount() const = 0
virtual QRect characterRect(int offset) const = 0
virtual int cursorPosition() const = 0
virtual int offsetAtPoint(const QPoint &point) const = 0
virtual void removeSelection(int selectionIndex) = 0
virtual void scrollToSubstring(int startIndex, int endIndex) = 0
virtual void selection(int selectionIndex, int *startOffset, int *endOffset) const = 0
virtual int selectionCount() const = 0
virtual void setCursorPosition(int position) = 0
virtual void setSelection(int selectionIndex, int startOffset, int endOffset) = 0
virtual QString text(int startOffset, int endOffset) const = 0
virtual QString textAfterOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
virtual QString textAtOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
virtual QString textBeforeOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const

詳細説明

このインターフェイスは IAccessibleText インターフェイスに対応する。プレーンなラベルよりも多くのテキストを表示するウィジェットのために実装されるべきである。ラベルはQAccessibleInterface のみで表現され、そのテキストを名前 (QAccessibleInterface::text() withQAccessible::Name as type) として返すべきである。QAccessibleTextInterfaceは、通常、スクリーン・リーダーが一行ずつ読みたいテキストや、テキストの選択と入力をサポートするウィジェットのためのものです。このインターフェースは、例えば、QLineEdit

IAccessible2 仕様書

メンバ関数ドキュメント

[virtual noexcept] QAccessibleTextInterface::~QAccessibleTextInterface()

QAccessibleTextInterface を破壊する。

[pure virtual] void QAccessibleTextInterface::addSelection(int startOffset, int endOffset)

startOffset からendOffset までのテキストを選択します。startOffset は選択される最初の文字です。endOffset は選択されない最初の文字です。

オブジェクトが複数選択をサポートしている場合(ワープロなど)、これは新しい選択を追加し、そうでない場合は前の選択を置き換えます。

選択範囲はendOffset -startOffset 文字の長さになります。

[pure virtual] QString QAccessibleTextInterface::attributes(int offset, int *startOffset, int *endOffset) const

offset の位置にあるテキスト属性を返す。さらに、startOffsetendOffset で属性の範囲が返されます。

[pure virtual] int QAccessibleTextInterface::characterCount() const

テキストの長さ (スペースを含む合計サイズ) を返します。

[pure virtual] QRect QAccessibleTextInterface::characterRect(int offset) const

offset の位置にある文字の位置と大きさをスクリーン座標で返す。

[pure virtual] int QAccessibleTextInterface::cursorPosition() const

現在のカーソル位置を返す。

setCursorPosition()も参照

[pure virtual] int QAccessibleTextInterface::offsetAtPoint(const QPoint &point) const

point における文字のオフセットをスクリーン座標で返す。

[pure virtual] void QAccessibleTextInterface::removeSelection(int selectionIndex)

インデックスselectionIndex で選択範囲をクリアする。

[pure virtual] void QAccessibleTextInterface::scrollToSubstring(int startIndex, int endIndex)

startIndexendIndex の間のテキストが見えるようにする。

[pure virtual] void QAccessibleTextInterface::selection(int selectionIndex, int *startOffset, int *endOffset) const

選択範囲を返す。選択範囲のサイズはstartOffsetendOffset で返されます。 選択範囲がない場合はstartOffsetendOffset の両方がnullptr となります。

アクセシビリティAPIは複数の選択をサポートします。しかし、ほとんどのウィジェットでは、selectionIndex が 0 の場合、1つの選択のみがサポートされます。

setSelection()も参照してください

[pure virtual] int QAccessibleTextInterface::selectionCount() const

このテキスト内の選択範囲の数を返します。

[pure virtual] void QAccessibleTextInterface::setCursorPosition(int position)

カーソルをposition に移動する。

cursorPosition()も参照のこと

[pure virtual] void QAccessibleTextInterface::setSelection(int selectionIndex, int startOffset, int endOffset)

選択範囲selectionIndexstartOffset からendOffset の範囲に設定する。

selection()、addSelection()、removeSelection()も参照のこと

[pure virtual] QString QAccessibleTextInterface::text(int startOffset, int endOffset) const

startOffset からendOffset までのテキストを返します。startOffset は返される最初の文字です。endOffset は、返されない最初の文字です。

[virtual] QString QAccessibleTextInterface::textAfterOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const

オフセットoffset の直後にあるboundaryType 型のテキスト項目を返し、startOffsetendOffset の値をその項目の開始位置と終了位置に設定する。そのような項目がない場合は空文字列を返す。エラー時にはstartOffsetendOffset の値を -1 に設定します。

このデフォルトの実装は、小さなテキスト編集のために提供されています。ワードプロセッサやテキストエディタは、独自の効率的な実装を提供する必要があります。この関数は、段落と行を区別しません。

注意: この関数はカーソル位置を考慮することはできない。慣習上、offset -2は、この関数がカーソル位置をオフセットとして使用することを意味する。したがって、-2のオフセットは、この関数を呼び出す前にカーソル位置に変換されなければならない。オフセット-1はテキストの長さに使用され、この関数のカスタム実装は、長さがオフセットとして渡されたかのように結果を返す必要があります。

[virtual] QString QAccessibleTextInterface::textAtOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const

オフセットoffset にあるboundaryType 型のテキスト項目を返し、startOffsetendOffset の値をその項目の開始位置と終了位置に設定する。そのような項目がない場合は空文字列を返す。エラーの場合はstartOffsetendOffset の値を -1 に設定します。

このデフォルトの実装は、小さなテキスト編集のために提供されています。ワードプロセッサやテキストエディタは、独自の効率的な実装を提供する必要があります。この関数は、段落と行を区別しません。

注意: この関数はカーソル位置を考慮することはできない。慣習上、offset -2 は、この関数がカーソル位置をオフセットとして使用することを意味する。したがって、-2のオフセットは、この関数を呼び出す前にカーソル位置に変換されなければならない。オフセット-1はテキストの長さに使用され、この関数のカスタム実装は、長さがオフセットとして渡されたかのように結果を返す必要があります。

[virtual] QString QAccessibleTextInterface::textBeforeOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const

オフセットoffset に近いboundaryType 型のテキスト項目を返し、startOffsetendOffset の値をその項目の開始位置と終了位置に設定する。そのような項目がない場合は空文字列を返す。エラー時にはstartOffsetendOffset の値を -1 に設定します。

このデフォルトの実装は、小さなテキスト編集のために提供されています。ワードプロセッサやテキストエディタは、独自の効率的な実装を提供する必要があります。この関数は、段落と行を区別しません。

注意: この関数はカーソル位置を考慮することはできない。慣習上、offset -2は、この関数がカーソル位置をオフセットとして使用することを意味する。したがって、-2のオフセットは、この関数を呼び出す前にカーソル位置に変換されなければならない。オフセット-1はテキストの長さに使用され、この関数のカスタム実装は、長さがオフセットとして渡されたかのように結果を返す必要があります。

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