Script function

world.AppendToNotepad

Type

Method

Summary

Appends text to a notepad window

Prototype

boolean AppendToNotepad(BSTR Title, BSTR Contents);

Description

Appends the text to a notepad window of the given title. If no such window exists, it is created.

The function "AppendToNotepad" does not activate (bring to the front) the notepad window. However the function "ActivateNotepad" can be used to do that.

You can use world.activate to activate the world itself (eg. you might want to do that after creating a notepad window).

You might use GetNotepadLength to check if there is likely to be room in the notepad for the new text.

VBscript example

world.AppendToNotepad "Nick's window", "More stuff" + vbcrlf

Jscript example

world.AppendToNotepad("Nick's window", "More stuff\r\n");

PerlScript example

$world->AppendToNotepad("Nick's window", "More stuff\r\n");

Python example

world.AppendToNotepad("Nick's window", "More stuff\r\n")

Lua example

AppendToNotepad("Nick's window", "More stuff\r\n",
                "another line")

Lua notes

You can supply multiple arguments after the notepad name, which are concatenated together.

Return value

0: Could not do it.
1: Appended OK

See Also ...

Topic

Notepad

Functions

(Activate) Activates the world window
(ActivateNotepad) Activates a notepad window
(CloseNotepad) Closes a notepad window
(GetNotepadLength) Gets the length of the text in a notepad window
(GetNotepadList) Gets the list of open notepads - returning their titles
(GetNotepadText) Gets the text from a notepad window
(MoveNotepadWindow) Move and resize the specified notepad window
(NotepadColour) Changes the text and background colour of the selected notepad window
(NotepadFont) Changes the font and style of the selected notepad window
(NotepadReadOnly) Make a selected notepad window read-only
(NotepadSaveMethod) Changes the save method for this notepad window
(ReplaceNotepad) Replaces text in a notepad window
(SaveNotepad) Saves a notepad window to disk
(SendToNotepad) Creates a notepad and sends text to it

(Help topic: function=AppendToNotepad)