How to: Insert and Delete Pictures
- 3 minutes to read
This example demonstrates how to use the PictureCollection.AddPicture method overloads to insert a picture into a worksheet from different sources.
The PictureCollection.GetPicturesByName method enables you to obtain all pictures with the specified name. Call the PictureCollection.GetPictureById method to find a picture by its unique ID.
Note
Spreadsheet Control for WinForms does not support pictures embedded in cells.
To remove a picture from a worksheet, use the picture’s Shape.Delete method.
From a File or Stream
Stream imageStream = Assembly.GetExecutingAssembly().GetManifestResourceStream("SpreadsheetControl_API.Pictures.x-spreadsheet.png");
SpreadsheetImageSource imageSource = SpreadsheetImageSource.FromStream(imageStream);
workbook.BeginUpdate();
// Set the measurement unit to Millimeter.
workbook.Unit = DevExpress.Office.DocumentUnit.Millimeter;
try
{
Worksheet worksheet = workbook.Worksheets[0];
// Insert a picture from a file so that its top left corner is in the specified cell.
// By default the picture is named Picture1.. PictureNN.
worksheet.Pictures.AddPicture("Pictures\\x-docserver.png", worksheet.Cells["D5"]);
// Insert a picture to fit in the specified range.
worksheet.Pictures.AddPicture("Pictures\\x-docserver.png", worksheet.Range["B2"]);
// Insert a picture from the SpreadsheetImageSource at 120 mm from the left, 80 mm from the top,
// and resize it to a width of 70 mm and a height of 20 mm, locking the aspect ratio.
worksheet.Pictures.AddPicture(imageSource, 120, 80, 70, 20, true);
// Insert the picture to be removed.
worksheet.Pictures.AddPicture("Pictures\\x-docserver.png", 0, 0);
// Remove the last inserted picture.
// Find the Picture by its name. The method returns a collection of Pictures with the same name.
Picture pic = worksheet.Pictures.GetPicturesByName("Picture 4")[0];
pic.Delete();
}
finally
{
workbook.EndUpdate();
}
From URI
string imageUri = "https://www.devexpress.com/Products/NET/Document-Server/i/Unit-Conversion.png";
// Create an image from Uri.
SpreadsheetImageSource imageSource = SpreadsheetImageSource.FromUri(imageUri, workbook);
// Set the measurement unit to point.
workbook.Unit = DevExpress.Office.DocumentUnit.Point;
workbook.BeginUpdate();
try
{
Worksheet worksheet = workbook.Worksheets[0];
// Insert a picture from the SpreadsheetImageSource at 100 pt from the left, 40 pt from the top,
// and resize it to a width of 200 pt and a height of 180 pt.
worksheet.Pictures.AddPicture(imageSource, 100, 40, 200, 180);
}
finally
{
workbook.EndUpdate();
}
See Also