Tutorials > How to change button resources

The simplest way to change a button's resources is to use, inside 3D Button Visual Editor, the Resources tab. Additionally, you can set all of these settings at run-time by referencing the corresponding property.

Supported sound format is:

•

WAV

Supported cursor formats are:

•

CUR

•

ANI

Note: The image below has hot links to each topic shown in the graphic.

3dabm_i0000da

Item name	Description	Corresponding property

Sound played when the button is pressed	The filename or HTTP URL of the sound file played when the button is pressed.	SoundDown
Sound played when the button is released	The filename or HTTP URL of the sound file played when the button is released.	SoundUp
Sound played when the mouse enters the button area	The filename or HTTP URL of the sound file played when the mouse enters the button region.	SoundMouseOver
Sound played when the mouse leaves the button area	The filename or HTTP URL of the sound file played when the mouse leaves the button region.	SoundMouseOut
Cursor (Mouse pointer)	The filename of the cursor file displayed when the mouse is over the button.	Cursor
Preview	Preview of the current selected resource. If the resource is a sound, and the sound resource is available, it is possible to play and stop the files using the buttons below. If the resource is a cursor, and the cursor resource is available, it will be displayed here.
Play button	Starts playing the selected sound resource if available.
Stop button	Stops a playing sound resource, if any.
Browse button	Browses the current PC folders for a resource file.
Delete button	Deletes the current resource file.

At Run-time, each of these sounds can be enabled or disabled using the EnableSound method; by default all the sounds are enabled.

By default each of these sounds is played asynchronously (i.e. once the sound is launched there is no way to know when it will be performed completely): the user can change this behavior using the SetSoundSync method in conjunction with the SoundDone event.

Sounds can be also changed using SetSoundFromMemory or SetSoundFromNet methods.

Cursor can be also changed using the SetCursorFromHandle method.

NOTE

If you have created a project with 3D buttons containing one or more sounds or cursors, when this project should be transferred to a different PC you would need to copy the original files of the sounds and cursors set into the 3D button as well and, very important, they should reside inside the same absolute pathname of the original PC or, when editing again a 3D button using 3D Button Visual Editor, the editor itself wouldn't be able to locate the original files.