Search FAQ

MUSHclient scripting

Description of MUSHclient world function: world.PasteCommand


Name PasteCommand
Type Method
Summary Pastes text into the command window, replacing the current selection
Prototype BSTR PasteCommand(BSTR Text);
Description

This pastes the supplied text into the command window, which does not have to be empty (unlike SetCommand) at the current cursor position, replacing any selection. It returns the text that it replaced, if any.

eg.

Command window reads:

go north
^^

("go" is selected)

You execute: s = PasteCommand ("walk")

Command window now reads:

walk north

s contains "go"

You could use this to make shortcut keys that paste frequently-used words into the command window.

For example:

/Accelerator ("Alt+N", "/PasteCommand 'swordfish'")

Now, whenever you hit Alt+N the word "swordfish" is pasted into the command window, replacing the current selection, or at the cursor.


Note: Available in version 3.69 onwards.


VBscript example
previous = PasteCommand ("swordfish")
Jscript example
PasteCommand ("swordfish");
PerlScript example
$world->PasteCommand ("swordfish");
Python example
PasteCommand ("swordfish")
Lua example
previous = PasteCommand ("swordfish")
Returns The previously selected text, if any.
Introduced in version 3.69

See also ...

Function Description
Accelerator Add or modify an accelerator key (keystroke to command mapping)
SetCommand Sends text to the command window

Search for script function

Enter a word or phrase in the box below to narrow the list down to those that match.

The function name, prototype, summary, and description are searched.

Search for:   

Leave blank to show all functions.


Return codes

Many functions return a "code" which indicates the success or otherwise of the function.

You can view a list of the return codes


Function prototypes

The "prototype" part of each function description lists exactly how the function is called (what arguments, if any, to pass to it).

You can view a list of the data types used in function prototypes


View all functions

[Back]

Information and images on this site are licensed under the Creative Commons Attribution 3.0 Australia License unless stated otherwise.