HeaderPane
Main
Hide
Share Link
Print

ImageBackgroundDisabled Property, SftButton Object

Defines the background image when the button is disabled.

Syntax

Get

C#SftPictureObject refImageObj = object.ImageBackgroundDisabled;
VB.NETrefImageObj = object.ImageBackgroundDisabled As SftPictureObject
C++ISftPictureObject* refImageObj = object->ImageBackgroundDisabled;
ISftPictureObject* refImageObj = object->GetImageBackgroundDisabled();
CHRESULT object->get_ImageBackgroundDisabled(ISftPictureObject** refImageObj);
VBSet refImageObj = object.ImageBackgroundDisabled As SftPictureObject

Put

C#SftPictureObject object.ImageBackgroundDisabled = refImageObj;
VB.NETobject.ImageBackgroundDisabled = refImageObj As SftPictureObject
C++ISftPictureObject* object->ImageBackgroundDisabled = refImageObj;
void object->PutImageBackgroundDisabled(ISftPictureObject* refImageObj);
CHRESULT object->put_ImageBackgroundDisabled(ISftPictureObject* refImageObj);
VBobject.ImageBackgroundDisabled = refImageObj As SftPictureObject

object

A SftButton object.

refImageObj

Defines the background image when the button is disabled.

Comments

The ImageBackgroundDisabled property defines the background image when the button is disabled.

Each button control offers an optional background image, which is always displayed centered within the available space inside the button. Other components of the button, like the attributes defined using the Text, Image1 or Image2 properties, simply overlay the background image.

Depending on the button state, the background image defined using the ImageBackground, ImageBackgroundDisabled, ImageBackgroundHover or ImageBackgroundPressed is displayed.

The background image is not displayed in the drop down portion of a drop down button.

See Also SftButton Object | Object Hierarchy


Last Updated 11/03/2026 - (email)
© 2026 Softel vdm, Inc.