ShapeRenderer

ShapeRenderer class

提供渲染个体的方法Shape或者GroupShape 到光栅或矢量图像或 Graphics 对象。

要了解更多信息，请访问使用形状文档文章。

public class ShapeRenderer : NodeRendererBase

构造函数

姓名描述
ShapeRenderer(ShapeBase)初始化此类的新实例。

特性

姓名描述
BoundsInPoints { get; }获取形状的实际边界（以点为单位）。
OpaqueBoundsInPoints { get; }获取形状的不透明边界（以点为单位）。
SizeInPoints { get; }获取形状的实际大小（以磅为单位）。

方法

姓名描述
GetBoundsInPixels(float, float)计算指定缩放系数和分辨率的形状边界（以像素为单位）。
GetBoundsInPixels(float, float, float)计算指定缩放系数和分辨率的形状边界（以像素为单位）。
GetOpaqueBoundsInPixels(float, float)计算指定缩放系数和分辨率的形状的不透明边界（以像素为单位）。
GetOpaqueBoundsInPixels(float, float, float)计算指定缩放系数和分辨率的形状的不透明边界（以像素为单位）。
GetSizeInPixels(float, float)计算指定缩放系数和分辨率下形状的大小（以像素为单位）。
GetSizeInPixels(float, float, float)计算指定缩放系数和分辨率下形状的大小（以像素为单位）。
RenderToScale(Graphics, float, float, float)将形状渲染为Graphics 对象达到指定比例。
RenderToSize(Graphics, float, float, float, float)将形状渲染为Graphics 对象到指定大小。
Save(Stream, ImageSaveOptions)将形状渲染为图像并保存到流中。
Save(string, ImageSaveOptions)将形状渲染为图像并保存到文件中。

例子

演示如何使用 Graphics 对象渲染形状并使用 Windows 窗体显示它。

public void RenderShapesOnForm()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    ShapeForm shapeForm = new ShapeForm(new Size(1017, 840));

    // 下面是使用“ShapeRenderer”类将形状渲染到 Graphics 对象的两种方法。
    // 1 - 创建带有图表的形状，并将其渲染为特定比例。
    Chart chart = builder.InsertChart(ChartType.Pie, 500, 400).Chart;
    chart.Series.Clear();
    chart.Series.Add("Desktop Browser Market Share (Oct. 2020)",
        new[] { "Google Chrome", "Apple Safari", "Mozilla Firefox", "Microsoft Edge", "Other" },
        new[] { 70.33, 8.87, 7.69, 5.83, 7.28 });

    Shape chartShape = (Shape)doc.GetChild(NodeType.Shape, 0, true);

    shapeForm.AddShapeToRenderToScale(chartShape, 0, 0, 1.5f);

    // 2 - 创建一个形状组，并将其渲染为特定大小。
    GroupShape group = new GroupShape(doc);
    group.Bounds = new RectangleF(0, 0, 100, 100);
    group.CoordSize = new Size(500, 500);

    Shape subShape = new Shape(doc, ShapeType.Rectangle);
    subShape.Width = 500;
    subShape.Height = 500;
    subShape.Left = 0;
    subShape.Top = 0;
    subShape.FillColor = Color.RoyalBlue;
    group.AppendChild(subShape);

    subShape = new Shape(doc, ShapeType.Image);
    subShape.Width = 450;
    subShape.Height = 450;
    subShape.Left = 25;
    subShape.Top = 25;
    subShape.ImageData.SetImage(ImageDir + "Logo.jpg");
    group.AppendChild(subShape);

    builder.InsertNode(group);

    GroupShape groupShape = (GroupShape)doc.GetChild(NodeType.GroupShape, 0, true);
    shapeForm.AddShapeToRenderToSize(groupShape, 880, 680, 100, 100);

    shapeForm.ShowDialog();
}

/// <summary>
/// 渲染并显示形状列表。
/// </summary>
private class ShapeForm : Form
{
    public ShapeForm(Size size)
    {
        Size = size;
        mShapesToRender = new List<KeyValuePair<ShapeBase, float[]>>();
    }

    public void AddShapeToRenderToScale(ShapeBase shape, float x, float y, float scale)
    {
        mShapesToRender.Add(new KeyValuePair<ShapeBase, float[]>(shape, new[] {x, y, scale}));
    }

    public void AddShapeToRenderToSize(ShapeBase shape, float x, float y, float width, float height)
    {
        mShapesToRender.Add(new KeyValuePair<ShapeBase, float[]>(shape, new[] {x, y, width, height}));
    }

    protected override void OnPaint(PaintEventArgs e)
    {
        foreach (KeyValuePair<ShapeBase, float[]> renderingArgs in mShapesToRender)
            if (renderingArgs.Value.Length == 3)
                RenderShapeToScale(renderingArgs.Key, renderingArgs.Value[0], renderingArgs.Value[1],
                    renderingArgs.Value[2]);
            else if (renderingArgs.Value.Length == 4)
                RenderShapeToSize(renderingArgs.Key, renderingArgs.Value[0], renderingArgs.Value[1],
                    renderingArgs.Value[2], renderingArgs.Value[3]);
    }

    private void RenderShapeToScale(ShapeBase shape, float x, float y, float scale)
    {
        ShapeRenderer renderer = new ShapeRenderer(shape);
        using (Graphics formGraphics = CreateGraphics())
        {
            renderer.RenderToScale(formGraphics, x, y, scale);
        }
    }

    private void RenderShapeToSize(ShapeBase shape, float x, float y, float width, float height)
    {
        ShapeRenderer renderer = new ShapeRenderer(shape);
        using (Graphics formGraphics = CreateGraphics())
        {
            renderer.RenderToSize(formGraphics, x, y, width, height);
        }
    }

    private readonly List<KeyValuePair<ShapeBase, float[]>> mShapesToRender;
}

也可以看看

PrinterSettingsContainer Class ThumbnailGeneratingOptions Class