ShapeRenderer
Innehåll
[
Dölj
]ShapeRenderer class
Tillhandahåller metoder för att rendera en individShape
ellerGroupShape
till en raster- eller vektorbild eller till ett grafikobjekt.
För att lära dig mer, besökArbeta med former dokumentationsartikel.
public class ShapeRenderer : NodeRendererBase
Konstruktörer
namn | Beskrivning |
---|---|
ShapeRenderer(ShapeBase) | Initierar en ny instans av den här klassen. |
Egenskaper
namn | Beskrivning |
---|---|
BoundsInPoints { get; } | Får formens faktiska gränser i poäng. |
OpaqueBoundsInPoints { get; } | Får de ogenomskinliga gränserna för formen i punkter. |
SizeInPoints { get; } | Får den faktiska storleken på formen i poäng. |
Metoder
namn | Beskrivning |
---|---|
GetBoundsInPixels(float, float) | Beräknar formens gränser i pixlar för en angiven zoomfaktor och upplösning. |
GetBoundsInPixels(float, float, float) | Beräknar formens gränser i pixlar för en angiven zoomfaktor och upplösning. |
GetOpaqueBoundsInPixels(float, float) | Beräknar de ogenomskinliga gränserna för formen i pixlar för en angiven zoomfaktor och upplösning. |
GetOpaqueBoundsInPixels(float, float, float) | Beräknar de ogenomskinliga gränserna för formen i pixlar för en angiven zoomfaktor och upplösning. |
GetSizeInPixels(float, float) | Beräknar storleken på formen i pixlar för en angiven zoomfaktor och upplösning. |
GetSizeInPixels(float, float, float) | Beräknar storleken på formen i pixlar för en angiven zoomfaktor och upplösning. |
RenderToScale(Graphics, float, float, float) | Gör formen till enGraphics objekt i en angiven skala. |
RenderToSize(Graphics, float, float, float, float) | Gör formen till enGraphics objekt till en angiven storlek. |
Save(Stream, ImageSaveOptions) | Gör formen till en bild och sparar den i en ström. |
Save(string, ImageSaveOptions) | Gör formen till en bild och sparar den i en fil. |
Exempel
Visar hur man renderar en form med ett grafikobjekt och visar det med ett Windows-formulär.
public void RenderShapesOnForm()
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
ShapeForm shapeForm = new ShapeForm(new Size(1017, 840));
// Nedan finns två sätt att använda klassen "ShapeRenderer" för att rendera en form till ett grafikobjekt.
// 1 - Skapa en form med ett diagram och rendera den till en specifik skala.
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 - Skapa en formgrupp och rendera den till en specifik storlek.
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>
/// Återger och visar en lista med former.
/// </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;
}
Se även
- class NodeRendererBase
- namnutrymme Aspose.Words.Rendering
- hopsättning Aspose.Words