DisabledPicture Property

Gets or sets the image file to be displayed in a form or control when it is in the disabled state. Available at design time and run time.

object.DisabledPicture = [picture]

Where object is an object expression that evaluates to one of the controls in the Applies To list, and picture is a string expression specifying a file containing the graphic.

Client support

Newlook Smartclient

Newlook Server

Use

This property is useful if you want to visually indicate to a user that a control is disabled (its enabled property is set to false).

Note:

For the menu button control only, the DisabledPicture and DownPicture properties will only be applied if the Picture property is also set. If there is no image specified in the Picture property (the control is using the default picture), then the DisabledPicture and DownPicture properties will be ignored.

This property supports SVG, PNG, JPEG, GIF (including animated GIFs), BMP and ICO file types.

The image specified can be a local file or one stored on an http or ftp server.

Specifying a local file

If you are specifying a local file, the image path should be relative to the Newlook solution path, C:\ProgramData\Newlook 11.1.

For example if your image, Banner.png, was located in the folder C:\ProgramData\Newlook 11.1\@MySolution\Images, then you would specify the path @MySolution\Images\Banner.png.

If your image file is located outside the Newlook solution folder then the full path must be specified.

IMPORTANT:

For Smartclient deployments, it is important to note that any image file must reside in the same location on any user machine that you deploy your solution to. For this reason it is highly recommended that any images referenced in your solution are stored within your Solution folder.

Specifying a file on a http or ftp server

To use a file on an http or ftp server, you will need to specify the full URL for the file, for example:

http://www.looksoftware.com/Images/ManWithHat.svg

This property may be specified as an expression in Designer, by preceding the expression with an equals (=) sign. The expression will be evaluated when the Form is initialized, and the property will be set to the result of the evaluation.

Applies To

Command button control

PictureBox control

Menu button control