Working with custom stamp annotations

17 Mar 202210 minutes to read

PDF Viewer allows you to include any form of Xamarin.iOS UIView that is Button, Entry, Label, Image and more anywhere in the pages of the PDF Viewer as custom stamp annotation. You can perform operations like add, move, resize, and delete the custom stamp annotations. Also, you can save and load the existing custom stamp annotation that is associated with the PDF document

Add a custom stamp

The custom stamps can be added using the AddAnnotation or AddStamp methods.

//Add custom stamp/view
pdfViewer.AddAnnotation(StampAnnotation stampAnnotation)

//Add custom stamp/view to the specified page
pdfViewer.AddStamp(View view, int pageNumber)

//Add custom stamp/view to the specified page and position as Point object
pdfViewer.AddStamp(View view, int pageNumber, Point position)

//Add custom stamp/view to the specified page and position as Rectangle object
pdfViewer.AddStamp(View view, int pageNumber, Rectangle bounds)

A typical example of the custom stamp in the real world includes, adding an image as custom stamp. PDF Viewer provides option to add any user defined signature or seal image as custom stamp to the PDF document. The following code sample explains the same.

private void Button_Clicked(object sender, EventArgs e)
{
    //Set image source
    Image image = new Image();
    image.Source = ImageSource.FromResource("Sample.Assets.Logo.png", typeof(App).GetTypeInfo().Assembly);
    image.WidthRequest = 200;
    image.HeightRequest = 100;

    //Method 1: Add image as custom stamp to the first page using `AddStamp` method
    pdfViewer.AddStamp(image, 1);
	
	//Method 2: Create a stamp annotation instance and add using `AddAnnotation` method
	//StampAnnotation stampAnnotation = new StampAnnotation(image, 1, new Rectangle(100, 100, 100, 100));
	//pdfViewer.AddAnnotation(stampAnnotation);  	
}

The StampAnnotationAdded event will be raised when custom stamp annotations are added in the PDF document.

pdfViewer.StampAnnotationAdded += PdfViewer_StampAnnotationAdded;

Select a custom stamp

You can select a custom stamp annotation by tapping on it and this action is followed by the appearance of the selector around the custom stamp annotation. The StampAnnotationSelected event will be raised when custom stamp annotations are selected in the PDF document.

pdfViewer.StampAnnotationSelected += PdfViewer_StampAnnotationSelected;

The StampAnnotationSelectedEventArgs properties of the selected custom stamp annotation includes page number and bounds information. The following code sample explains this.

private void PdfViewer_StampAnnotationSelected(object sender, StampAnnotationSelectedEventArgs e)
{
    //Gets the page number of selected stamp annotation
    int pageNumber = e.PageNumber;

    //Gets the bounds of selected stamp annotation
    Rectangle bounds = e.Bounds;
}

Also, tapping a custom stamp annotation selects it or deselects if it is already selected. Tapping a custom stamp annotation will raise the StampAnnotationTapped event.

pdfViewer.ShapeAnnotationTapped += PdfViewer_ShapeAnnotationTapped;

Select a custom stamp annotation programmatically

By SelectAnnotation method, You can select the custom stamp annotation programmatically. The specified custom stamp annotation object passed as a parameter.

The following code sample illustrates the same.

//Selects the specified stamp annotation
pdfViewer.SelectAnnotation(stampAnnotation);

NOTE

Once SelectAnnotation method is called and as long as the annotation stays selected, the SelectedAnnotation property will return the same instance as the parameter of this method.

Deselect a custom stamp

You can deselect a selected custom stamp annotation by tapping on it or somewhere else on the PDF document. Deselection of a custom stamp annotation can be detected using the StampAnnotationDeselected event.

pdfViewer.StampAnnotationDeselected += PdfViewer_StampAnnotationDeselected;

Deselect a custom stamp annotation programmatically

By DeselectAnnotation method , You can deselect the custom stamp annotation programmatically. The specified custom stamp annotation object passed as a parameter.

The following code sample illustrates the same.

//Deselects the specified stamp annotation
pdfViewer.DeselectAnnotation(StampAnnotation);

NOTE

There is no effect in Calling DeselectAnnotation method, if the given annotation is not selected. Once this method is called, the SelectedAnnotation property will return null until any other annotation gets selected.

Move or resize a custom stamp

Select the custom stamp annotation to move or resize it. After the selector appears around the custom stamp annotation, drag it to move to a new location by tapping anywhere inside the selector. Similarly, drag the selector corner handle(s) to resize the selected custom stamp annotation. The StampAnnotationMovedOrResized event will be raised when you move or resize the selected annotation.

pdfViewer.StampAnnotationMovedOrResized += PdfViewer_StampAnnotationMovedOrResized;

The StampAnnotationMovedOrResizedEventArgs properties of the moved or resized custom stamp annotation includes page number, old bounds, and new bounds information. The following code sample explains this.

private void PdfViewer_StampAnnotationMovedOrResized(object sender, StampAnnotationMovedOrResizedEventArgs e)
{
    //Get the page number of selected stamp annotation
    int pageNumber = e.PageNumber;

    //Get the old bounds of selected stamp annotation
    Rectangle oldBounds = e.OldBounds;

    //Get the new bounds of selected stamp annotation
    Rectangle newBounds = e.NewBounds;
}

How to Customize the Minimum size of the Custom Stamp Annotations?

By the MinimumSize property, You can set the minimum size to which the custom stamp annotations could be resized.

Refer the following code example:

//Sets the minimum size for the custom stamp annotations
pdfViewer.AnnotationSettings.Stamp.MinimumSize = new CGSize(10, 10);

Delete a custom stamp

When you select the custom stamp annotation, delete icon will appear on the bottom toolbar. By clicking that delete icon, the selected custom stamp annotation can be removed. The StampAnnotationRemoved event will be raised when a custom stamp annotation is removed from the PDF.

pdfViewer.StampAnnotationRemoved += PdfViewer_StampAnnotationRemoved;

How to retrieve the actual view added as the stamp using the AddStamp method?

The stamp annotation view can be retrieved when the stamp is added, tapped, selected, deselected, moved, or resized, and removed from the event data parameter of the respective event handler from the CustomStampView property. The stamp view, thus retrieved, is the same instance as the one added using the AddStamp method.

Refer to the following code example. The StampAnnotationSelected event is shown for illustration purposes.

pdfViewerControl.StampAnnotationSelected += PdfViewerControl_StampAnnotationSelected;

private void PdfViewerControl_StampAnnotationSelected(object sender, StampAnnotationSelectedEventArgs e)
        {
            //Retrieves the actual view added as the stamp using the AddStamp method.
            var customStamp = e.CustomStampView;
        }

How to lock or unlock the custom stamp annotations?

To lock or unlock all the custom stamp annotation, set the IsLocked API to true or false respectively, and the following sample explains the same. But other annotation types can be moved, resized, removed or their attributes can be changed.

//Disable the custom stamp annotation interaction such as move, resize, remove, and attributes changes.
pdfViewerControl.AnnotationSettings.Stamp.IsLocked = true;

Interactions with custom stamp annotation types such as move, resize, remove or attribute changes will be allowed only if the SfPdfViewer.AnnotationSettings.IsLocked API is set to false. The following code prevents the unlocking of the custom stamp annotations, although the IsLocked property of the custom stamp annotation is set to false.

//Disable the custom stamp annotation interaction, though its 'IsLocked' property is set to ‘false’ .
pdfViewerControl.AnnotationSettings.IsLocked = true;
pdfViewerControl.AnnotationSettings.Stamp.IsLocked = false;

How to enable or disable the custom stamp annotation selection?

To enable or disable the custom stamp annotation selection, set the Constraints API to AnnotationConstraints.Selectable or ~AnnotationConstraints.Selectable respectively, and the following sample explains the same. But other annotation types can be selected, moved, resized, removed or their attributes can be changed.

//Disable the selection of custom stamp annotations.
pdfViewerControl.AnnotationSettings.Stamp.Constraints = ~AnnotationConstraints.Selectable;

Custom stamp annotation selection will be allowed only if the SfPdfViewer.AnnotationSettings.Constraints API is set to AnnotationConstraints.Selectable. The following code prevents the custom stamp annotations selection, even though the Constraints property of the custom stamp annotation is set to AnnotationConstraints.Selectable.

//Disable the custom stamp annotation selection, though its 'Constraints' property is set to ‘AnnotationConstraints.Selectable’ 
pdfViewerControl.AnnotationSettings.Constraints= ~AnnotationConstraints.Selectable;
pdfViewerControl.AnnotationSettings.Stamp.Constraints = AnnotationConstraints.Selectable;

How to get and set the name of the custom stamp annotations?

The PDF Viewer allows the users to get and set the name of custom stamp annotations through the Name API.

The following code sample explains modifying the name of the custom stamp annotation in the StampAnnotationAdded event.

private void PdfViewerControl_StampAnnotationAdded(object sender, StampAnnotationAddedEventArgs e)
{
(sender as StampAnnotation).Name = "StampAnnotation1";
}

NOTE

For illustration purposes, we have only provided the sample for modifying the name of the custom stamp annotation in the StampAnnotationAdded event. But this can be done in all other events as well.