Clarified the documentation for QTextDocument::find.

QTextDocument::find has a behavior that is different from the typical
QRegExp/QRegularExpression behavior where finding a given expression is
always constrained by the paragraph (block), regardless of newline
characters in the expression.

Task-number: QTBUG-21785
Change-Id: Ia6a061c6feb5a19e6b8caa3d8009da5ca31ec422
Reviewed-by: Konstantin Ritt <ritt.ks@gmail.com>
Reviewed-by: Simon Hausmann <simon.hausmann@theqtcompany.com>
bb10
Kavindra Palaraja 2015-07-14 21:33:34 +02:00 committed by Simon Hausmann
parent 5f5db1c38b
commit f8441c071f
1 changed files with 12 additions and 4 deletions

View File

@ -1402,7 +1402,9 @@ static bool findInBlock(const QTextBlock &block, const QRegExp &expression, int
/*!
\overload
Finds the next occurrence, matching the regular expression, \a expr, in the document.
Finds the next occurrence that matches the given regular expression,
\a expr, within the same paragraph in the document.
The search starts at the given \a from position, and proceeds forwards
through the document unless specified otherwise in the search options.
The \a options control the type of search performed. The FindCaseSensitively
@ -1455,7 +1457,9 @@ QTextCursor QTextDocument::find(const QRegExp & expr, int from, FindFlags option
/*!
\overload
Finds the next occurrence, matching the regular expression, \a expr, in the document.
Finds the next occurrence that matches the given regular expression,
\a expr, within the same paragraph in the document.
The search starts at the position of the given from \a cursor, and proceeds
forwards through the document unless specified otherwise in the search
options. The \a options control the type of search performed. The FindCaseSensitively
@ -1526,7 +1530,9 @@ static bool findInBlock(const QTextBlock &block, const QRegularExpression &expre
/*!
\since 5.5
Finds the next occurrence, matching the regular expression, \a expr, in the document.
Finds the next occurrence that matches the given regular expression,
\a expr, within the same paragraph in the document.
The search starts at the given \a from position, and proceeds forwards
through the document unless specified otherwise in the search options.
The \a options control the type of search performed.
@ -1579,7 +1585,9 @@ QTextCursor QTextDocument::find(const QRegularExpression &expr, int from, FindFl
/*!
\since 5.5
Finds the next occurrence, matching the regular expression, \a expr, in the document.
Finds the next occurrence that matches the given regular expression,
\a expr, within the same paragraph in the document.
The search starts at the position of the given \a cursor, and proceeds
forwards through the document unless specified otherwise in the search
options. The \a options control the type of search performed.