Commit 12697a18 authored by Joanmarie Diggs's avatar Joanmarie Diggs
Browse files

Merge branch 'master' into 'master'

Update documentation for atk_text_set_caret_offset.

See merge request !18
parents afaea0de f7306bcc
......@@ -1031,6 +1031,22 @@ atk_text_set_selection (AtkText *text,
*
* Sets the caret (cursor) position to the specified @offset.
*
* In the case of rich-text content, this method should either grab focus
* or move the sequential focus navigation starting point (if the application
* supports this concept) as if the user had clicked on the new caret position.
* Typically, this means that the target of this operation is the node containing
* the new caret position or one of its ancestors. In other words, after this
* method is called, if the user advances focus, it should move to the first
* focusable node following the new caret position.
*
* Calling this method should also scroll the application viewport in a way
* that matches the behavior of the application's typical caret motion or tab
* navigation as closely as possible. This also means that if the application's
* caret motion or focus navigation does not trigger a scroll operation, this
* method should not trigger one either. If the application does not have a caret
* motion or focus navigation operation, this method should try to scroll the new
* caret position into view while minimizing unnecessary scroll motion.
*
* Returns: %TRUE if successful, %FALSE otherwise.
**/
gboolean
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment