hiClearCurrentTextSelection

hiClearCurrentTextSelection(
w_windowId
)
=> t / nil

Description

Clears current selection, if any, in the specified text window. This is equivalent to clicking anywhere in the text window when text is selected.

Argument

w_windowId

ID of the text window.

Values Returned

t	The existing selection was cleared.
nil	No text was selected, therefore, nothing was cleared.

Examples

The hiSetCurrentTextSelectionLoc function selects text with indexes 10:20, which is equivalent to selecting the text in that range using the mouse. The hiClearCurrentTextSelection function clears the selection.

win=(view "memoirs.txt")
(hiSetCurrentTextSelectionLoc win 10 20) 
selection=(hiGetClipboard) 
> "confidentia"
(hiClearCurrentTextSelection win) 

Related Topics

Functions of Viewfile Window

hiSetCurrentTextSelectionLoc

Return to top