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 のみで表現され、そのテキストを名前 (QAccessibleInterface::text() withQAccessible::Name as type) として返すべきである。QAccessibleTextInterfaceは、通常、スクリーン・リーダーが一行ずつ読みたいテキストや、テキストの選択と入力をサポートするウィジェットのためのものです。このインターフェースは、例えば、QLineEdit 。
メンバ関数ドキュメント
[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はテキストの長さに使用され、この関数のカスタム実装は、長さがオフセットとして渡されたかのように結果を返す必要があります。
© 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.