Array

This object provides a way of storing more than one value for a given name. These values can be accessed by another index.

Operations
ContainsIndex
[Link](array, index)

Gets whether or not the array contains the specified index. This is very useful when deciding if the array's index was initialized by some value or not.
array
The array to check.

index
The index to check.

Returns
"True" or "False" depending on if the index was present in the specified. array.

ContainsValue
[Link](array, value)

Gets whether or not the array contains the specified value. This is very useful when deciding if the array's value was stored in some index.
array
The array to check.

value
The value to check.

Returns
"True" or "False" depending on if the value was present in the specified. array. ending

GetAllIndices
[Link](array)

Gets all the indices for the array, as another array.

array
The array whose indices are requested.

Returns
An array filled with all the indices of the specified array. The index of the returned array starts from 1.

GetItemCount
[Link](array)

Gets the number of items stored in the array.

array
The array for which the count is requested.

Returns
The number of items in the specified array.

IsArray
[Link](array)

Gets whether or not a given variable is an array.

array
The variable to check.

Returns
"True" if the specified variable is an array. "False" otherwise.

SetValue
[Link](arrayName, index, value)

Sets a value for a given array and index.

arrayName
The name of the array.

index
Name of the index.

value
The value to set.

Returns
Nothing

GetValue
[Link](arrayName, index)

Gets a value for a given array and index.

arrayName
The name of the array.

index
The name of the index.

Returns

The value at the specified index of the specified array.

RemoveValue
[Link](arrayName, index)

Removes the array item at the specified index.

arrayName
The name of the array.

index
The index of the item to remove.

Returns
Nothing

Clock
This class provides access to the system clock

Properties
Time (This property is read-only.)
[Link]

Gets the current system time. Date (This property is read-only.)

[Link]

Gets the current system date. Year (This property is read-only.)

[Link]

Gets the current year. Month (This property is read-only.)

[Link]

Gets the current Month. Day (This property is read-only.)

[Link]

Gets the current day of the month. WeekDay (This property is read-only.) only.)
[Link]

Gets the current day of the week. Hour (This property is read-only.)
[Link]

Gets the current Hour. Minute (This property is read-only.)

[Link]

Gets the current Minute. Second (This property is read-only.)

[Link]

Gets the current Second. Millisecond (This property is read-only.) only.)

[Link]

Gets the current Millisecond. ElapsedMilliseconds (This property is read read-only.)

[Link]

Gets the number of milliseconds that have elapsed since 1900.

Controls
The Controls object allows you to add, move and interact with controls.

Properties
LastClickedButton (This property is read read-only.)
[Link]

Gets the last Button that was clicked on the Graphics Window. LastTypedTextBox (This property is read-only.)

[Link]

Gets the last TextBox, text was typed into.

Events
ButtonClicked
[Link]

Raises an event when any button control is clicked. TextTyped

[Link]

Raises an event when text is typed into any TextBox control.

Operations
AddButton
[Link](caption, left, top)

Adds a button to the graphics window with the specified width and height.
caption
The caption to display in the button.

left
The x co-ordinate of the button.

top
The y co-ordinate of the button.

Returns
The button that was just added to the Graphics Window.

GetButtonCaption
[Link](buttonName)

Gets the curent caption of the specified button.

buttonName
The Button whose caption is requested.

Returns
The current caption of the button.

SetButtonCaption
[Link](buttonName, caption)

Sets the caption of the specified button.

buttonName
The Button whose caption needs to be set.

caption
The new caption for the button.

Returns
Nothing

AddTextBox
[Link](left, top)

Adds a text input box to the graphics window with the specified width and height.
left
The x co-ordinate of the text box.

top
The y co-ordinate of the text box.

Returns
The text box that was just added to the Graphics Window.

AddMultiLineTextBox
[Link](left, top)

Adds a multi-line text input box to the graphics window with the specified width and height. line
left
The x co-ordinate of the text box.

top
The y co-ordinate of the text box.

Returns
The text box that was just added to the Graphics Window.

GetTextBoxText
[Link](textBoxName)

Gets the curent text of the specified TextBox.

textBoxName
The TextBox whose text is requested.

Returns
The text in the TextBox

SetTextBoxText
[Link](textBoxName, text)

Sets the text of the specified TextBox.

textBoxName
The TextBox whose text needs to be set.

text
The new text for the TextBox.

Returns
Nothing

Remove
[Link](controlName)

Removes a control from the Graphics Window.

controlName
The name of the control that needs to be removed.

Returns
Nothing

Move
[Link](control, x, y)

Moves the control with the specified name to a new position.

control
The name of the control to move.

x
The x co-ordinate of the new position.

y
The y co-ordinate of the new position.

Returns
Nothing

SetSize
[Link](control, width, height)

Sets the size of the control.

control
The name of the control to be resized.

width
The width of the control.

height

The height of the control.

Returns
Nothing

HideControl
[Link](controlName)

Hides an already added control.

controlName
The name of the control.

Returns
Nothing

ShowControl
[Link](controlName)

Shows a previously hidden control.

controlName
The name of the control.

Returns
Nothing

Desktop
This class provides methods to interact with the desktop.

Properties
Width (This property is read-only.)
[Link]

Gets the screen width of the primary desktop. Height (This property is read-only.)
[Link]

Gets the screen height of the primary desktop.

Operations
SetWallPaper

[Link](fileOrUrl)

Sets the specified picture as the desktop's wallpaper. This file could be a local file or a network file or even an internet url.
fileOrUrl
The filename or url of the picture.

Returns
Nothing

Dictionary
This class provides access to an online Dictionary service.

Operations
GetDefinition
[Link](word)

Gets the definition of a word, in English.

word
The word to define.

Returns
The definition(s) of the specified word.

GetDefinitionInFrench
[Link](word)

Gets the definition of a word, in French.

word
The word to define.

Returns
The definition(s) of the specified word.

File
The File object provides methods to access, read and write information from and to a file on disk. Using this object, it is possible to save and open settings across multiple sessions of your program.

Properties
LastError
[Link]

Gets or sets the last encountered file operation based error message. This property is useful for finding out when some method fails to execute.

Operations
ReadContents
[Link](filePath)

Opens a file and reads the entire file's contents. This method will be fast for small files that are less than an MB in size, but will start to slow down and will be noticeable for files greater than 10MB.
filePath
The full path of the file to read. An example of a full path will be c: c:\temp\[Link].

Returns
The entire contents of the file.

WriteContents
[Link](filePath, contents)

Opens a file and writes the specified contents into it, replacing the original contents with the new content.
filePath
The full path of the file to write to. An example of a full path will be c: c:\temp\[Link].

contents
The contents to write into the specified file.

Returns
If the operation was successful, this will return "SUCCESS". Otherwise, it will return "FAILED".

ReadLine
[Link](filePath, lineNumber)

Opens the specified file and reads the contents at the specified line number.
filePath
The full path of the file to read from. An example of a full path will be c: c:\temp\[Link].

lineNumber
The line number of the text to be read.

Returns
The text at the specified line of the specified file.

WriteLine
[Link](filePath, lineNumber, contents)

Opens the specified file and write the contents at the specified line number. This operation will overwrite any existing content at the specified line.
filePath
The full path of the file to read from. An example of a full path will be c: c:\temp\[Link].

lineNumber
The line number of the text to write.

contents
The contents to write at the specified line of the specified file.

Returns
If the operation was successful, this will return "SUCCESS". Otherwise, it will return "FAILED".

InsertLine
[Link](filePath, lineNumber, contents)

Opens the specified file and inserts the contents at the specified line number. This operation will not overwrite any existing content at the specifid line.
filePath
The full path of the file to read from. An example of a full path will be c: c:\temp\[Link].

lineNumber
The line number of the text to insert.

contents
The contents to insert into the file.

Returns
If the operation was successful, this will return "SUCCESS". Otherwise, it will return "FAILED".

AppendContents
[Link](filePath, contents)

Opens the specified file and appends the contents to the end of the file.
filePath
The full path of the file to read from. An example of a full path will be c: c:\temp\[Link].

contents
The contents to append to the end of the file.

Returns
If the operation was successful, this will return "SUCCESS". Otherwise, it will return "FAILED".

CopyFile

[Link](sourceFilePath, destinationFilePath)

Copies the specified source file to the destination file path. If the destination points to a location that doesn't exist, the method will attempt to create it automatically. Existing files will be overwritten. It is always best to check if the destination file exists if you don't want to overwrite existing files.
sourceFilePath
The full path of the file that needs to be copied. An example of a full path will be c: c:\temp\[Link].

destinationFilePath
The destination location or the file path.

Returns
If the operation was successful, this will return "SUCCESS". Otherwise, it will return "FAILED".

DeleteFile
[Link](filePath)

Deletes the specified file.

filePath
The destination location or the file path. An example of a full path will be c: c:\temp\[Link].

Returns
If the operation was successful, this will return "SUCCESS". Otherwise, it will return "FAILED".

CreateDirectory
[Link](directoryPath)

Creates the specified directory.

directoryPath
The full path of the directory to be created.

Returns
If the operation was successful, this will return "SUCCESS". Otherwise, it will return "FAILED".

DeleteDirectory
[Link](directoryPath)

Deletes the specified directory.

directoryPath
The full path of the directory to be deleted.

Returns
If the operation was successful, this will return "SUCCESS". Otherwise, it will return "FAILED".

GetFiles
[Link](directoryPath)

Gets the path of all the files in the specified directory path.
directoryPath
The directory to look for files.

Returns
If the operation was successful, this will return the files as an array. Otherwise, it will return "FAILED".

GetDirectories
[Link](directoryPath)

Gets the path of all the directories in the specified directory path.
directoryPath
The directory to look for subdirectories.

Returns
If the operation was successful, this will return the list of directories as an array. Otherwise, it will return "FAILED".

GetTemporaryFilePath
[Link]()

Creates a new temporary file in a temporary directory and returns the full file path.
Returns
The full file path of the temporary file.

GetSettingsFilePath
[Link]()

Gets the full path of the settings file for this program. The settings file name is based on the program's name and is present in the same location as the program.
Returns
The full path of the settings file specific for this program.

Flickr
This class provides access to Flickr photo services.

Operations
GetPictureOfMoment
[Link]()

Gets the url for the picture of the moment.

Returns
A file url for Flickr's picture of the moment

GetRandomPicture
[Link](tag)

Gets the url for a random picture tagged with the specified tag.
tag
The tag for the requested picture.

Returns
A file url for Flickr's random picture

GraphicsWindow
The GraphicsWindow provides graphics related input and output functionality. For example, using this class, it is possible to draw and fill circles and rectangles.

Properties
BackgroundColor
[Link]

Gets or sets the Background color of the Graphics Window. BrushColor

[Link]

Gets or sets the brush color to be used to fill shapes drawn on the Graphics Window. CanResize
[Link]

Specifies whether or not the Graphics Window can be resized by the user. PenWidth
[Link]

Gets or sets the width of the pen used to draw shapes on the Graphics Window. PenColor

[Link]

Gets or sets the color of the pen used to draw shapes on the Graphics Window. FontName
[Link]

Gets or sets the Font Name to be used when drawing text on the Graphics Window. FontSize
[Link]

Gets or sets the Font Size to be used when drawing text on the Graphics Window. FontBold
[Link]

Gets or sets whether or not the font to be used when drawing text on the Graphics Window, is bold. FontItalic
[Link]

Gets or sets whether or not the font to be used when drawing text on the Graphics Window, is italic. Title
[Link]

Gets or sets the title for the graphics window. Height

[Link]

Gets or sets the Height of the graphics window. Width

[Link]

Gets or sets the Width of the graphics window. Left

[Link]

Gets or sets the Left Position of the graphics window. Top

[Link]

Gets or sets the Top Position of the graphics window. LastKey (This property is read-only.)
[Link]

Gets the last key that was pressed or released. LastText (This property is read-only.) only.)
[Link]

Gets the last text that was entered on the Graphics Window. MouseX (This property is read-only.)
[Link]

Gets the x-position of the mouse relative to the Graphics Window. position MouseY (This property is read-only.)
[Link]

Gets the y-position of the mouse relative to the Graphics Window. position

Events
KeyDown
[Link]

Raises an event when a key is pressed down on the keyboard. KeyUp

[Link]

Raises an event when a key is released on the keyboard. MouseDown

[Link]

Raises an event when the mouse button is clicked down. MouseUp

[Link]

Raises an event when the mouse button is released. MouseMove

[Link]

Raises an event when the mouse is moved around. TextInput

[Link]

Raises an event when text is entered on the GraphicsWindow.

Operations
Show
[Link]()

Shows the Graphics window to enable interactions with it.

Returns
Nothing

Hide
[Link]()

Hides the Graphics window.

Returns
Nothing

DrawRectangle
[Link](x, y, width, height)

Draws a rectangle on the screen using the selected Pen.

x
The x co-ordinate of the rectangle.

y
The y co-ordinate of the rectangle.

width
The width of the rectangle.

height
The height of the rectangle.

Returns
Nothing

FillRectangle
[Link](x, y, width, height)

Fills a rectangle on the screen using the selected Brush.

x
The x co-ordinate of the rectangle.

y
The y co-ordinate of the rectangle.

width
The width of the rectangle.

height
The height of the rectangle.

Returns
Nothing

DrawEllipse
[Link](x, y, width, height)

Draws an ellipse on the screen using the selected Pen.

x
The x co-ordinate of the ellipse.

y
The y co-ordinate of the ellipse.

width
The width of the ellipse.

height
The height of the ellipse.

Returns
Nothing

FillEllipse
[Link](x, y, width, height)

Fills an ellipse on the screen using the selected Brush.

x
The x co-ordinate of the ellipse.

y
The y co-ordinate of the ellipse.

width
The width of the ellipse.

height
The height of the ellipse.

Returns
Nothing

DrawTriangle
[Link](x1, y1, x2, y2, x3, y3)

Draws a triangle on the screen using the selected pen.

x1
The x co-ordinate of the first point.

y1
The y co-ordinate of the first point.

x2
The x co-ordinate of the second point.

y2
The y co-ordinate of the second point.

x3
The x co-ordinate of the third point.

y3
The y co-ordinate of the third point.

Returns
Nothing

FillTriangle
[Link](x1, y1, x2, y2, x3, y3)

Draws and fills a triangle on the screen using the selected brush.
x1
The x co-ordinate of the first point.

y1
The y co-ordinate of the first point.

x2
The x co-ordinate of the second point.

y2
The y co-ordinate of the second point.

x3
The x co-ordinate of the third point.

y3
The y co-ordinate of the third point.

Returns
Nothing

DrawLine
[Link](x1, y1, x2, y2)

Draws a line from one point to another.

x1
The x co-ordinate of the first point.

y1
The y co-ordinate of the first point.

x2
The x co-ordinate of the second point.

y2
The y co-ordinate of the second point.

Returns
Nothing

DrawText
[Link](x, y, text)

Draws a line of text on the screen at the specified location.

x
The x co-ordinate of the text start point.

y
The y co-ordinate of the text start point.

text
The text to draw

Returns
Nothing

DrawBoundText
[Link](x, y, width, text)

Draws a line of text on the screen at the specified location.

x
The x co-ordinate of the text start point.

y
The y co-ordinate of the text start point.

width
The maximum available width. This parameter helps define when the text should wrap.

text
The text to draw.

Returns
Nothing

DrawResizedImage
[Link](imageName, x, y, width, height)

Draws the specified image from memory on to the screen, in the specified size.
imageName
The name of the image to draw

x
The x co-ordinate of the point to draw the image at.

y
The y co-ordinate of the point to draw the image at. ordinate

width
The width to draw the image.

height
The height to draw the image.

Returns
Nothing

DrawImage
[Link](imageName, x, y)

Draws the specified image from memory on to the screen.

imageName
The name of the image to draw.

x
The x co-ordinate of the point to draw the image at. ordinate

y
The y co-ordinate of the point to draw the image at. ordinate

Returns
Nothing

SetPixel
[Link](x, y, color)

Draws the pixel specified by the x and y co co-ordinates using the specified color.
x
The x co-ordinate of the pixel.

y
The y co-ordinate of the pixel.

color

The color of the pixel to set.

Returns
Nothing

GetPixel
[Link](x, y)

Gets the color of the pixel at the specified x and y co co-ordinates.

x
The x co-ordinate of the pixel.

y
The y co-ordinate of the pixel.

Returns
The color of the pixel.

GetRandomColor
[Link]()

Gets a valid random color.

Returns
A valid random color.

GetColorFromRGB
[Link](red, green, blue)

Constructs a color given the Red, Green and Blue values.

red
The red component of the Color (0-255).

green
The green component of the color (0-255). 255).

blue
The blue component of the color (0-255).

Returns
Returns a color that can be used to set the brush or pen color.

Clear
[Link]()

Clears the window.

Returns

Nothing

ShowMessage
[Link](text, title)

Displays a message box to the user.

text
The text to be displayed on the message box.

title
The title for the message box.

Returns
Nothing

ImageList
This class helps to load and store images in memory.

Operations
LoadImage
[Link](fileNameOrUrl)

Loads an image from a file or the internet into memory.

fileNameOrUrl
The file name to load the image from. This could be a local file or a url to the internet location.

Returns
Returns the name of the image that was loaded.

GetWidthOfImage
[Link](imageName)

Gets the width of the stored image.

imageName
The name of the image in memory.

Returns
The width of the specified image.

GetHeightOfImage
[Link](imageName)

Gets the height of the stored image.

imageName
The name of the image in memory.

Returns
The height of the specified image.

Math
The Math class provides lots of useful mathematics related methods

Properties
Pi (This property is read-only.)
[Link]

Gets the value of Pi

Operations
Abs
[Link](number)

Gets the absolute value of the given number. For example, -32.233 will return 32.233. 32.233
number
The number to get the absolute value for.

Returns
The absolute value of the given number.

Ceiling
[Link](number)

Gets an integer that is greater than or equal to the specified decimal number. For example, 32.233 will return 33.
number
The number whose ceiling is required.

Returns
The ceiling value of the given number.

Floor
[Link](number)

Gets an integer that is less than or equal to the specified decimal number. For example, 32.233 will return 32.
number
The number whose floor value is required.

Returns
The floor value of the given number.

NaturalLog
[Link](number)

Gets the natural logarithm value of the given number.

number
The number whose natural logarithm value is required.

Returns
The natural log value of the given number.

Log
[Link](number)

Gets the logarithm (base 10) value of the given number.

number
The number whose logarithm value is required

Returns
The log value of the given number

Cos
[Link](angle)

Gets the cosine of the given angle in radians.

angle
The angle whose cosine is needed (in radians).

Returns
The cosine of the given angle.

Sin
[Link](angle)

Gets the sine of the given angle in radians.

angle
The angle whose sine is needed (in radians)

Returns
The sine of the given angle

Tan
[Link](angle)

Gets the tangent of the given angle in radians.

angle
The angle whose tangent is needed (in radians).

Returns
The tangent of the given angle.

ArcSin
[Link](sinValue)

Gets the angle in radians, given the sin value.

sinValue
The sine value whose angle is needed.

Returns
The angle (in radians) for the given sine Value.

ArcCos
[Link](cosValue)

Gets the angle in radians, given the cosine value.

cosValue
The cosine value whose angle is needed.

Returns
The angle (in radians) for the given cosine Value.

ArcTan
[Link](tanValue)

Gets the angle in radians, given the tangent value.

tanValue
The tangent value whose angle is needed.

Returns
The angle (in radians) for the given tangent Value.

GetDegrees
[Link](angle)

Converts a given angle in radians to degrees.

angle
The angle in radians.

Returns
The converted angle in degrees.

GetRadians
[Link](angle)

Converts a given angle in degrees to radians.

angle
The angle in degrees.

Returns
The converted angle in radians.

SquareRoot
[Link](number)

Gets the square root of a given number.

number
The number whose square root value is needed.

Returns
The square root value of the given number.

Power
[Link](baseNumber, exponent)

Raises the baseNumber to the specified power.

baseNumber
The number to be raised to the exponent power.

exponent
The power to raise the base number.

Returns
The baseNumber raised to the specified exponent.

Round
[Link](number)

Rounds a given number to the nearest integer. For example 32.233 will be rounded to 32.0 while 32.566 will be rounded to 33.

number
The number whose approximation is required.

Returns
The rounded value of the given number.

Max
[Link](number1, number2)

Compares two numbers and returns the greater of the two.

number1
The first of the two numbers to compare.

number2
The second of the two numbers to compare.

Returns
The greater value of the two numbers.

Min
[Link](number1, number2)

Compares two numbers and returns the smaller of the two.

number1
The first of the two numbers to compare.

number2
The second of the two numbers to compare.

Returns
The smaller value of the two numbers.

Remainder
[Link](dividend, divisor)

Divides the first number by the second and returns the remainder.
dividend
The number to divide.

divisor
The number that divides.

Returns
The remainder after the division.

GetRandomNumber
[Link](maxNumber)

Gets a random number between 1 and the specified maxNumber (inclusive).

maxNumber
The maximum number for the requested random value.

Returns
A Random number that is less than or equal to the specified max.

Mouse
The mouse class provides accessors to get or set the mouse related properties, like the cursor position, pointer, etc.

Properties
MouseX
[Link]

Gets or sets the mouse cursor's x co co-ordinate. MouseY

[Link]

Gets or sets the mouse cursor's y co co-ordinate. IsLeftButtonDown (This property is read read-only.)
[Link]

Gets whether or not the left button is pressed. IsRightButtonDown (This property is read read-only.)
[Link]

Gets whether or not the right button is pressed.

Operations
HideCursor
[Link]()

Hides the mouse cursor on the screen.

Returns
Nothing

ShowCursor
[Link]()

Shows the mouse cursors on the screen.

Returns
Nothing

Network
This private helper class provides network access methods

Operations
DownloadFile
[Link](url)

Downloads a file from the network to a local temporary file.

url
The url of the file on the network.

Returns
A local file name that the remote file was downloaded as.

GetWebPageContents
[Link](url)

Gets the contents of a specified web page.

url
The url of the web page

Returns
The contents of the specified web page.

Program
The Program class provides helpers to control the program execution.

Properties
ArgumentCount (This property is read read-only.)

[Link]

Gets the number of command-line arguments passed to this program. line Directory (This property is read-only.) only.)
[Link]

Gets the executing program's directory.

Operations
Delay
[Link](milliSeconds)

Delays program execution by the specified amount of MilliSeconds.

milliSeconds
The amount of delay.

Returns
Nothing

End
[Link]()

Ends the program.

Returns
Nothing

GetArgument
[Link](index)

Returns the specified argument passed to this program.

index
Index of the argument.

Returns
The command-line argument at the specified index. line

Shapes
The Shape object allows you to add, move and rotate shapes to the Graphics window.

Operations
AddRectangle
[Link](width, height)

Adds a rectangle shape with the specified width and height.

width
The width of the rectangle shape.

height
The height of the rectangle shape.

Returns
The Rectangle shape that was just added to the Graphics Window.

AddEllipse
[Link](width, height)

Adds an ellipse shape with the specified width and height.

width
The width of the ellipse shape.

height
The height of the ellipse shape.

Returns
The Ellipse shape that was just added to the Graphics Window.

AddTriangle
[Link](x1, y1, x2, y2, x3, y3)

Adds a triangle shape represented by the specified points.

x1
The x co-ordinate of the first point.

y1
The y co-ordinate of the first point.

x2
The x co-ordinate of the second point.

y2
The y co-ordinate of the second point.

x3
The x co-ordinate of the third point.

y3
The y co-ordinate of the third point.

Returns
The Triangle shape that was just added to the Graphics Window.

AddLine
[Link](x1, y1, x2, y2)

Adds a line between the specified points.

x1
The x co-ordinate of the first point.

y1
The y co-ordinate of the first point.

x2
The x co-ordinate of the second point.

y2
The y co-ordinate of the second point.

Returns
The line that was just added to the Graphics Window.

AddImage
[Link](imageName)

Adds an image as a shape that can be moved, animated or rotated.

imageName
The name of the image to draw.

Returns
The image that was just added to the Graphics Window.

AddText
[Link](text)

Adds some text as a shape that can be moved, animated or rotated.

text
The text to add.

Returns
The text shape that was just added to the Graphics Window.

SetText
[Link](shapeName, text)

Sets the text of a text shape.

shapeName
The name of the text shape.

text
The new text value to set.

Returns
Nothing

Remove
[Link](shapeName)

Removes a shape from the Graphics Window.

shapeName
The name of the shape that needs to be removed.

Returns
Nothing

Move
[Link](shapeName, x, y)

Moves the shape with the specified name to a new position.

shapeName
The name of the shape to move.

x
The x co-ordinate of the new position.

y
The y co-ordinate of the new position.

Returns
Nothing

Rotate
[Link](shapeName, angle)

Rotates the shape with the specified name to the specified angle.
shapeName
The name of the shape to rotate.

angle
The angle to rotate the shape.

Returns
Nothing

Zoom

[Link](shapeName, scaleX, scaleY)

Scales the shape using the specified zoom levels. Minimum is 0.1 and maximum is 20.
shapeName
The name of the shape to rotate.

scaleX
The x-axis zoom level.

scaleY
The y-axis zoom level.

Returns
Nothing

Animate
[Link](shapeName, x, y, duration)

Animates a shape with the specified name to a new position.

shapeName
The name of the shape to move.

x
The x co-ordinate of the new position.

y
The y co-ordinate of the new position.

duration
The time for the animation, in milliseconds.

Returns
Nothing

GetLeft
[Link](shapeName)

Gets the left co-ordinate of the specified shape. ordinate

shapeName
The name of the shape.

Returns
The left co-ordinate of the shape.

GetTop
[Link](shapeName)

Gets the top co-ordinate of the specified shape. ordinate

shapeName
The name of the shape.

Returns
The top co-ordinate of the shape.

GetOpacity
[Link](shapeName)

Gets the opacity of a shape.

shapeName
The name of the shape.

Returns
The opacity of the object as a value between 0 and 100. 0 is completely transparent and 100 is completely opaque.

SetOpacity
[Link](shapeName, level)

Sets how opaque a shape should render.

shapeName
The name of the shape.

level
The opacity level ranging from 0 to 100. 0 is completely transparent and 100 is completely opaque.

Returns
Nothing

HideShape
[Link](shapeName)

Hides an already added shape.

shapeName
The name of the shape.

Returns
Nothing

ShowShape
[Link](shapeName)

Shows a previously hidden shape.

shapeName
The name of the shape.

Returns
Nothing

Sound
The Sound object provides operations that allow the playback of sounds. Some sample sounds are provided along with the library.

Operations
PlayClick
[Link]()

Plays the Click Sound.

Returns
Nothing

PlayClickAndWait
[Link]()

Plays the Click Sound and waits for it to finish.

Returns
Nothing

PlayChime
[Link]()

Plays the Chime Sound.

Returns
Nothing

PlayChimeAndWait
[Link]()

Plays the Chime Sound and waits for it to finish.

Returns
Nothing

PlayChimes
[Link]()

Plays the Chimes Sound.

Returns
Nothing

PlayChimesAndWait
[Link]()

Plays the Chimes Sound and waits for it to finish.

Returns
Nothing

PlayBellRing
[Link]()

Plays the Bell Ring Sound.

Returns
Nothing

PlayBellRingAndWait
[Link]()

Plays the Bell Ring Sound and waits for it to finish.

Returns
Nothing

PlayMusic
[Link](notes)

Plays musical notes.

notes
A set of musical notes to play. The format is a subset of the Music Markup Language supported by QBasic.

Returns
Nothing

Play
[Link](filePath)

Plays the Click Sound.

filePath Returns

Nothing

PlayAndWait
[Link](filePath)

Plays an audio file and waits until it is finished playing. This could be an mp3 or wav or wma file. Other file formats may or may not play depending on the audio codecs installed on the user's computer. If the file was already paused, this operation will resume from the position where the playback was paused.
filePath
The path for the audio file. This could either be a local file (eg: c: c:\music\track1.mp3) or a file on the network (eg: e [Link]

Returns
Nothing

Pause
[Link](filePath)

Pauses playback of an audio file. If the file was not already playing, this operation will not do anything.
filePath
The path for the audio file. This could either be a local file (eg: c: c:\music\track1.mp3) or a file on the network (eg: track1.mp3) [Link]

Returns
Nothing

Stop
[Link](filePath)

Stops playback of an audio file. If the file was not already playing, this operation will not do anything.
filePath
The path for the audio file. This could either be a local file (eg: c: c:\music\track1.mp3) or a file on the network (eg: track1.mp3) [Link]

Returns
Nothing

Stack

This object provides a way of storing values just like stacking up a plate. You can push a value to the top of the stack and pop it off. You can only pop the values one by one off the stack and the last pushed value will be the first one to pop out.

Operations
PushValue
[Link](stackName, value)

Pushes a value to the specified stack.

stackName
The name of the stack.

value
The value to push.

Returns
Nothing

GetCount
[Link](stackName)

Gets the count of items in the specified stack.

stackName
The name of the stack.

Returns
The number of items in the specified stack.

PopValue
[Link](stackName)

Pops the value from the specified stack.

stackName
The name of the stack.

Returns
The value from the stack.

TextWindow
The TextWindow provides text-related input and output functionalities. For example using this class, related it is possible to write or read some text or number to and from the text based text window. text-based

Properties
ForegroundColor
[Link]

Gets or sets the foreground color of the text to be output in the text window. BackgroundColor
[Link]

Gets or sets the background color of the text to be output in the text window. CursorLeft
[Link]

Gets or sets the cursor's column position on the text window. CursorTop
[Link]

Gets or sets the cursor's row position on the text window. Left
[Link]

Gets or sets the Left position of the Text Window. Title

[Link]

Gets or sets the Title for the text window. Top

[Link]

Gets or sets the Top position of the Text Window.

Operations
Show
[Link]()

Shows the Text window to enable interactions with it.

Returns
Nothing

Hide
[Link]()

Hides the text window.

Returns
Nothing

Clear
[Link]()

Clears the TextWindow.

Returns
Nothing

Pause
[Link]()

Waits for user input before returning.

Returns
Nothing

PauseIfVisible
[Link]()

Waits for user input only when the TextWindow is already open.
Returns
Nothing

PauseWithoutMessage
[Link]()

Waits for user input before returning.

Returns
Nothing

Read
[Link]()

Reads a line of text from the text window. This function will not return until the user hits ENTER.
Returns
The text that was read from the text window

ReadKey
[Link]()

Reads a single character from the text window.

Returns
The character that was read from the text window.

ReadNumber
[Link]()

Reads a number from the text window. This function will not return until the user hits ENTER.
Returns
The number that was read from the text window

WriteLine
[Link](data)

Writes text or number to the text window. A new line character will be appended to the output, so that the next time something is written to the text window, it will go in a new line.
data
The text or number to write to the text window.

Returns
Nothing

Write
[Link](data)

Writes text or number to the text window. A new line character will be appended to the output, so that the next time something is written to the text window, it will go in a new line.
data
The text or number to write to the text window.

Returns
Nothing

Text
The Text object provides helpful operations for working with Text.

Operations

Append
[Link](text1, text2)

Appends two text inputs and returns the result as another text. This operation is particularly useful when dealing with unknown text in variables which could accidentally be treated as numbers and get added, instead of getting appended.
text1
First part of the text to be appended.

text2
Second part of the text to be appended.

Returns
The appended text containing both the specified parts.

GetLength
[Link](text)

Gets the length of the given text.

text
The text whose length is needed.

Returns
The length of the given text.

IsSubText
[Link](text, subText)

Gets whether or not a given subText is a subset of the larger text.

text
The larger text within which the sub-text will be searched. text

subText
The sub-text to search for.

Returns
True if the subtext was found within the given text.

EndsWith
[Link](text, subText)

Gets whether or not a given text ends with the specified subText.
text
The larger text to search within.

subText

The sub-text to search for.

Returns
True if the subtext was found at the end of the given text.

StartsWith
[Link](text, subText)

Gets whether or not a given text starts with the specified subText.
text
The larger text to search within.

subText
The sub-text to search for.

Returns
True if the subtext was found at the start of the given text.

GetSubText
[Link](text, start, length)

Gets a sub-text from the given text. text

text
The text to derive the sub-text from.

start
Specifies where to start from.

length
Specifies the length of the sub text.

Returns
The requested sub-text

GetSubTextToEnd
[Link](text, start)

Gets a sub-text from the given text from a specified position to the end. text
text
The text to derive the sub-text from.

start
Specifies where to start from.

Returns
The requested sub-text.

GetIndexOf

[Link](text, subText)

Finds the position where a sub-text appears in the specified text. text
text
The text to search in.

subText
The text to search for.

Returns
The position at which the sub-text appears in the specified text. If the text doesn't appear, it returns 0. text

ConvertToLowerCase
[Link](text)

Converts the given text to lower case.

text
The text to convert to lower case.

Returns
The lower case version of the given text.

ConvertToUpperCase
[Link](text)

Converts the given text to upper case.

text
The text to convert to upper case.

Returns
The upper case version of the given text.

GetCharacter
[Link](characterCode)

Given the unicode character code, gets the corresponding character, which can then be used with regular text.
characterCode
The character code (Unicode based) for the required character.

Returns
A unicode character that corresponds to the code specified.

GetCharacterCode
[Link](character)

Given a unicode character, gets the corresponding character code.

character
The character whose code is requested.

Returns
A unicode based code that corresponds to the character specified.

Timer
The Timer object provides an easy way for doing something repeatedly with a constant interval between.

Properties
Interval
[Link]

Gets or sets the interval (in milliseconds) specifying how often the timer should raise the Tick event. This value can range from 10 to 100000000

Events
Tick
[Link]

Raises an event when the timer ticks.

Operations
Pause
[Link]()

Pauses the timer. Tick events will not be raised.

Returns
Nothing

Resume
[Link]()

Resumes the timer from a paused state. Tick events will now be raised.
Returns
Nothing

Turtle
The Turtle provides Logo-like functionality to draw shapes by manipulating the properties of a pen like and drawing primitives.

Properties
Speed
[Link]

Specifies how fast the turtle should move. Valid values are 1 to 10. If Speed is set to 10, the turtle moves and rotates instantly. Angle
[Link]

Gets or sets the current angle of the turtle. While setting, this will turn the turtle instantly to the new angle. X
Turtle.X

Gets or sets the X location of the Turtle. While setting, this will move the turtle instantly to the new location. Y
Turtle.Y

Gets or sets the Y location of the Turtle. While setting, this will move the turtle instantly to the new location.

Operations
Show
[Link]()

Shows the Turtle to enable interactions with it.

Returns
Nothing

Hide
[Link]()

Hides the Turtle and disables interactions with it.

Returns
Nothing

PenDown
[Link]()

Sets the pen down to enable the turtle to draw as it moves.

Returns
Nothing

PenUp
[Link]()

Lifts the pen up to stop drawing as the turtle moves.

Returns
Nothing

Move
[Link](distance)

Moves the turtle to a specified distance. If the pen is down, it will draw a line as it moves.
distance
The distance to move the turtle.

Returns
Nothing

MoveTo
[Link](x, y)

Turns and moves the turtle to the specified location. If the pen is down, it will draw a line as it moves.
x
The x co-ordinate of the destination point. ordinate

y
The y co-ordinate of the destination point. ordinate

Returns
Nothing

Turn
[Link](angle)

Turns the turtle by the specified angle. Angle is in degrees and can be either positive or negative. If the angle is positive, the turtle turns to its right. If it is negative, the turtle turns to its left.
angle
The angle to turn the turtle.

Returns
Nothing

TurnRight
[Link]()

Turns the turtle 90 degrees to the right.

Returns
Nothing

TurnLeft
[Link]()

Turns the turtle 90 degrees to the left.

Returns
Nothing