Tutorials > How to change control resources

The simplest way to change the control sounds and cursors resources is to open, at Design-time, the 3D Button Visual Editor application from inside the Visual Studio.NET IDE as described inside the chapter Editing control properties through the 3D Button Visual Editor application contained inside the How to use the product in your projects section and selecting the editor "Resources" tab.

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.

3dcm_i000101

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 Runtime, 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.

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.