DisabledPicture Property
Collapse the table of content
Expand the table of content

Visual Basic Reference

Visual Studio 6.0

DisabledPicture Property

See Also    Example    Applies To

Returns or sets a reference to a picture to display in a control when it is disabled. (That is, when its Enabled property is set to False.)


object.DisabledPicture [= picture]

The DisabledPicture property syntax has these parts:

Part Description
object An object expression that evaluates to an object in the Applies To list.
picture A Picture object containing a graphic, as described in Settings.


The settings for picture are:

Setting Description
(None) (Default) No picture.
(Bitmap, icon, metafile) Specifies a graphic. You can load the graphic from the Properties window at design time. At run time, you can also set this property by using the LoadPicture function on a bitmap, icon, or metafile, or by setting it to the Picture property of another control.


The DisabledPicture property specifies a picture object to display when the control (such as a CommandButton) is disabled. The DisabledPicture property is ignored unless the Style property of the control is set to 1 (graphical).

The picture is centered horizontally and vertically on the control. If there is a caption as well as a picture, the picture is centered above the caption. If the picture object is too large to fit on the control, then it is clipped.

If no picture is assigned to the DisabledPicture property, but one is assigned to the Picture property, then a grayed version of that picture is displayed when the control is disabled.

© 2016 Microsoft