Hotspot.SetProperties

Hotspot.SetProperties ( 

string ObjectName,

table  Properties )

Description

Sets the properties of a hotspot object.

Parameters

ObjectName

(string) The name of the hotspot object.

Properties

(table) A table containing the hotspot object's properties indexed by the following keys:

KEY

TYPE

DESCRIPTION

Enabled

boolean

True if the hotspot object should be enabled, false if it should not be.

X

number

The horizontal position (in pixels) of the top left corner of the hotspot object in relation to the current page.

Note: The top left corner of the current page has an X value of 0

Y

number

The vertical position (in pixels) of the top left corner of the hotspot object in relation to the current page.

Note: The top left corner of the current page has a Y value of 0

Width

number

The width (in pixels) of the hotspot object.

Height

number

The height (in pixels) of the hotspot object.

TooltipText

string

The mouseover tooltip of the hotspot object. Tip: If you want a "&" character in the text, you must enter "&&&".

Cursor

number

The mouse cursor that will be displayed when the mouse is over the hotspot object:

CONSTANT

VALUE

DESCRIPTION

CURSOR_ARROW

0

Standard mouse arrow cursor.

CURSOR_HAND

1

Hand cursor.

CURSOR_BLACK_ARROW

2

Black arrow cursor.

CURSOR_CROSSHAIR

3

Crosshair cursor.

CURSOR_EXPLORE

4

Explore cursor.

CURSOR_HELP

5

Help cursor.

CURSOR_MAGNIFY

6

Magnify cursor.

CURSOR_MEDIA

7

Media cursor.

CURSOR_MONEY

8

Money cursor.

CURSOR_NOTEPAD

9

Notepad cursor.

CURSOR_PENCIL

10

Pencil cursor.

CURSOR_PRINTER

11

Printer cursor.

CURSOR_SPEAKER

12

Speaker cursor.

CURSOR_UP_ARROW

13

Up arrow cursor.

HighlightSound

number

The type of sound that will be played when the mouse moves over the hotspot object.

CONSTANT

VALUE

DESCRIPTION

SND_NONE

0

No highlight sound.

SND_STANDARD

1

Standard highlight sound.

SND_CUSTOM

2

Custom highlight sound.

HighlightSoundFile

string

The path to the hotspot object's custom highlight sound file.  If the hotspot object does not use a custom sound, this value will be an empty string ("").

Note: For this to take effect, HighlightSound must be set to SND_CUSTOM.

ClickSound

number

The type of sound that will be played when the mouse clicks the hotspot object.

CONSTANT

VALUE

DESCRIPTION

SND_NONE

0

No click sound.

SND_STANDARD

1

Standard click sound.

SND_CUSTOM

2

Custom click sound.

ClickSoundFile

string

The path to the hotspot object's custom click sound file.  If the hotspot object does not use a custom sound, this value will be an empty string ("").

Note: For this to take effect, ClickSound must be set to SND_CUSTOM.

 

Returns

Nothing. You can use Application.GetLastError to determine whether this action failed, and why.

See also:  Related Actions