QAccessibleTextInterface Class
QAccessibleTextInterface クラスは、テキスト処理のサポートを実装しています。詳細...
| Header: | #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 はテキストの長さに使用され、この関数のカスタム実装は、長さがオフセットとして渡されたかのように結果を返す必要があります。
本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
