GetTextOccurrenceCount(Int32,String,Boolean,Boolean,Boolean) Method
In This Topic
Searches for an occurrence of a given text expression within the specified page of the document displayed in the GdViewer control according to the parameters you have specified. If the format of the displayed document is other than supported text-based formats, which currently are DOCX, TXT, RTF and PDF, the method will fail.
You can benefit from selecting the comparison option using this method, in other words, you can search respecting accents or not in the given text expression.
Syntax
'Declaration
Public Overloads Function GetTextOccurrenceCount( _
ByVal As Integer, _
ByVal As String, _
ByVal As Boolean, _
ByVal As Boolean, _
ByVal As Boolean _
) As Integer
public int GetTextOccurrenceCount(
int ,
string ,
bool ,
bool ,
bool
)
public function GetTextOccurrenceCount(
: Integer;
: String;
: Boolean;
: Boolean;
: Boolean
): Integer;
public function GetTextOccurrenceCount(
: int,
: String,
: boolean,
: boolean,
: boolean
) : int;
public: int GetTextOccurrenceCount(
int ,
string* ,
bool ,
bool ,
bool
)
public:
int GetTextOccurrenceCount(
int ,
String^ ,
bool ,
bool ,
bool
)
Parameters
- Page
- The number of the page to search for text. It must be a value from 1 to the value of the PageCount property.
- Text
- The text expression to search for.
- CaseSensitive
- Set this parameter to true if you want to apply case-sensitive search, otherwise set it to false.
- WholeWords
- Set this parameter to true if you want to search for the whole words only, otherwise set it to false.
- OrdinalComparison
- Set this parameter to true if you want to search applying the ordinal (binary) sort rules, otherwise set it to false.
An ordinal comparison compares strictly on the numeric character values, that means it does not respect accents.
Return Value
The number of occurrences if the given text expression has been found on the current page according to the specified parameters. The
GetStat method can be subsequently used to determine if this method has been successful.
Example
How to search for the specified text applying the Ordinal comparison.
'We assume that the GdViewer1 control has been properly integrated
'and your document has been properly displayed as well.
Sub MySearchText(ByVal TextToSearch As String)
Dim page As Integer = 1, occurrence As Integer = 0
Dim status As GdPictureStatus = GdPictureStatus.OK
While (status = GdPictureStatus.OK) AndAlso (page <= GdViewer1.PageCount)
occurrence = GdViewer1.GetTextOccurrenceCount(page, TextToSearch, False, False, True)
status = GdViewer1.GetStat()
If status = GdPictureStatus.OK Then
If occurrence > 0 Then Exit While
page += 1
End If
End While
If (status = GdPictureStatus.OK) AndAlso (occurrence > 0) Then GdViewer1.DisplayPage(page)
End Sub
//We assume that the GdViewer1 control has been properly integrated
//and your document has been properly displayed as well.
void MySearchText(string TextToSearch)
{
int page = 1, occurrence = 0;
GdPictureStatus status = GdPictureStatus.OK;
while ((status == GdPictureStatus.OK) && (page <= GdViewer1.PageCount))
{
occurrence = GdViewer1.GetTextOccurrenceCount(page, TextToSearch, false, false, true);
status = GdViewer1.GetStat();
if (status == GdPictureStatus.OK)
{
if (occurrence > 0) break;
page++;
}
}
if ((status == GdPictureStatus.OK) && (occurrence > 0))
GdViewer1.DisplayPage(page);
}
Example
How to search for the specified text applying the Ordinal comparison.
'We assume that the GdViewer1 control has been properly integrated
'and your document has been properly displayed as well.
Sub MySearchText(ByVal TextToSearch As String)
Dim page As Integer = 1, occurrence As Integer = 0
Dim status As GdPictureStatus = GdPictureStatus.OK
While (status = GdPictureStatus.OK) AndAlso (page <= GdViewer1.PageCount)
occurrence = GdViewer1.GetTextOccurrenceCount(page, TextToSearch, False, False, True)
status = GdViewer1.GetStat()
If status = GdPictureStatus.OK Then
If occurrence > 0 Then Exit While
page += 1
End If
End While
If (status = GdPictureStatus.OK) AndAlso (occurrence > 0) Then GdViewer1.DisplayPage(page)
End Sub
//We assume that the GdViewer1 control has been properly integrated
//and your document has been properly displayed as well.
void MySearchText(string TextToSearch)
{
int page = 1, occurrence = 0;
GdPictureStatus status = GdPictureStatus.OK;
while ((status == GdPictureStatus.OK) && (page <= GdViewer1.PageCount))
{
occurrence = GdViewer1.GetTextOccurrenceCount(page, TextToSearch, false, false, true);
status = GdViewer1.GetStat();
if (status == GdPictureStatus.OK)
{
if (occurrence > 0) break;
page++;
}
}
if ((status == GdPictureStatus.OK) && (occurrence > 0))
GdViewer1.DisplayPage(page);
}
See Also