New! This sample shows how to create an XForm object from scratch. You can think of such an object as a template, that, once created, can be drawn frequently anywhere in your PDF document.

// Create a new PDF document
PdfDocument document = new PdfDocument();
 
// Create a font
XFont font = new XFont("Verdana", 16);
 
// Create a new page
PdfPage page = document.AddPage();
XGraphics gfx = XGraphics.FromPdfPage(page);
gfx.DrawString("XPdfForm Sample", font, 
  XBrushes.DarkGray, 15, 25, XStringFormat.Default);
 
// Step 1: Create an XForm and draw some graphics on it
 
// Create an empty XForm object with the specified width and height
// A form is bound to its target document when it is created. The reason is 
// that the form can share fonts and other objects with its target document.
XForm form = 
  new XForm(document, XUnit.FromMillimeter(70), XUnit.FromMillimeter(55));
 
// Create an XGraphics object for drawing the contents of the form.
XGraphics formGfx = XGraphics.FromForm(form);
 
// Draw a large transparent rectangle to visualize the area the form occupies
XColor back = XColors.Orange;
back.A = 0.2;
XSolidBrush brush = new XSolidBrush(back);
formGfx.DrawRectangle(brush, -10000, -10000, 20000, 20000);
 
 
// On a form you can draw...
 
// ... text
formGfx.DrawString("Text, Graphics, Images, and Forms", 
  new XFont("Verdana", 10, XFontStyle.Regular), XBrushes.Navy, 3, 0, 
            XStringFormat.TopLeft);
XPen pen = XPens.LightBlue.Clone();
pen.Width = 2.5;
 
// ... graphics like Bézier curves
formGfx.DrawBeziers(pen, XPoint.ParsePoints("30,120 80,20, 100,140 175,33.3"));
 
// ... raster images like GIF files
XGraphicsState state = formGfx.Save();
formGfx.RotateAtTransform(17, new XPoint(30, 30));
formGfx.DrawImage(XImage.FromFile("../../../../XGraphicsLab/images/Test.gif"), 
  20, 20);
formGfx.Restore(state);
 
// ... and forms like XPdfForm objects
state = formGfx.Save();
formGfx.RotateAtTransform(-8, new XPoint(165, 115));
formGfx.DrawImage(XPdfForm.FromFile("../../../../PDFs/SomeLayout.pdf"), 
  new XRect(140, 80, 50, 50 * Math.Sqrt(2)));
formGfx.Restore(state);
 
// When you finished drawing on the form, dispose the XGraphic object.
formGfx.Dispose();
 
 
// Step 2: Draw the XPdfForm on your PDF page like an image
 
// Draw the form on the page of the document in its original size
gfx.DrawImage(form, 20, 50);
 
// Draw it stretched
gfx.DrawImage(form, 300, 100, 250, 40);
 
// Draw and rotate it
int d = 25;
for (int idx = 0; idx < 360; idx += d)
{
  gfx.DrawImage(form, 300, 480, 200, 200);
  gfx.RotateAtTransform(d, new XPoint(300, 480));
}
 
// Save the document...
string filename = "XForms.pdf";
document.Save(filename);
// ...and start a viewer.
Process.Start(filename);