ShapeRenderer

ShapeRenderer class

Предоставляет методы для визуализации человекаShape илиGroupShape в растровое или векторное изображение или в графический объект.

Чтобы узнать больше, посетитеРабота с фигурами статья документации.

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» для визуализации фигуры в графическом объекте.
    // 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