浮动对象独立于单元格网格存在，可以自由定位在工作表上的绝对位置。它们包括绘图形状、图片和图表。

命名空间

using unvell.ReoGrid.Drawing;
using unvell.ReoGrid.Drawing.Shapes;

类层次结构

FloatingObject
  └─ DrawingObject
      ├─ ShapeObject
      │   ├─ RectangleShape
      │   ├─ EllipseShape
      │   ├─ RoundedRectangleShape
      │   ├─ DiamondShape
      │   ├─ PieShape
      │   └─ BlockArcShape
      ├─ Line
      ├─ ImageObject
      └─ DrawingComponent
          └─ Chart (ColumnChart, BarChart, LineChart, etc.)

添加浮动对象

所有浮动对象通过工作表上的 FloatingObjects 集合管理：

var sheet = grid.CurrentWorksheet;

// 创建形状
var rect = new RectangleShape
{
    Location = new Graphics.Point(50, 50),
    Size = new Graphics.Size(200, 100),
    Text = "Hello ReoGrid",
};

// 添加到工作表
sheet.FloatingObjects.Add(rect);

结果：

FloatingObjects 集合

// 移除特定形状
sheet.FloatingObjects.Remove(rect);

// 移除所有浮动对象
sheet.FloatingObjects.Clear();

// 遍历所有浮动对象
foreach (var obj in sheet.FloatingObjects)
{
    Console.WriteLine($"{obj.GetType().Name}: {obj.Bounds}");
}

// 计数浮动对象
int count = sheet.FloatingObjects.Count;

通用属性（所有浮动对象）

所有浮动对象共享以下定位和大小属性：

// 位置
rect.Location = new Graphics.Point(100, 200);

// 大小
rect.Size = new Graphics.Size(300, 150);

// 同时设置
rect.Bounds = new Graphics.Rectangle(100, 200, 300, 150);

// 单独属性
rect.X = 100;
rect.Width = 300;

DrawingObject 属性

绘图对象添加了视觉样式和变换属性：

rect.RotateAngle = 45f;
rect.Visible = false;

样式

通过 Style 属性自定义外观：

IDrawingObjectStyle 属性

rect.Style.FillColor = Graphics.SolidColor.LightYellow;
rect.Style.LineColor = Graphics.SolidColor.Navy;
rect.Style.LineWidth = 2.0f;
rect.Style.LineStyle = Graphics.LineStyles.Dash;

LineStyles 枚举

形状文本样式

形状（Rectangle、Ellipse、Diamond 等）通过 IDrawingShapeObjectStyle 支持文本：

rect.Text = "Styled Shape";
rect.Style.TextColor = Graphics.SolidColor.DarkBlue;
rect.Style.HorizontalAlignment = Drawing.HorizontalAlignment.Center;
rect.Style.VerticalAlignment = Drawing.VerticalAlignment.Middle;

线条端点样式

线条对象通过 IDrawingLineObjectStyle 支持端点样式：

LineCapStyles 枚举

事件

FloatingObject 事件

选择事件

rect.SelectionChanged += (s, e) =>
{
    Console.WriteLine($"Selected: {rect.IsSelected}");
};

对象类型

绘图形状

具有填充、轮廓和文本支持的形状。有关所有形状类型及其属性，请参阅绘图形状。

浮动图片

在工作表上显示图片。请参阅浮动图片。

var image = Image.FromFile("photo.png");
var imgObj = new ImageObject(image)
{
    Location = new Graphics.Point(40, 30),
};
sheet.FloatingObjects.Add(imgObj);

图表

图表也是浮动对象。有关所有图表类型，请参阅图表。

接口层次结构

相关主题

• 绘图形状 — 所有形状类型和样式
• 浮动图片 — 向工作表添加图片
• 图表 — 图表类型和数据源