Spread Windows Forms 13.0 Product Documentation
FarPoint.Win Assembly / FarPoint.Win Namespace / ElementControl Class / BackgroundImage Property


In This Topic
    BackgroundImage Property (ElementControl)
    In This Topic
    Gets or sets the background image for the control.

    Gets or sets the background image for the control.

    Syntax
    'Declaration
     
    Public Overridable Shadows Property BackgroundImage As Picture
    'Usage
     
    Dim instance As ElementControl
    Dim value As Picture
     
    instance.BackgroundImage = value
     
    value = instance.BackgroundImage
    public virtual new Picture BackgroundImage {get; set;}
    Remarks

    Controls can display pictures in layers. The first layer consists of a foreground picture, next comes the content of the control, such as text and a picture, then comes the background picture, and finally, the "back" of the control, which displays the background color.

    Set this property to specify the background picture layer.

    This property is available at run time only.

    Set the ForegroundImage property to specify the foreground picture layer. Set the Picture property to specify the picture in the content layer.

    Set other features for the background picture using the following Picture class properties:

    AlignHorz
    Specifies horizontal alignment
    AlignVert
    Specifies vertical alignment
    Image
    Specifies the picture to display
    Style
    Specifies how to display the picture, such as stretched proportionally or tiled
    TransparencyColor
    Specifies what color in the picture to make transparent

    If the application changes the background picture, the BackgroundImageChanged event occurs.

    See Also