Type

LPCTSTR for Visual C++

String for Visual Basic

Syntax

object.Picture [=String]

Remarks

The filename or HTTP URL of the picture or animation file displayed on the button.

Supported bitmap formats are BMP, ICO, GIF, JPG, TIF and PNG while supported animation formats are GIF and AVI.

If the filename is an HTTP URL you can use the proprietary compressed format AMZ.

If you need to download the file from an FTP URL you can use the SetPictureFromNet method.

To make the picture background transparent use the PictureTranspMode property.

To render a picture color transparent use the PictureTranspColor property.

Notes

If you want to use AVI files, keep in mind that only simple AVI animations can be played. Specifically, the animations to be played by this control must meet the following requirements:

· There must be exactly one video stream and it must have at least one frame.

· There can be at most two streams in the file (typically the other stream, if present, is an audio stream, although the control ignores audio information).

· No palette changes are allowed in the video stream.

At design-time only the first frame of the AVI or GIF animation is displayed on the control; to see the whole animation it is necessary to run the control.

When pictures or animations are set at design-time, you do not need to distribute the pictures or animations with your application. This is because they will be included in your program at compile-time. Redistribution of images is only necessary when the images on the button will be changing at run-time.