HCancelSeek (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / Managing databases / HFSQL / HFSQL functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HCancelSeek (Function)

In french: HAnnuleRecherche

Not available with this kind of connection

Cancels the current search criterion. The browse of the data file can continue from the current record, without using any search criterion. The browsed records will not necessarily correspond to the search condition.

Remark: The current recording has been selected using the search functions (HReadSeekFirst, HReadSeekLast, ...).

Example

// Find the customers from the customer named "Moore"
HReadSeekFirst(Customer, Name, "Moore")
IF HFound(Customer) = True THEN
	// Element found: search is cancelled
	HCancelSeek(Customer, Name)
	IF ErrorOccurred = True THEN
		Error(HErrorInfo())
		RETURN
	END
	WHILE HOut(Customer) = False
		 // Process 
		 ...
		 // Read the next one without using the search criterion
		 HReadNext(Customer, Name)
	 END
END

Syntax

<Result> = HCancelSeek([<Data file> [, <Item>]])

<Result>: Boolean

True if the operation was performed,
False if a problem occurs. HError is used to identify the error.

<Data file>: Optional character string

Name of data file (defined in the analysis) for which the search criterion must be canceled. This name can also correspond to a view or a query.
If this name is not specified, HCancelSeek handles the last data file used.

<Item>: Optional character string

Name of the file item for which the search criterion must be canceled.
If this name is not specified, HCancelSeek handles the last item used in the data file.

Component: wd300hf.dll