FloatingObject.Placement Property
Gets or sets the behavior of the floating object regarding the cells below.
Namespace: DevExpress.Spreadsheet
Assembly: DevExpress.Spreadsheet.v24.2.Core.dll
NuGet Package: DevExpress.Spreadsheet.Core
#Declaration
#Property Value
Type | Description |
---|---|
Placement | A Placement enumeration value specifying how the floating object should behave when the underlying cells are resized or moved. |
Available values:
Name | Description |
---|---|
Move |
The object (picture) moves and sizes with the underlying cells. |
Move | The object (picture) moves with the underlying cells. |
Free |
The object (picture) does not move or size with cells. |
#Example
// Set the measurement unit to Millimeter.
workbook.Unit = DevExpress.Office.DocumentUnit.Millimeter;
workbook.Worksheets.ActiveWorksheet.DefaultRowHeight = 20;
workbook.Worksheets.ActiveWorksheet.DefaultColumnWidth = 20;
workbook.BeginUpdate();
try
{
Worksheet worksheet = workbook.Worksheets[0];
// Insert pictures.
Picture pic = worksheet.Pictures.AddPicture("Pictures\\x-spreadsheet.png", worksheet.Cells["A1"]);
worksheet.Pictures.AddPicture("Pictures\\x-spreadsheet.png", worksheet.Cells["A1"]);
// Specify picture name.
pic.Name = "Logo";
pic.AlternativeText = "Spreadsheet logo";
// Move a picture.
pic.Move(30, 50);
// Move and size the picture with underlying cells.
pic.Placement = Placement.MoveAndSize;
worksheet.Rows[1].Height += 20;
worksheet.Columns["D"].Width += 20;
// Move another picture to illustrate OffsetX, OffsetY properties.
worksheet.Pictures[1].Move(pic.OffsetY, pic.OffsetX);
}
finally
{
workbook.EndUpdate();
}
#Related GitHub Examples
The following code snippets (auto-collected from DevExpress Examples) contain references to the Placement property.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.