QAccessibleTextInterface class implements support for text handling. 更多...
| 头： | #include <QAccessibleTextInterface> |
| 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 |
QAccessibleTextInterface class implements support for text handling.
This interface corresponds to the IAccessibleText interface. It should be implemented for widgets that display more text than a plain label. Labels should be represented by only QAccessibleInterface and return their text as name ( QAccessibleInterface::text () 采用 QAccessible::Name as type). The QAccessibleTextInterface is typically for text that a screen reader might want to read line by line, and for widgets that support text selection and input. This interface is, for example, implemented for QLineEdit .
[virtual]
QAccessibleTextInterface::
~QAccessibleTextInterface
()
[pure virtual]
void
QAccessibleTextInterface::
addSelection
(
int
startOffset
,
int
endOffset
)
选择文本从 startOffset to endOffset 。 startOffset is the first character that will be selected. The endOffset is the first character that will not be selected.
When the object supports multiple selections (e.g. in a word processor), this adds a new selection, otherwise it replaces the previous selection.
The selection will be endOffset - startOffset characters long.
[pure virtual]
QString
QAccessibleTextInterface::
attributes
(
int
offset
,
int
*
startOffset
,
int
*
endOffset
) const
Returns the text attributes at the position offset . In addition the range of the attributes is returned in startOffset and endOffset .
[pure virtual]
int
QAccessibleTextInterface::
characterCount
() const
返回文本的长度 (总大小包括空格)。
[pure virtual]
QRect
QAccessibleTextInterface::
characterRect
(
int
offset
) const
Returns the position and size of the character at position offset in screen coordinates.
[pure virtual]
int
QAccessibleTextInterface::
cursorPosition
() const
返回当前光标位置。
另请参阅 setCursorPosition ().
[pure virtual]
int
QAccessibleTextInterface::
offsetAtPoint
(const
QPoint
&
point
) const
Returns the offset of the character at the point in screen coordinates.
[pure virtual]
void
QAccessibleTextInterface::
removeSelection
(
int
selectionIndex
)
Clears the selection with index selectionIndex .
[pure virtual]
void
QAccessibleTextInterface::
scrollToSubstring
(
int
startIndex
,
int
endIndex
)
Ensures that the text between startIndex and endIndex 可见。
[pure virtual]
void
QAccessibleTextInterface::
selection
(
int
selectionIndex
,
int
*
startOffset
,
int
*
endOffset
) const
Returns a selection. The size of the selection is returned in startOffset and endOffset . If there is no selection both startOffset and endOffset are 0.
The accessibility APIs support multiple selections. For most widgets though, only one selection is supported with selectionIndex equal to 0.
另请参阅 setSelection ().
[pure virtual]
int
QAccessibleTextInterface::
selectionCount
() const
Returns the number of selections in this text.
[pure virtual]
void
QAccessibleTextInterface::
setCursorPosition
(
int
position
)
把光标移动到 position .
另请参阅 cursorPosition ().
[pure virtual]
void
QAccessibleTextInterface::
setSelection
(
int
selectionIndex
,
int
startOffset
,
int
endOffset
)
Set the selection selectionIndex to the range from startOffset to endOffset .
另请参阅 selection (), addSelection ()，和 removeSelection ().
[pure virtual]
QString
QAccessibleTextInterface::
text
(
int
startOffset
,
int
endOffset
) const
Returns the text from startOffset to endOffset 。 startOffset is the first character that will be returned. The endOffset is the first character that will not be returned.
[virtual]
QString
QAccessibleTextInterface::
textAfterOffset
(
int
offset
,
QAccessible::TextBoundaryType
boundaryType
,
int
*
startOffset
,
int
*
endOffset
) const
Returns the text item of type boundaryType that is right after offset offset and sets startOffset and endOffset values to the start and end positions of that item; returns an empty string if there is no such an item. Sets startOffset and endOffset values to -1 on error.
This default implementation is provided for small text edits. A word processor or text editor should provide their own efficient implementations. This function makes no distinction between paragraphs and lines.
注意： this function can not take the cursor position into account. By convention an offset of -2 means that this function should use the cursor position as offset. Thus an offset of -2 must be converted to the cursor position before calling this function. An offset of -1 is used for the text length and custom implementations of this function have to return the result as if the length was passed in as offset.
[virtual]
QString
QAccessibleTextInterface::
textAtOffset
(
int
offset
,
QAccessible::TextBoundaryType
boundaryType
,
int
*
startOffset
,
int
*
endOffset
) const
Returns the text item of type boundaryType at offset offset and sets startOffset and endOffset values to the start and end positions of that item; returns an empty string if there is no such an item. Sets startOffset and endOffset values to -1 on error.
This default implementation is provided for small text edits. A word processor or text editor should provide their own efficient implementations. This function makes no distinction between paragraphs and lines.
注意： this function can not take the cursor position into account. By convention an offset of -2 means that this function should use the cursor position as offset. Thus an offset of -2 must be converted to the cursor position before calling this function. An offset of -1 is used for the text length and custom implementations of this function have to return the result as if the length was passed in as offset.
[virtual]
QString
QAccessibleTextInterface::
textBeforeOffset
(
int
offset
,
QAccessible::TextBoundaryType
boundaryType
,
int
*
startOffset
,
int
*
endOffset
) const
Returns the text item of type boundaryType that is close to offset offset and sets startOffset and endOffset values to the start and end positions of that item; returns an empty string if there is no such an item. Sets startOffset and endOffset values to -1 on error.
This default implementation is provided for small text edits. A word processor or text editor should provide their own efficient implementations. This function makes no distinction between paragraphs and lines.
注意： this function can not take the cursor position into account. By convention an offset of -2 means that this function should use the cursor position as offset. Thus an offset of -2 must be converted to the cursor position before calling this function. An offset of -1 is used for the text length and custom implementations of this function have to return the result as if the length was passed in as offset.