このページでは

QAccessibleTextInterface Class

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

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

パブリック関数

QAccessibleTextInterface()
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 のみによって表され、そのテキストを name として返す必要があります(QAccessibleInterface::text() を呼び出し、type にはQAccessible::Name を指定します)。 QAccessibleTextInterfaceは、通常、スクリーンリーダーが行単位で読み上げる可能性のあるテキストや、テキストの選択や入力をサポートするウィジェットを対象としています。このインターフェースは、例えばQLineEdit で実装されています。

IAccessible2 仕様

メンバ関数のドキュメント

[constexpr noexcept default] QAccessibleTextInterface::QAccessibleTextInterface()

QAccessibleTextInterface のインスタンスをデフォルトコンストラクタで生成します。

[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 にあるテキスト属性を返します。さらに、属性の範囲がstartOffset およびendOffset で返されます。

[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)

startIndex とendIndex の間のテキストが確実に表示されるようにします。

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

選択範囲を返します。選択範囲のサイズは、startOffset およびendOffset に返されます。選択範囲がない場合、startOffset およびendOffset はどちらも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)

selectionIndex の選択範囲を、startOffset から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 ` 型のテキスト項目を返し、`startOffset ` および `endOffset ` の値をその項目の開始位置と終了位置に設定します。該当する項目が存在しない場合は、空の文字列を返します。エラーが発生した場合は、`startOffset ` および `endOffset ` の値を -1 に設定します。

このデフォルトの実装は、小規模なテキスト編集のために提供されています。ワープロやテキストエディタでは、独自の効率的な実装を用意すべきです。この関数は、段落と行を区別しません。

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

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

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

このデフォルトの実装は、小規模なテキスト編集のために提供されています。ワープロやテキストエディタでは、独自の効率的な実装を用意すべきです。この関数は、段落と行の区別を行いません。

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

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

オフセット `offset ` に近い `boundaryType ` 型のテキスト項目を返し、`startOffset ` および `endOffset ` の値をその項目の開始位置と終了位置に設定します。該当する項目がない場合は空の文字列を返します。エラーが発生した場合は、`startOffset ` および `endOffset ` の値を -1 に設定します。

このデフォルトの実装は、小規模なテキスト編集のために提供されています。ワードプロセッサやテキストエディタでは、それぞれ独自の効率的な実装を用意すべきです。この関数は、段落と行の区別を行いません。

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

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