Foxit::PDF::Annotations::IAnnot Interface Reference

Interface class to define basic method of annotation. More...

Inherited by Foxit::PDF::Annotations::Annot, Foxit::PDF::Annotations::IMarkup, Foxit::PDF::Annotations::Link, and Foxit::PDF::Annotations::Popup.

Public Member Functions

Boolean IsMarkup ()
 Check if current annotation is a markup annotation. More...
 
AnnotType GetType ()
 Get the type of current annotation. More...
 
String^ GetContents ()
 Get the contents data. More...
 
void SetContents (String^ content)
 Set the contents data. More...
 
DateTimeGetModifiedTime ()
 Get the last modification time. More...
 
void SetModifiedTime (DateTime^ modifiedTime)
 Set the last modification time. More...
 
UInt32 GetFlags ()
 Get annotation flags. More...
 
void SetFlags (UInt32 flags)
 Set annotation flags. More...
 
String^ GetName ()
 Get annotation name string. More...
 
void SetName (String^ name)
 Get annotation name string. More...
 
RectFGetRect ()
 Get rectangle value. More...
 
Boolean Move (RectF^ rect)
 Move current annotation to a new position specified by a rectangle. More...
 
BorderInfoGetBorderInfo ()
 Get border information. More...
 
void SetBorderInfo (BorderInfo^ border)
 Set border information. More...
 

Properties

Int64 pointer
 Pointer to a handle of PDF annotation object. This pointer is not useful outside this SDK. The application should not access the pointer to the handle of the PDF annotation object directly.
 

Detailed Description

Interface class to define basic method of annotation.

Member Function Documentation

BorderInfo ^ Foxit::PDF::Annotations::IAnnot::GetBorderInfo ( )

Get border information.

Returns
A Annotations::BorderInfo object that receives the border information value. If there is any error, this function will return nullptr.
Call function Library::GetLastError after this function returns, to get the error code.
ErrorCode::Success means success.
ErrorCode::NotFound means no border property can be found.
ErrorCode::OutOfMemory means there is no enough memory or the memory access is wrong.
ErrorCode::Error means the function fails because of any other reasons.
For more error code values, please refer to enumeration Foxit::ErrorCode.

Implemented in Foxit::PDF::Annotations::Squiggly, Foxit::PDF::Annotations::StrikeOut, Foxit::PDF::Annotations::Underline, Foxit::PDF::Annotations::Highlight, Foxit::PDF::Annotations::FileAttachment, Foxit::PDF::Annotations::PolyLine, Foxit::PDF::Annotations::Polygon, Foxit::PDF::Annotations::Note, Foxit::PDF::Annotations::Square, Foxit::PDF::Annotations::Stamp, Foxit::PDF::Annotations::Line, Foxit::PDF::Annotations::Ink, Foxit::PDF::Annotations::FreeText, Foxit::PDF::Annotations::Circle, Foxit::PDF::Annotations::Link, Foxit::PDF::Annotations::Popup, Foxit::PDF::Annotations::Markup, and Foxit::PDF::Annotations::Annot.

String ^ Foxit::PDF::Annotations::IAnnot::GetContents ( )

Get the contents data.

Contents data is the text to be displayed for the annotation or, if this type of annotation does not display text, an alternate description of the annotation's contents in human-readable form. In either case, this text is useful when extracting the document's contents in support of accessibility to users with disabilities or for other purposes

Returns
A String object that receives the contents data. If there is any error, this function will return nullptr.
Call function Library::GetLastError after this function returns, to get the error code.
ErrorCode::Success means success.
ErrorCode::NotFound means no content data can be found.
ErrorCode::OutOfMemory means there is no enough memory or the memory access is wrong.
ErrorCode::Error means the function fails because of any other reasons.
For more error code values, please refer to enumeration Foxit::ErrorCode.

Implemented in Foxit::PDF::Annotations::Squiggly, Foxit::PDF::Annotations::StrikeOut, Foxit::PDF::Annotations::Underline, Foxit::PDF::Annotations::Highlight, Foxit::PDF::Annotations::FileAttachment, Foxit::PDF::Annotations::PolyLine, Foxit::PDF::Annotations::Polygon, Foxit::PDF::Annotations::Note, Foxit::PDF::Annotations::Square, Foxit::PDF::Annotations::Stamp, Foxit::PDF::Annotations::Line, Foxit::PDF::Annotations::Ink, Foxit::PDF::Annotations::FreeText, Foxit::PDF::Annotations::Circle, Foxit::PDF::Annotations::Link, Foxit::PDF::Annotations::Popup, Foxit::PDF::Annotations::Markup, and Foxit::PDF::Annotations::Annot.

UInt32 Foxit::PDF::Annotations::IAnnot::GetFlags ( )

Get annotation flags.

Returns
Value of flags. Please refer to enumeration Annotations::Flags and this would be one or combination of its values.
Call function Library::GetLastError after this function returns, to get the error code.
ErrorCode::Success means success.
ErrorCode::NotFound means no flags property can be found.
ErrorCode::OutOfMemory means there is no enough memory or the memory access is wrong.
ErrorCode::Error means the function fails because of any other reasons.
For more error code values, please refer to enumeration Foxit::ErrorCode.

Implemented in Foxit::PDF::Annotations::Squiggly, Foxit::PDF::Annotations::StrikeOut, Foxit::PDF::Annotations::Underline, Foxit::PDF::Annotations::Highlight, Foxit::PDF::Annotations::FileAttachment, Foxit::PDF::Annotations::PolyLine, Foxit::PDF::Annotations::Polygon, Foxit::PDF::Annotations::Note, Foxit::PDF::Annotations::Square, Foxit::PDF::Annotations::Stamp, Foxit::PDF::Annotations::Line, Foxit::PDF::Annotations::Ink, Foxit::PDF::Annotations::FreeText, Foxit::PDF::Annotations::Circle, Foxit::PDF::Annotations::Link, Foxit::PDF::Annotations::Popup, Foxit::PDF::Annotations::Markup, and Foxit::PDF::Annotations::Annot.

DateTime ^ Foxit::PDF::Annotations::IAnnot::GetModifiedTime ( )

Get the last modification time.

Returns
A Foxit::DateTime object that receives the last modification time. If there is any error, this function will return nullptr.
Call function Library::GetLastError after this function returns, to get the error code.
ErrorCode::Success means success.
ErrorCode::NotFound means no modified time data can be found.
ErrorCode::OutOfMemory means there is no enough memory or the memory access is wrong.
ErrorCode::Error means the function fails because of any other reasons.
For more error code values, please refer to enumeration Foxit::ErrorCode.

Implemented in Foxit::PDF::Annotations::Squiggly, Foxit::PDF::Annotations::StrikeOut, Foxit::PDF::Annotations::Underline, Foxit::PDF::Annotations::Highlight, Foxit::PDF::Annotations::FileAttachment, Foxit::PDF::Annotations::PolyLine, Foxit::PDF::Annotations::Polygon, Foxit::PDF::Annotations::Note, Foxit::PDF::Annotations::Square, Foxit::PDF::Annotations::Stamp, Foxit::PDF::Annotations::Line, Foxit::PDF::Annotations::Ink, Foxit::PDF::Annotations::FreeText, Foxit::PDF::Annotations::Circle, Foxit::PDF::Annotations::Link, Foxit::PDF::Annotations::Popup, Foxit::PDF::Annotations::Markup, and Foxit::PDF::Annotations::Annot.

String ^ Foxit::PDF::Annotations::IAnnot::GetName ( )

Get annotation name string.

The annotation name, a text string uniquely identifying it among all the annotations on its page.

Returns
A String object that receives the name string. If there is any error, this function will return nullptr.
Call function Library::GetLastError after this function returns, to get the error code.
ErrorCode::Success means success.
ErrorCode::NotFound means no name property can be found.
ErrorCode::OutOfMemory means there is no enough memory or the memory access is wrong.
ErrorCode::Error means the function fails because of any other reasons.
For more error code values, please refer to enumeration Foxit::ErrorCode.

Implemented in Foxit::PDF::Annotations::Squiggly, Foxit::PDF::Annotations::StrikeOut, Foxit::PDF::Annotations::Underline, Foxit::PDF::Annotations::Highlight, Foxit::PDF::Annotations::FileAttachment, Foxit::PDF::Annotations::PolyLine, Foxit::PDF::Annotations::Polygon, Foxit::PDF::Annotations::Note, Foxit::PDF::Annotations::Square, Foxit::PDF::Annotations::Stamp, Foxit::PDF::Annotations::Line, Foxit::PDF::Annotations::Ink, Foxit::PDF::Annotations::FreeText, Foxit::PDF::Annotations::Circle, Foxit::PDF::Annotations::Link, Foxit::PDF::Annotations::Popup, Foxit::PDF::Annotations::Markup, and Foxit::PDF::Annotations::Annot.

RectF ^ Foxit::PDF::Annotations::IAnnot::GetRect ( )

Get rectangle value.

Returns
A Foxit::RectF object that receives the rectangle value. If there is any error, this function will return nullptr.
Call function Library::GetLastError after this function returns, to get the error code.
ErrorCode::Success means success.
ErrorCode::NotFound means no rectangle property can be found.
ErrorCode::OutOfMemory means there is no enough memory or the memory access is wrong.
ErrorCode::Error means the function fails because of any other reasons.
For more error code values, please refer to enumeration Foxit::ErrorCode.

Implemented in Foxit::PDF::Annotations::Squiggly, Foxit::PDF::Annotations::StrikeOut, Foxit::PDF::Annotations::Underline, Foxit::PDF::Annotations::Highlight, Foxit::PDF::Annotations::FileAttachment, Foxit::PDF::Annotations::PolyLine, Foxit::PDF::Annotations::Polygon, Foxit::PDF::Annotations::Note, Foxit::PDF::Annotations::Square, Foxit::PDF::Annotations::Stamp, Foxit::PDF::Annotations::Line, Foxit::PDF::Annotations::Ink, Foxit::PDF::Annotations::FreeText, Foxit::PDF::Annotations::Circle, Foxit::PDF::Annotations::Link, Foxit::PDF::Annotations::Popup, Foxit::PDF::Annotations::Markup, and Foxit::PDF::Annotations::Annot.

AnnotType Foxit::PDF::Annotations::IAnnot::GetType ( )
Boolean Foxit::PDF::Annotations::IAnnot::IsMarkup ( )

Check if current annotation is a markup annotation.

Returns
A boolean value: true means current annotation is a markup annotation, while false means current annotation is not a markup annotation.
Call function Library::GetLastError after this function returns, to get the error code.
ErrorCode::Success means success.
ErrorCode::OutOfMemory means there is no enough memory or the memory access is wrong.
ErrorCode::Error means the function fails because of any other reasons.
For more error code values, please refer to enumeration Foxit::ErrorCode.

Implemented in Foxit::PDF::Annotations::Squiggly, Foxit::PDF::Annotations::StrikeOut, Foxit::PDF::Annotations::Underline, Foxit::PDF::Annotations::Highlight, Foxit::PDF::Annotations::FileAttachment, Foxit::PDF::Annotations::PolyLine, Foxit::PDF::Annotations::Polygon, Foxit::PDF::Annotations::Note, Foxit::PDF::Annotations::Square, Foxit::PDF::Annotations::Stamp, Foxit::PDF::Annotations::Line, Foxit::PDF::Annotations::Ink, Foxit::PDF::Annotations::FreeText, Foxit::PDF::Annotations::Circle, Foxit::PDF::Annotations::Link, Foxit::PDF::Annotations::Popup, Foxit::PDF::Annotations::Markup, and Foxit::PDF::Annotations::Annot.

Boolean Foxit::PDF::Annotations::IAnnot::Move ( RectF rect)

Move current annotation to a new position specified by a rectangle.

To move an annotation is to reset its rectangle.

Parameters
[in]rectA Foxit::RectF object that specifies the new position. The rect should be "normalized" for PDF page coordination: left is always smaller than right, and bottom is always smaller than top.
Returns
A boolean value: true means success, while false means failure.
Call function Library::GetLastError after this function returns, to get the error code.
ErrorCode::Success means success.
ErrorCode::Param means parameter rect is invalid.
ErrorCode::OutOfMemory means there is no enough memory or the memory access is wrong.
ErrorCode::Error means the function fails because of any other reasons.
For more error code values, please refer to enumeration Foxit::ErrorCode.

Implemented in Foxit::PDF::Annotations::Squiggly, Foxit::PDF::Annotations::StrikeOut, Foxit::PDF::Annotations::Underline, Foxit::PDF::Annotations::Highlight, Foxit::PDF::Annotations::FileAttachment, Foxit::PDF::Annotations::PolyLine, Foxit::PDF::Annotations::Polygon, Foxit::PDF::Annotations::Note, Foxit::PDF::Annotations::Square, Foxit::PDF::Annotations::Stamp, Foxit::PDF::Annotations::Line, Foxit::PDF::Annotations::Ink, Foxit::PDF::Annotations::FreeText, Foxit::PDF::Annotations::Circle, Foxit::PDF::Annotations::Link, Foxit::PDF::Annotations::Popup, Foxit::PDF::Annotations::Markup, and Foxit::PDF::Annotations::Annot.

void Foxit::PDF::Annotations::IAnnot::SetBorderInfo ( BorderInfo border)

Set border information.

Parameters
[in]borderAn Annotations::BorderInfo object that specifies the new border information to be set. Please refer to comment of Annotations::BorderInfo for more details.
Returns
None.
Call function Library::GetLastError after this function returns, to get the error code.
ErrorCode::Success means success.
ErrorCode::Param means parameter border is nullptr or some properties of border is invalid.
ErrorCode::OutOfMemory means there is no enough memory or the memory access is wrong.
ErrorCode::Error means the function fails because of any other reasons.
For more error code values, please refer to enumeration Foxit::ErrorCode.

Implemented in Foxit::PDF::Annotations::Squiggly, Foxit::PDF::Annotations::StrikeOut, Foxit::PDF::Annotations::Underline, Foxit::PDF::Annotations::Highlight, Foxit::PDF::Annotations::FileAttachment, Foxit::PDF::Annotations::PolyLine, Foxit::PDF::Annotations::Polygon, Foxit::PDF::Annotations::Note, Foxit::PDF::Annotations::Square, Foxit::PDF::Annotations::Stamp, Foxit::PDF::Annotations::Line, Foxit::PDF::Annotations::Ink, Foxit::PDF::Annotations::FreeText, Foxit::PDF::Annotations::Circle, Foxit::PDF::Annotations::Link, Foxit::PDF::Annotations::Popup, Foxit::PDF::Annotations::Markup, and Foxit::PDF::Annotations::Annot.

void Foxit::PDF::Annotations::IAnnot::SetContents ( String^  content)

Set the contents data.

Contents data is the text to be displayed for the annotation or, if this type of annotation does not display text, an alternate description of the annotation's contents in human-readable form. In either case, this text is useful when extracting the document's contents in support of accessibility to users with disabilities or for other purposes.
Please ensure that a free text annotation has already been set the default appearance property for keeping its contents data useful.

Parameters
[in]contentA String object that specifies the new contents data to be set. It can be nullptr or empty.
Returns
None.
Call function Library::GetLastError after this function returns, to get the error code.
ErrorCode::Success means success.
ErrorCode::OutOfMemory means there is no enough memory or the memory access is wrong.
ErrorCode::Error means the function fails because of any other reasons.
For more error code values, please refer to enumeration Foxit::ErrorCode.

Implemented in Foxit::PDF::Annotations::Squiggly, Foxit::PDF::Annotations::StrikeOut, Foxit::PDF::Annotations::Underline, Foxit::PDF::Annotations::Highlight, Foxit::PDF::Annotations::FileAttachment, Foxit::PDF::Annotations::PolyLine, Foxit::PDF::Annotations::Polygon, Foxit::PDF::Annotations::Note, Foxit::PDF::Annotations::Square, Foxit::PDF::Annotations::Stamp, Foxit::PDF::Annotations::Line, Foxit::PDF::Annotations::Ink, Foxit::PDF::Annotations::FreeText, Foxit::PDF::Annotations::Circle, Foxit::PDF::Annotations::Link, Foxit::PDF::Annotations::Popup, Foxit::PDF::Annotations::Markup, and Foxit::PDF::Annotations::Annot.

void Foxit::PDF::Annotations::IAnnot::SetFlags ( UInt32  flags)

Set annotation flags.

Parameters
[in]flagsValue of flags. Please refer to enumeration Annotations::Flags and this can be one or combination of its values.
Returns
None.
Call function Library::GetLastError after this function returns, to get the error code.
ErrorCode::Success means success.
ErrorCode::OutOfMemory means there is no enough memory or the memory access is wrong.
ErrorCode::Error means the function fails because of any other reasons.
For more error code values, please refer to enumeration Foxit::ErrorCode.

Implemented in Foxit::PDF::Annotations::Squiggly, Foxit::PDF::Annotations::StrikeOut, Foxit::PDF::Annotations::Underline, Foxit::PDF::Annotations::Highlight, Foxit::PDF::Annotations::FileAttachment, Foxit::PDF::Annotations::PolyLine, Foxit::PDF::Annotations::Polygon, Foxit::PDF::Annotations::Note, Foxit::PDF::Annotations::Square, Foxit::PDF::Annotations::Stamp, Foxit::PDF::Annotations::Line, Foxit::PDF::Annotations::Ink, Foxit::PDF::Annotations::FreeText, Foxit::PDF::Annotations::Circle, Foxit::PDF::Annotations::Link, Foxit::PDF::Annotations::Popup, Foxit::PDF::Annotations::Markup, and Foxit::PDF::Annotations::Annot.

void Foxit::PDF::Annotations::IAnnot::SetModifiedTime ( DateTime modifiedTime)

Set the last modification time.

Parameters
[in]modifiedTimeA Foxit::DateTime object that specifies the new last modification time data to be set. It should be valid and should not be nullptr.
Returns
None.
Call function Library::GetLastError after this function returns, to get the error code.
ErrorCode::Success means success.
ErrorCode::Param means parameter modifiedTime is nullptr or invalid.
ErrorCode::OutOfMemory means there is no enough memory or the memory access is wrong.
ErrorCode::Error means the function fails because of any other reasons.
For more error code values, please refer to enumeration Foxit::ErrorCode.

Implemented in Foxit::PDF::Annotations::Squiggly, Foxit::PDF::Annotations::StrikeOut, Foxit::PDF::Annotations::Underline, Foxit::PDF::Annotations::Highlight, Foxit::PDF::Annotations::FileAttachment, Foxit::PDF::Annotations::PolyLine, Foxit::PDF::Annotations::Polygon, Foxit::PDF::Annotations::Note, Foxit::PDF::Annotations::Square, Foxit::PDF::Annotations::Stamp, Foxit::PDF::Annotations::Line, Foxit::PDF::Annotations::Ink, Foxit::PDF::Annotations::FreeText, Foxit::PDF::Annotations::Circle, Foxit::PDF::Annotations::Link, Foxit::PDF::Annotations::Popup, Foxit::PDF::Annotations::Markup, and Foxit::PDF::Annotations::Annot.

void Foxit::PDF::Annotations::IAnnot::SetName ( String^  name)

Get annotation name string.

The annotation name, a text string uniquely identifying it among all the annotations on its page.

Parameters
[in]nameA String object that specifies the new name string. This can be nullptr or empty.
Returns
None.
Call function Library::GetLastError after this function returns, to get the error code.
ErrorCode::Success means success.
ErrorCode::OutOfMemory means there is no enough memory or the memory access is wrong.
ErrorCode::Error means the function fails because of any other reasons.
For more error code values, please refer to enumeration Foxit::ErrorCode.

Implemented in Foxit::PDF::Annotations::Squiggly, Foxit::PDF::Annotations::StrikeOut, Foxit::PDF::Annotations::Underline, Foxit::PDF::Annotations::Highlight, Foxit::PDF::Annotations::FileAttachment, Foxit::PDF::Annotations::PolyLine, Foxit::PDF::Annotations::Polygon, Foxit::PDF::Annotations::Note, Foxit::PDF::Annotations::Square, Foxit::PDF::Annotations::Stamp, Foxit::PDF::Annotations::Line, Foxit::PDF::Annotations::Ink, Foxit::PDF::Annotations::FreeText, Foxit::PDF::Annotations::Circle, Foxit::PDF::Annotations::Link, Foxit::PDF::Annotations::Popup, Foxit::PDF::Annotations::Markup, and Foxit::PDF::Annotations::Annot.

Foxit Corporation