GrapeCity.Documents.Excel.Drawing.IBackgroundPicture

IBackgroundPicture Interface

Represents a background picture on a worksheet or chart sheet.

An IBackgroundPicture is a shape in the IBackgroundPictures collection returned by BackgroundPictures. In addition to the members inherited from IShape, it provides background-picture-specific settings such as transparency, image layout, and corner radius.

Namespace: GrapeCity.Documents.Excel.Drawing

Assembly: DS.Documents.Excel.dll

Syntax

public interface IBackgroundPicture : IShape, IContainer

Public Interface IBackgroundPicture
    Inherits IShape, IContainer

Examples

IBackgroundPictures backgroundPictures = worksheet.BackgroundPictures;
IBackgroundPicture picture = null;
using (MemoryStream stream = CreateSampleImageStream())
{
    picture = backgroundPictures.AddPicture(stream, ImageType.PNG, 12, 18, 120, 80);
}
picture.Transparency = 0.25;
picture.BackgroundImageLayout = ImageLayout.Center;

Properties

Name	Description
BackgroundImageLayout	Gets or sets a value that describes how an image should be stretched to fill the destination rectangle. The returned ImageLayout value controls how the background picture is arranged within its destination rectangle, such as centered, stretched, zoomed, or tiled.
CornerRadius	Gets or sets a value that describes how rounded the corners are on a rectangular die-cut, in pixels. This value applies to the rectangular clipping shape used by the background picture. A larger value produces more rounded corners.
Transparency	Gets or sets the degree of transparency of the specified picture as a value from 0.0 (opaque) through 1.0 (clear).

Name

Description

BackgroundImageLayout

Gets or sets a value that describes how an image should be stretched to fill the destination rectangle.

The returned ImageLayout value controls how the background picture is arranged within its destination rectangle, such as centered, stretched, zoomed, or tiled.

CornerRadius

Gets or sets a value that describes how rounded the corners are on a rectangular die-cut, in pixels.

This value applies to the rectangular clipping shape used by the background picture. A larger value produces more rounded corners.

Transparency

Gets or sets the degree of transparency of the specified picture as a value from 0.0 (opaque) through 1.0 (clear).