HCancelSeek (Function)

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.

Note: The current record was selected by the search functions (HReadSeekFirst, HReadSeekLast, ...).

Versions 15 and later

This function is now available for Android applications.

New in version 15

This function is now available for Android applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Note: From version 19, HFSQL is the new name of HyperFileSQL.

Example

// Find the customers from the customer named "Moore"
HReadSeekFirst(Customer, Name, "Moore")
IF HFound(Customer) = True THEN
// Element found: cancel the search
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([<File name> [, <Item name>]])

<Result>: Boolean

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

<File name>: Optional character string (with or without quotes)

Name of data file (defined in the analysis) for which the search criterion must be canceled. If this name is not specified, HCancelSeek refers to the last data file used.

<Item name>: Optional character string (with or without quotes)

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

Component : wd240hf.dll