Attach a file to an annotation in C# .NET

To add a file in a form of a PDF annotation, follow these steps:

Create a GdPicturePDF object.
Load the PDF file with the LoadFromFile method.
Set the origin of the coordinate system with the SetOrigin method. This method requires a member of the PDFOrigin enumeration.
Set the measurement unit with the SetMeasurementUnit method to specify the annotation’s dimensions and position. This method uses a member of the PdfMeasurementUnit enumeration.
Select the PDF page to place the annotation on using the SelectPage method.
Load the file to a byte array.
Add the annotation with the attached file using the AddFileAttachmentAnnot method. This method uses the following parameters:
- Left — The X coordinate of the top-left corner.
- Top — The Y coordinate of the top-left corner.
- Width — The width of the annotation icon.
- Height — The height of the annotation icon.
- Data — The content of the file associated with the annotation object, which is expressed as a binary array.
- FileName — The full path to the attached file.
- Title — The title of the newly added annotation object. By convention, this represents the author of the annotation.
- Description — The description of the file associated with the annotation object.
- The annotation icon’s color expressed in one of the following ways:
  - Red, Green, Blue — RGB values (from 0 to 255).
  - Cyan, Magenta, Yellow, Black — CMYK values (from 0 to 255).
  - Color object — For more information, refer to the color object guide.
- Opacity — The opacity value of the annotation, where 0 means full transparency and 1 means fully visible. Use the f suffix to convert the double value to float (0.75f).
- AnnotIcon — The icon type displayed. It uses the PdfFileAttachmentAnnotIcon enumeration. The possible values are the following:
  - None
  - Graph
  - Tag
  - Paperclip
  - PushPin
Save the PDF document to a file with the SaveToFile method.

To add a file as an annotation to the last page of a PDF, use the following code:

using GdPicturePDF gdpicturePDF = new GdPicturePDF();
string filename = @"C:\temp\source.txt";
gdpicturePDF.LoadFromFile(@"C:\temp\source.pdf");
// Set the origin of the coordinate system to the bottom-left corner.
gdpicturePDF.SetOrigin(PdfOrigin.PdfOriginBottomLeft);
// Set the measurement unit to centimeters.
gdpicturePDF.SetMeasurementUnit(PdfMeasurementUnit.PdfMeasurementUnitCentimeter);
// Load the file as a binary array.
byte[] data = File.ReadAllBytes(filename);
// Select the page to attach the file to.
gdpicturePDF.SelectPage(gdpicturePDF.GetPageCount());
// Add an annotation with the file.
gdpicturePDF.AddFileAttachmentAnnot(Left: 5, Top: 5, Width: 2, Height: 4,
    data, filename, "Nutrient", "Attachment for review",
    173, 216, 230, 0.75f, PdfFileAttachmentAnnotIcon.Paperclip);
gdpicturePDF.SaveToFile(@"C:\temp\output.pdf");

Using gdpicturePDF As GdPicturePDF = New GdPicturePDF()
    Dim filename = "C:\temp\source.txt"
    gdpicturePDF.LoadFromFile("C:\temp\source.pdf")
    ' Set the origin of the coordinate system to the bottom-left corner.
    gdpicturePDF.SetOrigin(PdfOrigin.PdfOriginBottomLeft)
    ' Set the measurement unit to centimeters.
    gdpicturePDF.SetMeasurementUnit(PdfMeasurementUnit.PdfMeasurementUnitCentimeter)
    ' Load the file as a binary array.
    Dim data = File.ReadAllBytes(filename)
    ' Select the page to attach the file to.
    gdpicturePDF.SelectPage(gdpicturePDF.GetPageCount())
    ' Add an annotation with the file.
    gdpicturePDF.AddFileAttachmentAnnot(Left:=5, Top:=5, Width:=2, Height:=4,
        data, filename, "Nutrient", "Attachment for review",
        173, 216, 230, 0.75F, PdfFileAttachmentAnnotIcon.Paperclip)
    gdpicturePDF.SaveToFile("C:\temp\output.pdf")
End Using

Used methods

Related topics

To add an image in a form of a PDF annotation, follow these steps:

Create a GdPicturePDF object.
Load the PDF file with the LoadFromFile method.
Set the origin of the coordinate system with the SetOrigin method. This method requires a member of the PDFOrigin enumeration.
Set the measurement unit with the SetMeasurementUnit method to specify the annotation’s dimensions and position. This method uses a member of the PdfMeasurementUnit enumeration.
Select the PDF page to place the annotation on using the SelectPage method.
Load the image to a byte array.
Add the annotation with the attached image using the AddFileAttachmentAnnot method. This method uses the following parameters:
- Left — The X coordinate of the top-left corner.
- Top — The Y coordinate of the top-left corner.
- Width — The width of the annotation icon.
- Height — The height of the annotation icon.
- Data — The content of the image associated with the annotation object, which is expressed as a binary array.
- FileName — The full path to the attached image.
- Title — The title of the newly added annotation object. By convention, this represents the author of the annotation.
- Description — The description of the file associated with the annotation object.
- The annotation icon’s color expressed in one of the following ways:
  - Red, Green, Blue — RGB values (from 0 to 255).
  - Cyan, Magenta, Yellow, Black — CMYK values (from 0 to 255).
  - Color object — For more information, refer to the color object guide.
- Opacity — The opacity value of the annotation, where 0 means full transparency and 1 means fully visible. Use the f suffix to convert the double value to float (0.75f).
- AnnotIcon — The icon type displayed. It uses the PdfFileAttachmentAnnotIcon enumeration. The possible values are the following:
  - None
  - Graph
  - Tag
  - Paperclip
  - PushPin
Save the PDF document to a file with the SaveToFile method.

To add an image as an annotation to the last page of a PDF, use the following code:

using GdPicturePDF gdpicturePDF = new GdPicturePDF();
string filename = @"C:\temp\source.jpg";
gdpicturePDF.LoadFromFile(@"C:\temp\source.pdf");
// Set the origin of the coordinate system to the bottom-left corner.
gdpicturePDF.SetOrigin(PdfOrigin.PdfOriginBottomLeft);
// Set the measurement unit to centimeters.
gdpicturePDF.SetMeasurementUnit(PdfMeasurementUnit.PdfMeasurementUnitCentimeter);
// Load the image as a binary array.
byte[] data = File.ReadAllBytes(filename);
// Select the page to attach the image to.
gdpicturePDF.SelectPage(gdpicturePDF.GetPageCount());
// Add an annotation with the image.
gdpicturePDF.AddFileAttachmentAnnot(Left: 5, Top: 5, Width: 2, Height: 4,
    data, filename, "Nutrient", "Attachment for review",
    173, 216, 230, 0.75f, PdfFileAttachmentAnnotIcon.Paperclip);
gdpicturePDF.SaveToFile(@"C:\temp\output.pdf");

Using gdpicturePDF As GdPicturePDF = New GdPicturePDF()
    Dim filename = "C:\temp\source.jpg"
    gdpicturePDF.LoadFromFile("C:\temp\source.pdf")
    ' Set the origin of the coordinate system to the bottom-left corner.
    gdpicturePDF.SetOrigin(PdfOrigin.PdfOriginBottomLeft)
    ' Set the measurement unit to centimeters.
    gdpicturePDF.SetMeasurementUnit(PdfMeasurementUnit.PdfMeasurementUnitCentimeter)
    ' Load the image as a binary array.
    Dim data = File.ReadAllBytes(filename)
    ' Select the page to attach the image to.
    gdpicturePDF.SelectPage(gdpicturePDF.GetPageCount())
    ' Add an annotation with the image.
    gdpicturePDF.AddFileAttachmentAnnot(Left:=5, Top:=5, Width:=2, Height:=4,
        data, filename, "Nutrient", "Attachment for review",
        173, 216, 230, 0.75F, PdfFileAttachmentAnnotIcon.Paperclip)
    gdpicturePDF.SaveToFile("C:\temp\output.pdf")
End Using

Used methods

Related topics