←Select platform

LoadEmbeddedAnnotations Property


Tries to load the annotations embedded in the document.

public bool LoadEmbeddedAnnotations {get; set;} 
Public Property LoadEmbeddedAnnotations() As Boolean 
   property bool LoadEmbeddedAnnotations 
      bool get() 
      void set(bool value) 
public boolean getLoadEmbeddedAnnotations() 
public void setLoadEmbeddedAnnotations(boolean value) 

Property Value

true to try to load the annotations embedded in the document; otherwise, false. Default value is false.


Some document formats such as PDF and TIF support embedded annotations inside the document file itself. Set the value of LoadEmbeddedAnnotations to true to try to read these annotations when loading a document. This will not cause an error if the format does not support embedded annotations or if the file does not contain any.

If the annotations are stored in an external file, then use AnnotationsUri instead. Note that if you set AnnotationsUri to a value (not null) then LoadEmbeddedAnnotations will be ignored and the framework will not try to load any embedded annotations even if they exist.

The value of RenderAnnotations controls what happens to the annotations:

  • RenderAnnotations is false (the default value): The annotations are loaded and stored inside the document and DocumentPage.GetAnnotations can be used to access the annotations after loading. DocumentViewer will then allow the user to interact with these annotation objects by moving them, deleting them or changing their properties.

  • RenderAnnotations is true: The annotations are rendered on top of each page (raster and SVG). DocumentViewer will then show the annotations as part or image of each page and will not allow the user to interact with these annotation objects. This feature is currently available only for annotations extracted from an embedded PDF file.

RenderAnnotations is not used if LoadEmbeddedAnnotations is false.

Refer to Loading Documents using Leadtools.Document for detailed information.


For an example, refer to DocumentFactory.LoadFromFile or DocumentFactory.LoadFromUri.


Target Platforms

Help Version 21.0.2020.12.8
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Document Assembly