PDFix SDK  6.5.0
PdfMarkupAnnot Struct Referenceabstract

PdfMarkupAnnot class. More...

Inheritance diagram for PdfMarkupAnnot:
PdfAnnot PdfTextAnnot PdfTextMarkupAnnot

Public Member Functions

virtual int GetContents (wchar_t *buffer, int len)=0
 
virtual bool SetContents (const wchar_t *contents)=0
 
virtual int GetAuthor (wchar_t *buffer, int len)=0
 Gets the author of the markup annotation. More...
 
virtual bool SetAuthor (const wchar_t *author)=0
 Sets the author of the markup annotation. More...
 
virtual int GetNumReplies ()=0
 Both annotations must be on the same page of the document. More...
 
virtual PdfAnnotGetReply (int index)=0
 Both annotations must be on the same page of the document. More...
 
virtual PdfAnnotAddReply (const wchar_t *author, const wchar_t *text)=0
 Adds a new reply to the markup annotation. More...
 
- Public Member Functions inherited from PdfAnnot
virtual PdfAnnotSubtype GetSubtype ()=0
 Gets an annotation's subtype. More...
 
virtual PdfAnnotFlags GetFlags ()=0
 Gets an annotation's flags. More...
 
virtual void GetAppearance (PdfAnnotAppearance *appearance)=0
 Gets an annotation's appearance. More...
 
virtual PdsStreamGetAppearanceXObject (PdfAnnotAppearanceMode mode)=0
 Gets an annotation's appearance stream. More...
 
virtual bool SetAppearanceFromXObject (PdsStream *xobj, PdfAnnotAppearanceMode mode)=0
 Set an annotation's appearance from an XObject. More...
 
virtual void GetBBox (PdfRect *bbox)=0
 Gets the annotation bounding box. More...
 
virtual bool PointInAnnot (PdfPoint *point)=0
 
virtual bool RectInAnnot (PdfRect *rect)=0
 
virtual PdsObjectGetStructObject (bool struct_parent)=0
 
virtual PdsDictionaryGetObject ()=0
 Gets the annotation object dictionary. More...
 
virtual void NotifyWillChange (const wchar_t *key)=0
 Broadcasts a PDAnnotWillChange() notification. Clients must call this method before making any change to a custom annotation. More...
 
virtual void NotifyDidChange (const wchar_t *key, int err)=0
 Broadcasts a PDAnnotDidChange() notification. Clients must call this method after making any change to a custom annotation. More...
 
virtual bool IsValid ()=0
 

Detailed Description

PdfMarkupAnnot class.

Markup annotations represent a markup annotation in a pdf document.

Member Function Documentation

◆ AddReply()

virtual PdfAnnot* PdfMarkupAnnot::AddReply ( const wchar_t *  author,
const wchar_t *  text 
)
pure virtual

Adds a new reply to the markup annotation.

Parameters
authorThe author of the reply.
textThe content of the reply to add.
Returns
Requested PdfAnnot that is reply to the current annotation or nullptr in case of error.
See also
PdfMarkupAnnot::AddReply Sample AddComment

◆ GetAuthor()

virtual int PdfMarkupAnnot::GetAuthor ( wchar_t *  buffer,
int  len 
)
pure virtual

Gets the author of the markup annotation.

Parameters
buffer(filled by method) If the buffer is null function returns required length of string
lenLength of a buffer to be filled in.
Returns
Number of characters written into buffer of required length.
See also
PdfMarkupAnnot::GetAuthor

◆ GetContents()

virtual int PdfMarkupAnnot::GetContents ( wchar_t *  buffer,
int  len 
)
pure virtual

Gets the contents of the markup annotation. It's a 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.

Parameters
buffer(filled by method) If the buffer is null function returns required length of string
lenLength of a buffer to be filled in.
Returns
Number of characters written into buffer of required length.
See also
PdfMarkupAnnot::GetContents

◆ GetNumReplies()

virtual int PdfMarkupAnnot::GetNumReplies ( )
pure virtual

Both annotations must be on the same page of the document.

Gets the requested reply. Reply is a reference to another PdfAnnot object that was created

Returns
Number of replies.
See also
PdfMarkupAnnot::GetNumReplies

◆ GetReply()

virtual PdfAnnot* PdfMarkupAnnot::GetReply ( int  index)
pure virtual

Both annotations must be on the same page of the document.

Gets the requested reply. Reply is a reference to another PdfAnnot object that was created

Returns
Requested PdfAnnot that is reply to the current annotation.
See also
PdfMarkupAnnot::GetReply

◆ SetAuthor()

virtual bool PdfMarkupAnnot::SetAuthor ( const wchar_t *  author)
pure virtual

Sets the author of the markup annotation.

Parameters
authorThe content string to be set.
Returns
true if the author was set, false otherwise.
See also
PdfMarkupAnnot::SetAuthor

◆ SetContents()

virtual bool PdfMarkupAnnot::SetContents ( const wchar_t *  contents)
pure virtual

Sets the contents of the markup annotation. It's a 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.

Parameters
contensThe content string to be set.
Returns
true if the content was set, false otherwise.
See also
PdfMarkupAnnot::SetContents