UserLand Software Home  |  Manila  |  Radio  |  Support  |  News

DocServer

Prev | Next | EditMenu Verbs > editMenu.cut

editMenu.cut

Syntax editMenu.cut ()

Params None required

Action Copies the selected item to the Clipboard and then deletes it from its original location.

Returns True if a selection existed and was cut, false if there was no selection or if the cut process failed.

Examples Open examples.docs.editText in the Object Database. Select any line of text in the window and then type and execute:
editMenu.cut ()

   » true

Now you can scroll to another point in the document, click the insertion point there, and execute:
editMenu.paste ()

to confirm that the cut operation worked as expected. Before you leave the example, be sure to return the sample to its original condition with the Undo command.

Make sure you don't have anything selected in the frontmost editing window containing examples.docs.editText. Now type and execute:
editMenu.cut ()


   » false

Notice the return value is different from the first example, above. Re-select the example text window. Execute:
editMenu.paste ()

Notice that the previous contents of the Clipboard are pasted into the document. Be sure to return the document to its original condition before proceeding.

Notes Performs the same action as selecting the Cut command from the Edit menu in Frontier, except it leaves the Clipboard contents unmodified.

Since this verb places material on the Clipboard, it is slower and uses more memory than editMenu.clear. You should use editMenu.clear unless you plan to paste the information being removed from the document.

The action applies to the Frontier environment only.

See Also editMenu.clear

editMenu.copy

editMenu.paste

Prev | Next | EditMenu Verbs > editMenu.cut

Anonymization by Anonymouse.org ~ Adverts
Anonymouse better ad-free, faster and with encryption?
X