CursorDetach Method

Frees the currently attached cursor from the current instance of CursorAdapter.

CursorAdapter.CursorDetach()

Return Value

Logical data type. CursorDetach returns True (.T.) if cursor is detached successfully and False (.F.) if not detached successfully.

Note

To retrieve error information when CursorDetach returns False (.F.), you must call the AERROR( ) Function function because Visual Foxpro error handling, such as the ON ERROR command, Error event, and TRY...CATCH...FINALLY command, does not capture this error information.

Remarks

Applies To: CursorAdapter Class

Visual FoxPro preserves all settings, such as buffering and so on, available to a normal cursor in the freed cursor.

Visual FoxPro preserves all unsaved changes. For example, you do not need to call the TABLEUPDATE function before detaching the cursor.

See Also

Reference

CursorAdapter Object Properties, Methods, and Events

TABLEUPDATE( ) Function

BeforeCursorDetach Event

AfterCursorDetach Event

CursorAttach Method

Other Resources

Methods (Visual FoxPro)