Bounds

ShapeBase.Bounds property

获取或设置形状包含块的位置和大小。

public RectangleF Bounds { get; set; }

评论

设置时忽略宽高比锁定。

对于顶级形状，该值以点为单位并且相对于形状锚点。

对于组中的形状，该值采用父组的坐标空间和单位。

例子

演示如何验证包含块边界的形状。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.InsertShape(ShapeType.Line, RelativeHorizontalPosition.LeftMargin, 50,
    RelativeVerticalPosition.TopMargin, 50, 100, 100, WrapType.None);
shape.StrokeColor = Color.Orange;

// 尽管该行本身在文档页面上占用的空间很小，
// 它占据一个矩形包含块，我们可以使用“Bounds”属性确定其大小。
Assert.AreEqual(new RectangleF(50, 50, 100, 100), shape.Bounds);
Assert.AreEqual(new RectangleF(50, 50, 100, 100), shape.BoundsInPoints);

// 创建一个组形状，然后使用“Bounds”属性设置其包含块的大小。
GroupShape group = new GroupShape(doc);
group.Bounds = new RectangleF(0, 100, 250, 250);

Assert.AreEqual(new RectangleF(0, 100, 250, 250), group.BoundsInPoints);

// 创建一个矩形，验证其边界块的大小，然后将其添加到组形状中。
shape = new Shape(doc, ShapeType.Rectangle)
{
    Width = 100,
    Height = 100,
    Left = 700,
    Top = 700
};

Assert.AreEqual(new RectangleF(700, 700, 100, 100), shape.BoundsInPoints);

group.AppendChild(shape);

// 组形状的坐标平面的原点位于其包含块的左上角，
// 以及右下角的 (1000, 1000) 的 x 和 y 坐标。
// 我们的组形状大小为 250x250pt，因此组形状的坐标平面上每 4pt 一个
// 转换为文档主体坐标平面中的 1pt。
// 我们插入的每个形状的尺寸也会缩小 4 倍。
// 形状的“BoundsInPoints”属性的变化将反映这一点。
Assert.AreEqual(new RectangleF(175, 275, 25, 25), shape.BoundsInPoints);

doc.FirstSection.Body.FirstParagraph.AppendChild(group);

// 插入一个形状并将其放置在组形状包含块的边界之外。
shape = new Shape(doc, ShapeType.Rectangle)
{
    Width = 100,
    Height = 100,
    Left = 1000,
    Top = 1000
};

group.AppendChild(shape);

// 组形状在文档正文中的占用空间已增加，但包含块保持不变。
Assert.AreEqual(new RectangleF(0, 100, 250, 250), group.BoundsInPoints);
Assert.AreEqual(new RectangleF(250, 350, 25, 25), shape.BoundsInPoints);

doc.Save(ArtifactsDir + "Shape.Bounds.docx");

展示如何创建和填充组形状。

Document doc = new Document();

// 创建一个组形状。组形状可以显示子形状节点的集合。
// 在 Microsoft Word 中，单击组形状的边界内或组形状的子形状之一将
// 选择该组中的所有其他子形状，并允许我们一次缩放和移动所有形状。
GroupShape group = new GroupShape(doc);

Assert.AreEqual(WrapType.None, group.WrapType);

// 创建一个 400pt x 400pt 的组形状并将其放置在文档的浮动形状坐标原点处。
group.Bounds = new RectangleF(0, 0, 400, 400);

// 将组的内部坐标平面大小设置为 500 x 500pt。 
// 该组的左上角的 x 和 y 坐标为 (0, 0)，
// 右下角的 x 和 y 坐标为 (500, 500)。
group.CoordSize = new Size(500, 500);

// 设置组左上角的坐标为(-250,-250)。 
// 该组的中心现在的 x 和 y 坐标值为 (0, 0)，
// 右下角将位于 (250, 250)。
group.CoordOrigin = new Point(-250, -250);

// 创建一个矩形来显示该组形状的边界并将其添加到组中。
group.AppendChild(new Shape(doc, ShapeType.Rectangle)
{
    Width = group.CoordSize.Width,
    Height = group.CoordSize.Height,
    Left = group.CoordOrigin.X,
    Top = group.CoordOrigin.Y
});

// 一旦形状成为组形状的一部分，我们就可以将其作为子节点访问，然后对其进行修改。
((Shape)group.GetChild(NodeType.Shape, 0, true)).Stroke.DashStyle = DashStyle.Dash;

// 创建一个小红星并将其插入到组中。
// 将形状与组的坐标原点对齐，我们已将其移动到中心。
group.AppendChild(new Shape(doc, ShapeType.Star)
{
    Width = 20,
    Height = 20,
    Left = -10,
    Top = -10,
    FillColor = Color.Red
});

// 插入一个矩形，然后在与图像相同的位置插入一个稍小的矩形。 
// 我们添加到组中的新形状与旧形状重叠。浅蓝色矩形将部分重叠红色星星，
// 然后带有图像的形状将与浅蓝色矩形重叠，将其用作框架。
// 我们不能使用形状的“ZOrder”属性来操纵它们在组形状内的排列。 
group.AppendChild(new Shape(doc, ShapeType.Rectangle)
{
    Width = 250,
    Height = 250,
    Left = -250,
    Top = -250,
    FillColor = Color.LightBlue
});

group.AppendChild(new Shape(doc, ShapeType.Image)
{
    Width = 200,
    Height = 200,
    Left = -225,
    Top = -225
});

((Shape)group.GetChild(NodeType.Shape, 3, true)).ImageData.SetImage(ImageDir + "Logo.jpg");

// 将文本框插入组形状中。设置“Left”属性，使文本框的右边缘
// 触及组形状的右边界。设置“Top”属性，使文本框位于外部
// 组形状的边界，其顶部尺寸沿着组形状的底部边距对齐。
group.AppendChild(new Shape(doc, ShapeType.TextBox)
{
    Width = 200,
    Height = 50,
    Left = group.CoordSize.Width + group.CoordOrigin.X - 200,
    Top = group.CoordSize.Height + group.CoordOrigin.Y
});

DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertNode(group);
builder.MoveTo(((Shape)group.GetChild(NodeType.Shape, 4, true)).AppendChild(new Paragraph(doc)));
builder.Write("Hello world!");

doc.Save(ArtifactsDir + "Shape.GroupShape.docx");

也可以看看

ShapeBase.Bottom ShapeBase.BoundsInPoints