Methods > SetPictureFromNet method

Remarks

Changes one of the pictures at run-time, downloading a picture file from the Internet.

Accepted extensions for the file are BMP, PNG, GIF, JPG or AMZ. If no extension is provided, the control will in any case try to load the file.

When the download ends a PictureDLLDone event is generated (also in case of failure).

Syntax

Visual Basic

control.SetPictureFromNet (index as enumPictures, URL as string, username as string, password as string) as integer

Visual C++

BOOL control.SetPictureFromNet (long index, LPCTSTR URL, LPCTSTR username, LPCTSTR password);

Parameter

Description

index

Numerical value that represents the index of the picture property to change. Supported values are the following:

Mnemonic constant	Value	Meaning
PICTURE_NORMAL	0	Changes the Picture property
PICTURE_PRESSED	1	Changes the PicturePressed property
PICTURE_MOUSEOVER	2	Changes the PictureMouseOver property
PICTURE_CUSTOM	3	Changes the PictureCustom property
PICTURE_TEXTURE	4	Changes the Texture.Filepath property
PICTURE_DISABLED	5	Changes the PictureDisabled property
PICTURE_SPLIT_BUTTON	6	Changes the SplitButtonPicture property

URL

String that specifies the Internet address from which the picture file will be loaded; only URLs beginning with ftp: or http: are supported.

username

String that specifies the name of the user to log in. Useful only if the URL is FTP.

password

String that specifies the password to use to log in. Useful only if the URL is FTP.

Return value

Value	Meaning

FALSE	The operation failed
TRUE	The operation was successful