PDF Toolbox
Loading...
Searching...
No Matches
Macros | Functions
PdfToolbox_PtxPdfAnnots.h File Reference
#include "PdfToolbox_Types.h"
#include "PdfToolbox_PtxSys.h"

Go to the source code of this file.

Macros

#define PDFTOOLBOX_CALL
 
#define PtxPdfAnnots_Annotation_GetId   PtxPdfAnnots_Annotation_GetIdA
 
#define PtxPdfAnnots_MarkupInfo_GetAuthor   PtxPdfAnnots_MarkupInfo_GetAuthorA
 
#define PtxPdfAnnots_MarkupInfo_SetAuthor   PtxPdfAnnots_MarkupInfo_SetAuthorA
 
#define PtxPdfAnnots_MarkupInfo_GetSubject   PtxPdfAnnots_MarkupInfo_GetSubjectA
 
#define PtxPdfAnnots_MarkupInfo_SetSubject   PtxPdfAnnots_MarkupInfo_SetSubjectA
 
#define PtxPdfAnnots_MarkupInfo_GetContent   PtxPdfAnnots_MarkupInfo_GetContentA
 
#define PtxPdfAnnots_MarkupInfo_SetContent   PtxPdfAnnots_MarkupInfo_SetContentA
 
#define PtxPdfAnnots_StickyNote_Create   PtxPdfAnnots_StickyNote_CreateA
 
#define PtxPdfAnnots_TextStamp_CreateRaw   PtxPdfAnnots_TextStamp_CreateRawA
 
#define PtxPdfAnnots_FreeText_Create   PtxPdfAnnots_FreeText_CreateA
 

Functions

PDFTOOLBOX_EXPORT TPtxPdfAnnots_Annotation *PDFTOOLBOX_CALL PtxPdfAnnots_Annotation_Copy (TPtxPdf_Document *pTargetDocument, TPtxPdfAnnots_Annotation *pAnnotation)
 Copy an annotation Copy an annotation object from an input document to the given pTargetDocument. The returned object is associated with the given target document but not yet part of it.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_Annotation_GetBoundingBox (TPtxPdfAnnots_Annotation *pAnnotation, TPtxGeomReal_Rectangle *pBoundingBox)
 The location on the page.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_Annotation_GetHidden (TPtxPdfAnnots_Annotation *pAnnotation)
 The annotation's visibility If TRUE then the annotation is present, but is invisible and not available for user interaction. Depending on the PtxPdfAnnots_Annotation_GetNoPrint property it will, however, still be visible when printing.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_Annotation_GetNoPrint (TPtxPdfAnnots_Annotation *pAnnotation)
 The annotation's visibility when printing If TRUE then the annotation is not present in a print output of the document.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_Annotation_GetNoZoom (TPtxPdfAnnots_Annotation *pAnnotation)
 The annotation's scaling behavior If TRUE then the annotation's visual appearance does not scale with the zoom factor of a PDF viewer.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_Annotation_GetNoRotate (TPtxPdfAnnots_Annotation *pAnnotation)
 The annotation's rotation behavior If TRUE then the annotation's visual appearance does not rotate with the rotation set in a PDF viewer.
 
PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxPdfAnnots_Annotation_GetIdA (TPtxPdfAnnots_Annotation *pAnnotation, char *pBuffer, size_t nBufferSize)
 The annotation identifier A text string uniquely identifying it among all the annotations on its page. When creating annotations using the SDK, a unique ID is set automatically.
 
PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxPdfAnnots_Annotation_GetIdW (TPtxPdfAnnots_Annotation *pAnnotation, WCHAR *pBuffer, size_t nBufferSize)
 The annotation identifier A text string uniquely identifying it among all the annotations on its page. When creating annotations using the SDK, a unique ID is set automatically.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_AnnotationType PDFTOOLBOX_CALL PtxPdfAnnots_Annotation_GetType (TPtxPdfAnnots_Annotation *pAnnotation)
 Get actual derived type of base type TPtxPdfAnnots_Annotation.
 
PDFTOOLBOX_EXPORT int PDFTOOLBOX_CALL PtxPdfAnnots_AnnotationList_GetCount (TPtxPdfAnnots_AnnotationList *pAnnotationList)
 Get the number of elements in the list.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_Annotation *PDFTOOLBOX_CALL PtxPdfAnnots_AnnotationList_Get (TPtxPdfAnnots_AnnotationList *pAnnotationList, int iIndex)
 Returns the element at the specified position in the given list.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_AnnotationList_Add (TPtxPdfAnnots_AnnotationList *pAnnotationList, TPtxPdfAnnots_Annotation *pAnnotation)
 Add an element to the end of the list.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetCreationDate (TPtxPdfAnnots_MarkupInfo *pMarkupInfo, TPtxSys_Date *pCreationDate)
 The date of creation.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetCreationDate (TPtxPdfAnnots_MarkupInfo *pMarkupInfo, const TPtxSys_Date *pCreationDate)
 The date of creation.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetModificationDate (TPtxPdfAnnots_MarkupInfo *pMarkupInfo, TPtxSys_Date *pModificationDate)
 The date of last modification.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetModificationDate (TPtxPdfAnnots_MarkupInfo *pMarkupInfo, const TPtxSys_Date *pModificationDate)
 The date of last modification.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetLocked (TPtxPdfAnnots_MarkupInfo *pMarkupInfo)
 Whether the content can be modified This does not restrict the modification of other aspects of the annotation or its deletion.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetLocked (TPtxPdfAnnots_MarkupInfo *pMarkupInfo, BOOL bLocked)
 Whether the content can be modified This does not restrict the modification of other aspects of the annotation or its deletion.
 
PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetAuthorA (TPtxPdfAnnots_MarkupInfo *pMarkupInfo, char *pBuffer, size_t nBufferSize)
 The author.
 
PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetAuthorW (TPtxPdfAnnots_MarkupInfo *pMarkupInfo, WCHAR *pBuffer, size_t nBufferSize)
 The author.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetAuthorA (TPtxPdfAnnots_MarkupInfo *pMarkupInfo, const char *szAuthor)
 The author.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetAuthorW (TPtxPdfAnnots_MarkupInfo *pMarkupInfo, const WCHAR *szAuthor)
 The author.
 
PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetSubjectA (TPtxPdfAnnots_MarkupInfo *pMarkupInfo, char *pBuffer, size_t nBufferSize)
 The subject.
 
PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetSubjectW (TPtxPdfAnnots_MarkupInfo *pMarkupInfo, WCHAR *pBuffer, size_t nBufferSize)
 The subject.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetSubjectA (TPtxPdfAnnots_MarkupInfo *pMarkupInfo, const char *szSubject)
 The subject.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetSubjectW (TPtxPdfAnnots_MarkupInfo *pMarkupInfo, const WCHAR *szSubject)
 The subject.
 
PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetContentA (TPtxPdfAnnots_MarkupInfo *pMarkupInfo, char *pBuffer, size_t nBufferSize)
 The information content.
 
PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetContentW (TPtxPdfAnnots_MarkupInfo *pMarkupInfo, WCHAR *pBuffer, size_t nBufferSize)
 The information content.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetContentA (TPtxPdfAnnots_MarkupInfo *pMarkupInfo, const char *szContent)
 The information content.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetContentW (TPtxPdfAnnots_MarkupInfo *pMarkupInfo, const WCHAR *szContent)
 The information content.
 
PDFTOOLBOX_EXPORT int PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfoList_GetCount (TPtxPdfAnnots_MarkupInfoList *pMarkupInfoList)
 Get the number of elements in the list.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_MarkupInfo *PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfoList_Get (TPtxPdfAnnots_MarkupInfoList *pMarkupInfoList, int iIndex)
 Returns the element at the specified position in the given list.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_Popup_IsOpen (TPtxPdfAnnots_Popup *pPopup)
 The pop-up's visibility state.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_Popup_GetBoundingBox (TPtxPdfAnnots_Popup *pPopup, TPtxGeomReal_Rectangle *pBoundingBox)
 The pop-up location.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupAnnotation_GetLocked (TPtxPdfAnnots_MarkupAnnotation *pMarkupAnnotation)
 Whether the markup annotation can be modified This does not restrict modification of the markup annotation's content.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_MarkupInfo *PDFTOOLBOX_CALL PtxPdfAnnots_MarkupAnnotation_GetInfo (TPtxPdfAnnots_MarkupAnnotation *pMarkupAnnotation)
 The information content of this markup.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_MarkupInfoList *PDFTOOLBOX_CALL PtxPdfAnnots_MarkupAnnotation_GetReplies (TPtxPdfAnnots_MarkupAnnotation *pMarkupAnnotation)
 The replies to this markup.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_MarkupAnnotationType PDFTOOLBOX_CALL PtxPdfAnnots_MarkupAnnotation_GetType (TPtxPdfAnnots_MarkupAnnotation *pMarkupAnnotation)
 Get actual derived type of base type TPtxPdfAnnots_MarkupAnnotation.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_StickyNote *PDFTOOLBOX_CALL PtxPdfAnnots_StickyNote_CreateA (TPtxPdf_Document *pTargetDocument, const TPtxGeomReal_Point *pTopLeft, const char *szContent, TPtxPdfContent_Paint *pPaint)
 Create a sticky note annotation. The returned sticky note annotation is not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_StickyNote *PDFTOOLBOX_CALL PtxPdfAnnots_StickyNote_CreateW (TPtxPdf_Document *pTargetDocument, const TPtxGeomReal_Point *pTopLeft, const WCHAR *szContent, TPtxPdfContent_Paint *pPaint)
 Create a sticky note annotation. The returned sticky note annotation is not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_StickyNote_GetPaint (TPtxPdfAnnots_StickyNote *pStickyNote)
 The paint for the icon and the popup.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_Popup *PDFTOOLBOX_CALL PtxPdfAnnots_StickyNote_GetPopup (TPtxPdfAnnots_StickyNote *pStickyNote)
 The pop-up.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_FileAttachment *PDFTOOLBOX_CALL PtxPdfAnnots_FileAttachment_Create (TPtxPdf_Document *pTargetDocument, const TPtxGeomReal_Point *pTopLeft, TPtxPdf_FileReference *pAttachedFile, TPtxPdfContent_Paint *pPaint)
 Create a file attachment annotation. The returned file attachment annotation is not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_FileAttachmentIcon PDFTOOLBOX_CALL PtxPdfAnnots_FileAttachment_GetIcon (TPtxPdfAnnots_FileAttachment *pFileAttachment)
 The displayed icon.
 
PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_FileAttachment_GetPaint (TPtxPdfAnnots_FileAttachment *pFileAttachment)
 The paint for the icon and the popup.
 
PDFTOOLBOX_EXPORT TPtxPdf_FileReference *PDFTOOLBOX_CALL PtxPdfAnnots_FileAttachment_GetAttachedFile (TPtxPdfAnnots_FileAttachment *pFileAttachment)
 The embedded file.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_Popup *PDFTOOLBOX_CALL PtxPdfAnnots_FileAttachment_GetPopup (TPtxPdfAnnots_FileAttachment *pFileAttachment)
 The pop-up.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_Popup *PDFTOOLBOX_CALL PtxPdfAnnots_Stamp_GetPopup (TPtxPdfAnnots_Stamp *pStamp)
 The pop-up.
 
PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_Stamp_GetPopupPaint (TPtxPdfAnnots_Stamp *pStamp)
 The paint for the popup.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_StampType PDFTOOLBOX_CALL PtxPdfAnnots_Stamp_GetType (TPtxPdfAnnots_Stamp *pStamp)
 Get actual derived type of base type TPtxPdfAnnots_Stamp.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_TextStamp *PDFTOOLBOX_CALL PtxPdfAnnots_TextStamp_CreateRawA (TPtxPdf_Document *pTargetDocument, const TPtxGeomReal_Point *pTopLeft, const double *pHeight, TPtxPdfAnnots_TextStampType iTextType, const char *szText)
 Create a text stamp annotation. The width of the annotation is computed from the given stamp text. The returned text stamp annotation is not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_TextStamp *PDFTOOLBOX_CALL PtxPdfAnnots_TextStamp_CreateRawW (TPtxPdf_Document *pTargetDocument, const TPtxGeomReal_Point *pTopLeft, const double *pHeight, TPtxPdfAnnots_TextStampType iTextType, const WCHAR *szText)
 Create a text stamp annotation. The width of the annotation is computed from the given stamp text. The returned text stamp annotation is not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_TextStamp *PDFTOOLBOX_CALL PtxPdfAnnots_TextStamp_Create (TPtxPdf_Document *pTargetDocument, const TPtxGeomReal_Point *pTopLeft, const double *pHeight, TPtxPdfAnnots_TextStampType iTextType)
 Create a text stamp annotation. The width of the annotation is computed based on the given iTextType. The returned text stamp annotation is not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_TextStampType PDFTOOLBOX_CALL PtxPdfAnnots_TextStamp_GetTextType (TPtxPdfAnnots_TextStamp *pTextStamp)
 The displayed text This defines a predefined text for this text stamp.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_CustomStamp *PDFTOOLBOX_CALL PtxPdfAnnots_CustomStamp_Create (TPtxPdf_Document *pTargetDocument, const TPtxGeomReal_Rectangle *pBoundingBox)
 Create a custom stamp annotation. The returned custom stamp annotation's appearance has an empty content with size equal to the given pBoundingBox, and with coordinate origin located at the bottom left corner. Use a TPtxPdfContent_ContentGenerator to generate the stamp's content prior to adding the stamp annotation to a page's list of annotations.
 
PDFTOOLBOX_EXPORT TPtxPdfContent_Group *PDFTOOLBOX_CALL PtxPdfAnnots_CustomStamp_GetAppearance (TPtxPdfAnnots_CustomStamp *pCustomStamp)
 The custom stamp's visual appearance.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_FreeText *PDFTOOLBOX_CALL PtxPdfAnnots_FreeText_CreateA (TPtxPdf_Document *pTargetDocument, const TPtxGeomReal_Rectangle *pBoundingBox, const char *szContent, TPtxPdfContent_Paint *pPaint, TPtxPdfContent_Stroke *pStroke)
 Create a free-text annotation. The returned free-text annotation is not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_FreeText *PDFTOOLBOX_CALL PtxPdfAnnots_FreeText_CreateW (TPtxPdf_Document *pTargetDocument, const TPtxGeomReal_Rectangle *pBoundingBox, const WCHAR *szContent, TPtxPdfContent_Paint *pPaint, TPtxPdfContent_Stroke *pStroke)
 Create a free-text annotation. The returned free-text annotation is not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT double PDFTOOLBOX_CALL PtxPdfAnnots_FreeText_GetFontSize (TPtxPdfAnnots_FreeText *pFreeText)
 The font size.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_FreeText_SetFontSize (TPtxPdfAnnots_FreeText *pFreeText, double dFontSize)
 The font size.
 
PDFTOOLBOX_EXPORT TPtxGeom_HorizontalAlignment PDFTOOLBOX_CALL PtxPdfAnnots_FreeText_GetAlignment (TPtxPdfAnnots_FreeText *pFreeText)
 The text alignment.
 
PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_FreeText_GetPaint (TPtxPdfAnnots_FreeText *pFreeText)
 The paint for the text background and the popup.
 
PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_DrawingAnnotation_GetPaint (TPtxPdfAnnots_DrawingAnnotation *pDrawingAnnotation)
 The paint for line stroking and for the popup.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_Popup *PDFTOOLBOX_CALL PtxPdfAnnots_DrawingAnnotation_GetPopup (TPtxPdfAnnots_DrawingAnnotation *pDrawingAnnotation)
 The pop-up.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_DrawingAnnotationType PDFTOOLBOX_CALL PtxPdfAnnots_DrawingAnnotation_GetType (TPtxPdfAnnots_DrawingAnnotation *pDrawingAnnotation)
 Get actual derived type of base type TPtxPdfAnnots_DrawingAnnotation.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_LineAnnotation *PDFTOOLBOX_CALL PtxPdfAnnots_LineAnnotation_Create (TPtxPdf_Document *pTargetDocument, const TPtxGeomReal_Point *pStart, const TPtxGeomReal_Point *pEnd, TPtxPdfContent_Stroke *pStroke)
 Create a line annotation. The returned line annotation is not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_LineAnnotation_GetStart (TPtxPdfAnnots_LineAnnotation *pLineAnnotation, TPtxGeomReal_Point *pStart)
 The line's starting point.
 
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_LineAnnotation_GetEnd (TPtxPdfAnnots_LineAnnotation *pLineAnnotation, TPtxGeomReal_Point *pEnd)
 The line's ending point.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_LineEnding PDFTOOLBOX_CALL PtxPdfAnnots_LineAnnotation_GetStartStyle (TPtxPdfAnnots_LineAnnotation *pLineAnnotation)
 The starting point's style.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_LineEnding PDFTOOLBOX_CALL PtxPdfAnnots_LineAnnotation_GetEndStyle (TPtxPdfAnnots_LineAnnotation *pLineAnnotation)
 The ending point's style.
 
PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_LineAnnotation_GetLineEndingFill (TPtxPdfAnnots_LineAnnotation *pLineAnnotation)
 The line ending filling paint This paint applies to both the starting end the ending point.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_InkAnnotation *PDFTOOLBOX_CALL PtxPdfAnnots_InkAnnotation_Create (TPtxPdf_Document *pTargetDocument, TPtxPdfContent_Path *pPath, TPtxPdfContent_Stroke *pStroke)
 Create a ink annotation. The returned ink annotation is not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_PolyLineAnnotation *PDFTOOLBOX_CALL PtxPdfAnnots_PolyLineAnnotation_Create (TPtxPdf_Document *pTargetDocument, TPtxPdfContent_Path *pPath, TPtxPdfContent_Stroke *pStroke)
 Create a poly-line annotation. The returned poly-line annotation is not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_LineEnding PDFTOOLBOX_CALL PtxPdfAnnots_PolyLineAnnotation_GetStartStyle (TPtxPdfAnnots_PolyLineAnnotation *pPolyLineAnnotation)
 The starting point's style.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_LineEnding PDFTOOLBOX_CALL PtxPdfAnnots_PolyLineAnnotation_GetEndStyle (TPtxPdfAnnots_PolyLineAnnotation *pPolyLineAnnotation)
 The ending point's style.
 
PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_PolyLineAnnotation_GetLineEndingFill (TPtxPdfAnnots_PolyLineAnnotation *pPolyLineAnnotation)
 The line ending filling paint for both start and end.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_PolygonAnnotation *PDFTOOLBOX_CALL PtxPdfAnnots_PolygonAnnotation_Create (TPtxPdf_Document *pTargetDocument, TPtxPdfContent_Path *pPath, TPtxPdfContent_Stroke *pStroke, TPtxPdfContent_Paint *pFill)
 Create a polygon annotation. The returned polygon annotation is not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_PolygonAnnotation_GetFill (TPtxPdfAnnots_PolygonAnnotation *pPolygonAnnotation)
 The filling paint.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_RectangleAnnotation *PDFTOOLBOX_CALL PtxPdfAnnots_RectangleAnnotation_Create (TPtxPdf_Document *pTargetDocument, const TPtxGeomReal_Rectangle *pBoundingBox, TPtxPdfContent_Stroke *pStroke, TPtxPdfContent_Paint *pFill)
 Create a rectangle annotation. The returned rectangle annotation is not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_RectangleAnnotation_GetFill (TPtxPdfAnnots_RectangleAnnotation *pRectangleAnnotation)
 The filling paint.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_EllipseAnnotation *PDFTOOLBOX_CALL PtxPdfAnnots_EllipseAnnotation_Create (TPtxPdf_Document *pTargetDocument, const TPtxGeomReal_Rectangle *pBoundingBox, TPtxPdfContent_Stroke *pStroke, TPtxPdfContent_Paint *pFill)
 Create an ellipse annotation. The returned ellipse annotation is not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_EllipseAnnotation_GetFill (TPtxPdfAnnots_EllipseAnnotation *pEllipseAnnotation)
 The filling paint.
 
PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_TextMarkup_GetPaint (TPtxPdfAnnots_TextMarkup *pTextMarkup)
 The paint the annotation and the popup.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_Popup *PDFTOOLBOX_CALL PtxPdfAnnots_TextMarkup_GetPopup (TPtxPdfAnnots_TextMarkup *pTextMarkup)
 The pop-up.
 
PDFTOOLBOX_EXPORT TPtxGeomReal_QuadrilateralList *PDFTOOLBOX_CALL PtxPdfAnnots_TextMarkup_GetMarkupArea (TPtxPdfAnnots_TextMarkup *pTextMarkup)
 The markup area This list of TPtxGeomReal_Quadrilaterals defines the markup area on the page.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_TextMarkupType PDFTOOLBOX_CALL PtxPdfAnnots_TextMarkup_GetType (TPtxPdfAnnots_TextMarkup *pTextMarkup)
 Get actual derived type of base type TPtxPdfAnnots_TextMarkup.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_Highlight *PDFTOOLBOX_CALL PtxPdfAnnots_Highlight_CreateFromQuadrilaterals (TPtxPdf_Document *pTargetDocument, TPtxGeomReal_QuadrilateralList *pMarkupArea, TPtxPdfContent_Paint *pPaint)
 Create a new highlight with defined area The highlight area is defined by the given pMarkupArea. The returned object is associated with the pTargetDocument but not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_Underline *PDFTOOLBOX_CALL PtxPdfAnnots_Underline_CreateFromQuadrilaterals (TPtxPdf_Document *pTargetDocument, TPtxGeomReal_QuadrilateralList *pMarkupArea, TPtxPdfContent_Paint *pPaint)
 Create a new underline with defined area The area to be underlined is defined by the given pMarkupArea. The returned object is associated with the pTargetDocument but not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_StrikeThrough *PDFTOOLBOX_CALL PtxPdfAnnots_StrikeThrough_CreateFromQuadrilaterals (TPtxPdf_Document *pTargetDocument, TPtxGeomReal_QuadrilateralList *pMarkupArea, TPtxPdfContent_Paint *pPaint)
 Create a new strike-through with defined area The area to be striked through is defined by the given pMarkupArea. The returned object is associated with the pTargetDocument but not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_Squiggly *PDFTOOLBOX_CALL PtxPdfAnnots_Squiggly_CreateFromQuadrilaterals (TPtxPdf_Document *pTargetDocument, TPtxGeomReal_QuadrilateralList *pMarkupArea, TPtxPdfContent_Paint *pPaint)
 Create a new squiggly underline with defined area The area to be underlined is defined by the given pMarkupArea. The returned object is associated with the pTargetDocument but not yet part of any page. It can be added to a page's list of annotations.
 
PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_TextInsert_GetPaint (TPtxPdfAnnots_TextInsert *pTextInsert)
 The paint for the annotation and the popup.
 
PDFTOOLBOX_EXPORT TPtxPdfAnnots_Popup *PDFTOOLBOX_CALL PtxPdfAnnots_TextInsert_GetPopup (TPtxPdfAnnots_TextInsert *pTextInsert)
 The pop-up.
 

Macro Definition Documentation

◆ PDFTOOLBOX_CALL

#define PDFTOOLBOX_CALL

◆ PtxPdfAnnots_Annotation_GetId

#define PtxPdfAnnots_Annotation_GetId   PtxPdfAnnots_Annotation_GetIdA

◆ PtxPdfAnnots_FreeText_Create

#define PtxPdfAnnots_FreeText_Create   PtxPdfAnnots_FreeText_CreateA

◆ PtxPdfAnnots_MarkupInfo_GetAuthor

#define PtxPdfAnnots_MarkupInfo_GetAuthor   PtxPdfAnnots_MarkupInfo_GetAuthorA

◆ PtxPdfAnnots_MarkupInfo_GetContent

#define PtxPdfAnnots_MarkupInfo_GetContent   PtxPdfAnnots_MarkupInfo_GetContentA

◆ PtxPdfAnnots_MarkupInfo_GetSubject

#define PtxPdfAnnots_MarkupInfo_GetSubject   PtxPdfAnnots_MarkupInfo_GetSubjectA

◆ PtxPdfAnnots_MarkupInfo_SetAuthor

#define PtxPdfAnnots_MarkupInfo_SetAuthor   PtxPdfAnnots_MarkupInfo_SetAuthorA

◆ PtxPdfAnnots_MarkupInfo_SetContent

#define PtxPdfAnnots_MarkupInfo_SetContent   PtxPdfAnnots_MarkupInfo_SetContentA

◆ PtxPdfAnnots_MarkupInfo_SetSubject

#define PtxPdfAnnots_MarkupInfo_SetSubject   PtxPdfAnnots_MarkupInfo_SetSubjectA

◆ PtxPdfAnnots_StickyNote_Create

#define PtxPdfAnnots_StickyNote_Create   PtxPdfAnnots_StickyNote_CreateA

◆ PtxPdfAnnots_TextStamp_CreateRaw

#define PtxPdfAnnots_TextStamp_CreateRaw   PtxPdfAnnots_TextStamp_CreateRawA

Function Documentation

◆ PtxPdfAnnots_Annotation_Copy()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_Annotation *PDFTOOLBOX_CALL PtxPdfAnnots_Annotation_Copy ( TPtxPdf_Document * pTargetDocument,
TPtxPdfAnnots_Annotation * pAnnotation )

Copy an annotation Copy an annotation object from an input document to the given pTargetDocument. The returned object is associated with the given target document but not yet part of it.

Parameters
[in,out]pTargetDocumentthe output document with which the returned object is associated
[in,out]pAnnotationthe annotation to be copied to the pTargetDocument
Returns
the copied annotation, associated with the pTargetDocument

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_Annotation_GetBoundingBox()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_Annotation_GetBoundingBox ( TPtxPdfAnnots_Annotation * pAnnotation,
TPtxGeomReal_Rectangle * pBoundingBox )

The location on the page.

Parameters
[in,out]pAnnotationActs as a handle to the native object of type TPtxPdfAnnots_Annotation.
[out]pBoundingBoxRetrieved value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_Annotation_GetHidden()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_Annotation_GetHidden ( TPtxPdfAnnots_Annotation * pAnnotation)

The annotation's visibility If TRUE then the annotation is present, but is invisible and not available for user interaction. Depending on the PtxPdfAnnots_Annotation_GetNoPrint property it will, however, still be visible when printing.

Parameters
[in,out]pAnnotationActs as a handle to the native object of type TPtxPdfAnnots_Annotation.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_Annotation_GetIdA()

PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxPdfAnnots_Annotation_GetIdA ( TPtxPdfAnnots_Annotation * pAnnotation,
char * pBuffer,
size_t nBufferSize )

The annotation identifier A text string uniquely identifying it among all the annotations on its page. When creating annotations using the SDK, a unique ID is set automatically.

Parameters
[in,out]pAnnotationActs as a handle to the native object of type TPtxPdfAnnots_Annotation.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_Annotation_GetIdW()

PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxPdfAnnots_Annotation_GetIdW ( TPtxPdfAnnots_Annotation * pAnnotation,
WCHAR * pBuffer,
size_t nBufferSize )

The annotation identifier A text string uniquely identifying it among all the annotations on its page. When creating annotations using the SDK, a unique ID is set automatically.

Parameters
[in,out]pAnnotationActs as a handle to the native object of type TPtxPdfAnnots_Annotation.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_Annotation_GetNoPrint()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_Annotation_GetNoPrint ( TPtxPdfAnnots_Annotation * pAnnotation)

The annotation's visibility when printing If TRUE then the annotation is not present in a print output of the document.

Parameters
[in,out]pAnnotationActs as a handle to the native object of type TPtxPdfAnnots_Annotation.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_Annotation_GetNoRotate()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_Annotation_GetNoRotate ( TPtxPdfAnnots_Annotation * pAnnotation)

The annotation's rotation behavior If TRUE then the annotation's visual appearance does not rotate with the rotation set in a PDF viewer.

Parameters
[in,out]pAnnotationActs as a handle to the native object of type TPtxPdfAnnots_Annotation.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_Annotation_GetNoZoom()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_Annotation_GetNoZoom ( TPtxPdfAnnots_Annotation * pAnnotation)

The annotation's scaling behavior If TRUE then the annotation's visual appearance does not scale with the zoom factor of a PDF viewer.

Parameters
[in,out]pAnnotationActs as a handle to the native object of type TPtxPdfAnnots_Annotation.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_Annotation_GetType()

Get actual derived type of base type TPtxPdfAnnots_Annotation.

This function is invoked prior to downcasting to ascertain the derived object type.

Parameters
[in,out]pAnnotationActs as a handle to a native object.
Returns
The item of the enumeration TPtxPdfAnnots_AnnotationType that refers to the actual derived type. 0 in case of an error.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdfAnnots_AnnotationList_Add()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_AnnotationList_Add ( TPtxPdfAnnots_AnnotationList * pAnnotationList,
TPtxPdfAnnots_Annotation * pAnnotation )

Add an element to the end of the list.

Parameters
[in,out]pAnnotationListActs as a handle to the native object of type TPtxPdfAnnots_AnnotationList.
[in,out]pAnnotation
Returns
May indicate an error in certain scenarios. For further information see the note section below.
Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_AnnotationList_Get()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_Annotation *PDFTOOLBOX_CALL PtxPdfAnnots_AnnotationList_Get ( TPtxPdfAnnots_AnnotationList * pAnnotationList,
int iIndex )

Returns the element at the specified position in the given list.

Parameters
[in,out]pAnnotationListActs as a handle to the native object of type TPtxPdfAnnots_AnnotationList.
[in]iIndex
Returns
NULL if there is an error.
Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_AnnotationList_GetCount()

PDFTOOLBOX_EXPORT int PDFTOOLBOX_CALL PtxPdfAnnots_AnnotationList_GetCount ( TPtxPdfAnnots_AnnotationList * pAnnotationList)

Get the number of elements in the list.

Parameters
[in,out]pAnnotationListActs as a handle to the native object of type TPtxPdfAnnots_AnnotationList.
Returns
May indicate an error in certain scenarios. For further information see the note section below.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_CustomStamp_Create()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_CustomStamp *PDFTOOLBOX_CALL PtxPdfAnnots_CustomStamp_Create ( TPtxPdf_Document * pTargetDocument,
const TPtxGeomReal_Rectangle * pBoundingBox )

Create a custom stamp annotation. The returned custom stamp annotation's appearance has an empty content with size equal to the given pBoundingBox, and with coordinate origin located at the bottom left corner. Use a TPtxPdfContent_ContentGenerator to generate the stamp's content prior to adding the stamp annotation to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe output document with which the returned object is associated.
[in]pBoundingBoxThe location of the annotation on the page.
Returns
The newly created custom stamp annotation.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_CustomStamp_GetAppearance()

PDFTOOLBOX_EXPORT TPtxPdfContent_Group *PDFTOOLBOX_CALL PtxPdfAnnots_CustomStamp_GetAppearance ( TPtxPdfAnnots_CustomStamp * pCustomStamp)

The custom stamp's visual appearance.

Parameters
[in,out]pCustomStampActs as a handle to the native object of type TPtxPdfAnnots_CustomStamp.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_DrawingAnnotation_GetPaint()

PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_DrawingAnnotation_GetPaint ( TPtxPdfAnnots_DrawingAnnotation * pDrawingAnnotation)

The paint for line stroking and for the popup.

Parameters
[in,out]pDrawingAnnotationActs as a handle to the native object of type TPtxPdfAnnots_DrawingAnnotation.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_DrawingAnnotation_GetPopup()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_Popup *PDFTOOLBOX_CALL PtxPdfAnnots_DrawingAnnotation_GetPopup ( TPtxPdfAnnots_DrawingAnnotation * pDrawingAnnotation)

The pop-up.

Parameters
[in,out]pDrawingAnnotationActs as a handle to the native object of type TPtxPdfAnnots_DrawingAnnotation.
Returns
Retrieved value.

NULL if either an error occurred or the returned object is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.

Note
An error occurred when NULL was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_DrawingAnnotation_GetType()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_DrawingAnnotationType PDFTOOLBOX_CALL PtxPdfAnnots_DrawingAnnotation_GetType ( TPtxPdfAnnots_DrawingAnnotation * pDrawingAnnotation)

Get actual derived type of base type TPtxPdfAnnots_DrawingAnnotation.

This function is invoked prior to downcasting to ascertain the derived object type.

Parameters
[in,out]pDrawingAnnotationActs as a handle to a native object.
Returns
The item of the enumeration TPtxPdfAnnots_DrawingAnnotationType that refers to the actual derived type. 0 in case of an error.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdfAnnots_EllipseAnnotation_Create()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_EllipseAnnotation *PDFTOOLBOX_CALL PtxPdfAnnots_EllipseAnnotation_Create ( TPtxPdf_Document * pTargetDocument,
const TPtxGeomReal_Rectangle * pBoundingBox,
TPtxPdfContent_Stroke * pStroke,
TPtxPdfContent_Paint * pFill )

Create an ellipse annotation. The returned ellipse annotation is not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe output document with which the returned object is associated.
[in]pBoundingBoxThe location on the page.
[in,out]pStrokeThe stroking parameters used for stroking the ellipse. The stroking paint is used as the annotation's main paint. If NULL then the ellipse is not stroked.
[in,out]pFillThe paint used for filling the ellipse. If NULL then the ellipse is not filled.
Returns
The newly created ellipse annotation.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_EllipseAnnotation_GetFill()

PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_EllipseAnnotation_GetFill ( TPtxPdfAnnots_EllipseAnnotation * pEllipseAnnotation)

The filling paint.

Parameters
[in,out]pEllipseAnnotationActs as a handle to the native object of type TPtxPdfAnnots_EllipseAnnotation.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_FileAttachment_Create()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_FileAttachment *PDFTOOLBOX_CALL PtxPdfAnnots_FileAttachment_Create ( TPtxPdf_Document * pTargetDocument,
const TPtxGeomReal_Point * pTopLeft,
TPtxPdf_FileReference * pAttachedFile,
TPtxPdfContent_Paint * pPaint )

Create a file attachment annotation. The returned file attachment annotation is not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe output document with which the returned object is associated
[in]pTopLeftThe location of the annotation's upper left corner on the page.
[in,out]pAttachedFileThe file to be attached.
[in,out]pPaintThis paint for the file attachment icon.
Returns
The newly created file attachment annotation.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_FileAttachment_GetAttachedFile()

PDFTOOLBOX_EXPORT TPtxPdf_FileReference *PDFTOOLBOX_CALL PtxPdfAnnots_FileAttachment_GetAttachedFile ( TPtxPdfAnnots_FileAttachment * pFileAttachment)

The embedded file.

Parameters
[in,out]pFileAttachmentActs as a handle to the native object of type TPtxPdfAnnots_FileAttachment.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_FileAttachment_GetIcon()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_FileAttachmentIcon PDFTOOLBOX_CALL PtxPdfAnnots_FileAttachment_GetIcon ( TPtxPdfAnnots_FileAttachment * pFileAttachment)

The displayed icon.

Parameters
[in,out]pFileAttachmentActs as a handle to the native object of type TPtxPdfAnnots_FileAttachment.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_FileAttachment_GetPaint()

PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_FileAttachment_GetPaint ( TPtxPdfAnnots_FileAttachment * pFileAttachment)

The paint for the icon and the popup.

Parameters
[in,out]pFileAttachmentActs as a handle to the native object of type TPtxPdfAnnots_FileAttachment.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_FileAttachment_GetPopup()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_Popup *PDFTOOLBOX_CALL PtxPdfAnnots_FileAttachment_GetPopup ( TPtxPdfAnnots_FileAttachment * pFileAttachment)

The pop-up.

Parameters
[in,out]pFileAttachmentActs as a handle to the native object of type TPtxPdfAnnots_FileAttachment.
Returns
Retrieved value.

NULL if either an error occurred or the returned object is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.

Note
An error occurred when NULL was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_FreeText_CreateA()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_FreeText *PDFTOOLBOX_CALL PtxPdfAnnots_FreeText_CreateA ( TPtxPdf_Document * pTargetDocument,
const TPtxGeomReal_Rectangle * pBoundingBox,
const char * szContent,
TPtxPdfContent_Paint * pPaint,
TPtxPdfContent_Stroke * pStroke )

Create a free-text annotation. The returned free-text annotation is not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe output document with which the returned object is associated.
[in]pBoundingBoxThe location on the page.
[in]szContentThe text content.
[in,out]pPaintThis paint used for the background of the free text annotation. If NULL, the background is transparent.
[in,out]pStrokeThe stroking parameters used for stroking the rectangle. The stroking paint is used as the annotation's main paint.
Returns
The newly created free text annotation.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_FreeText_CreateW()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_FreeText *PDFTOOLBOX_CALL PtxPdfAnnots_FreeText_CreateW ( TPtxPdf_Document * pTargetDocument,
const TPtxGeomReal_Rectangle * pBoundingBox,
const WCHAR * szContent,
TPtxPdfContent_Paint * pPaint,
TPtxPdfContent_Stroke * pStroke )

Create a free-text annotation. The returned free-text annotation is not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe output document with which the returned object is associated.
[in]pBoundingBoxThe location on the page.
[in]szContentThe text content.
[in,out]pPaintThis paint used for the background of the free text annotation. If NULL, the background is transparent.
[in,out]pStrokeThe stroking parameters used for stroking the rectangle. The stroking paint is used as the annotation's main paint.
Returns
The newly created free text annotation.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_FreeText_GetAlignment()

PDFTOOLBOX_EXPORT TPtxGeom_HorizontalAlignment PDFTOOLBOX_CALL PtxPdfAnnots_FreeText_GetAlignment ( TPtxPdfAnnots_FreeText * pFreeText)

The text alignment.

Parameters
[in,out]pFreeTextActs as a handle to the native object of type TPtxPdfAnnots_FreeText.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_FreeText_GetFontSize()

PDFTOOLBOX_EXPORT double PDFTOOLBOX_CALL PtxPdfAnnots_FreeText_GetFontSize ( TPtxPdfAnnots_FreeText * pFreeText)

The font size.

Default value: 12.

Note: the font size has no effect when rich text is used

Parameters
[in,out]pFreeTextActs as a handle to the native object of type TPtxPdfAnnots_FreeText.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_FreeText_GetPaint()

PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_FreeText_GetPaint ( TPtxPdfAnnots_FreeText * pFreeText)

The paint for the text background and the popup.

Parameters
[in,out]pFreeTextActs as a handle to the native object of type TPtxPdfAnnots_FreeText.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_FreeText_SetFontSize()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_FreeText_SetFontSize ( TPtxPdfAnnots_FreeText * pFreeText,
double dFontSize )

The font size.

Default value: 12.

Note: the font size has no effect when rich text is used

Parameters
[in,out]pFreeTextActs as a handle to the native object of type TPtxPdfAnnots_FreeText.
[in]dFontSizeSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_Highlight_CreateFromQuadrilaterals()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_Highlight *PDFTOOLBOX_CALL PtxPdfAnnots_Highlight_CreateFromQuadrilaterals ( TPtxPdf_Document * pTargetDocument,
TPtxGeomReal_QuadrilateralList * pMarkupArea,
TPtxPdfContent_Paint * pPaint )

Create a new highlight with defined area The highlight area is defined by the given pMarkupArea. The returned object is associated with the pTargetDocument but not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe document in which the links is used
[in,out]pMarkupAreaThe area on the page to be highlighted.
[in,out]pPaintThe highlight paint
Returns
The newly created object

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_InkAnnotation_Create()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_InkAnnotation *PDFTOOLBOX_CALL PtxPdfAnnots_InkAnnotation_Create ( TPtxPdf_Document * pTargetDocument,
TPtxPdfContent_Path * pPath,
TPtxPdfContent_Stroke * pStroke )

Create a ink annotation. The returned ink annotation is not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe output document with which the returned object is associated.
[in,out]pPathThe path of the free-hand drawing.
[in,out]pStrokeThe stroking parameters used for stroking the line. The stroking paint is used as the annotation's main paint.
Returns
The newly created ink annotation.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_LineAnnotation_Create()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_LineAnnotation *PDFTOOLBOX_CALL PtxPdfAnnots_LineAnnotation_Create ( TPtxPdf_Document * pTargetDocument,
const TPtxGeomReal_Point * pStart,
const TPtxGeomReal_Point * pEnd,
TPtxPdfContent_Stroke * pStroke )

Create a line annotation. The returned line annotation is not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe output document with which the returned object is associated.
[in]pStartThe line's start point.
[in]pEndThe line's end point.
[in,out]pStrokeThe stroking parameters used for stroking the line. The stroking paint is used as the annotation's main paint.
Returns
The newly created line annotation.

NULL if either an error occurred or the returned object is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.

Note
An error occurred when NULL was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_LineAnnotation_GetEnd()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_LineAnnotation_GetEnd ( TPtxPdfAnnots_LineAnnotation * pLineAnnotation,
TPtxGeomReal_Point * pEnd )

The line's ending point.

Parameters
[in,out]pLineAnnotationActs as a handle to the native object of type TPtxPdfAnnots_LineAnnotation.
[out]pEndRetrieved value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_LineAnnotation_GetEndStyle()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_LineEnding PDFTOOLBOX_CALL PtxPdfAnnots_LineAnnotation_GetEndStyle ( TPtxPdfAnnots_LineAnnotation * pLineAnnotation)

The ending point's style.

Parameters
[in,out]pLineAnnotationActs as a handle to the native object of type TPtxPdfAnnots_LineAnnotation.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_LineAnnotation_GetLineEndingFill()

PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_LineAnnotation_GetLineEndingFill ( TPtxPdfAnnots_LineAnnotation * pLineAnnotation)

The line ending filling paint This paint applies to both the starting end the ending point.

Parameters
[in,out]pLineAnnotationActs as a handle to the native object of type TPtxPdfAnnots_LineAnnotation.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_LineAnnotation_GetStart()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_LineAnnotation_GetStart ( TPtxPdfAnnots_LineAnnotation * pLineAnnotation,
TPtxGeomReal_Point * pStart )

The line's starting point.

Parameters
[in,out]pLineAnnotationActs as a handle to the native object of type TPtxPdfAnnots_LineAnnotation.
[out]pStartRetrieved value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_LineAnnotation_GetStartStyle()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_LineEnding PDFTOOLBOX_CALL PtxPdfAnnots_LineAnnotation_GetStartStyle ( TPtxPdfAnnots_LineAnnotation * pLineAnnotation)

The starting point's style.

Parameters
[in,out]pLineAnnotationActs as a handle to the native object of type TPtxPdfAnnots_LineAnnotation.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupAnnotation_GetInfo()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_MarkupInfo *PDFTOOLBOX_CALL PtxPdfAnnots_MarkupAnnotation_GetInfo ( TPtxPdfAnnots_MarkupAnnotation * pMarkupAnnotation)

The information content of this markup.

Parameters
[in,out]pMarkupAnnotationActs as a handle to the native object of type TPtxPdfAnnots_MarkupAnnotation.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupAnnotation_GetLocked()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupAnnotation_GetLocked ( TPtxPdfAnnots_MarkupAnnotation * pMarkupAnnotation)

Whether the markup annotation can be modified This does not restrict modification of the markup annotation's content.

Parameters
[in,out]pMarkupAnnotationActs as a handle to the native object of type TPtxPdfAnnots_MarkupAnnotation.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupAnnotation_GetReplies()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_MarkupInfoList *PDFTOOLBOX_CALL PtxPdfAnnots_MarkupAnnotation_GetReplies ( TPtxPdfAnnots_MarkupAnnotation * pMarkupAnnotation)

The replies to this markup.

Parameters
[in,out]pMarkupAnnotationActs as a handle to the native object of type TPtxPdfAnnots_MarkupAnnotation.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupAnnotation_GetType()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_MarkupAnnotationType PDFTOOLBOX_CALL PtxPdfAnnots_MarkupAnnotation_GetType ( TPtxPdfAnnots_MarkupAnnotation * pMarkupAnnotation)

Get actual derived type of base type TPtxPdfAnnots_MarkupAnnotation.

This function is invoked prior to downcasting to ascertain the derived object type.

Parameters
[in,out]pMarkupAnnotationActs as a handle to a native object.
Returns
The item of the enumeration TPtxPdfAnnots_MarkupAnnotationType that refers to the actual derived type. 0 in case of an error.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdfAnnots_MarkupInfo_GetAuthorA()

PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetAuthorA ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo,
char * pBuffer,
size_t nBufferSize )

The author.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfo_GetAuthorW()

PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetAuthorW ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo,
WCHAR * pBuffer,
size_t nBufferSize )

The author.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfo_GetContentA()

PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetContentA ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo,
char * pBuffer,
size_t nBufferSize )

The information content.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfo_GetContentW()

PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetContentW ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo,
WCHAR * pBuffer,
size_t nBufferSize )

The information content.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfo_GetCreationDate()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetCreationDate ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo,
TPtxSys_Date * pCreationDate )

The date of creation.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
[out]pCreationDateRetrieved value.
Returns
FALSE if either an error occurred or the [out] argument returns NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfo_GetLocked()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetLocked ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo)

Whether the content can be modified This does not restrict the modification of other aspects of the annotation or its deletion.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfo_GetModificationDate()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetModificationDate ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo,
TPtxSys_Date * pModificationDate )

The date of last modification.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
[out]pModificationDateRetrieved value.
Returns
FALSE if either an error occurred or the [out] argument returns NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfo_GetSubjectA()

PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetSubjectA ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo,
char * pBuffer,
size_t nBufferSize )

The subject.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfo_GetSubjectW()

PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_GetSubjectW ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo,
WCHAR * pBuffer,
size_t nBufferSize )

The subject.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfo_SetAuthorA()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetAuthorA ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo,
const char * szAuthor )

The author.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
[in]szAuthorSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfo_SetAuthorW()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetAuthorW ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo,
const WCHAR * szAuthor )

The author.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
[in]szAuthorSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfo_SetContentA()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetContentA ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo,
const char * szContent )

The information content.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
[in]szContentSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfo_SetContentW()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetContentW ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo,
const WCHAR * szContent )

The information content.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
[in]szContentSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfo_SetCreationDate()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetCreationDate ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo,
const TPtxSys_Date * pCreationDate )

The date of creation.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
[in]pCreationDateSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfo_SetLocked()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetLocked ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo,
BOOL bLocked )

Whether the content can be modified This does not restrict the modification of other aspects of the annotation or its deletion.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
[in]bLockedSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfo_SetModificationDate()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetModificationDate ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo,
const TPtxSys_Date * pModificationDate )

The date of last modification.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
[in]pModificationDateSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfo_SetSubjectA()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetSubjectA ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo,
const char * szSubject )

The subject.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
[in]szSubjectSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfo_SetSubjectW()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfo_SetSubjectW ( TPtxPdfAnnots_MarkupInfo * pMarkupInfo,
const WCHAR * szSubject )

The subject.

Parameters
[in,out]pMarkupInfoActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfo.
[in]szSubjectSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfoList_Get()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_MarkupInfo *PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfoList_Get ( TPtxPdfAnnots_MarkupInfoList * pMarkupInfoList,
int iIndex )

Returns the element at the specified position in the given list.

Parameters
[in,out]pMarkupInfoListActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfoList.
[in]iIndex
Returns
NULL if there is an error.
Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_MarkupInfoList_GetCount()

PDFTOOLBOX_EXPORT int PDFTOOLBOX_CALL PtxPdfAnnots_MarkupInfoList_GetCount ( TPtxPdfAnnots_MarkupInfoList * pMarkupInfoList)

Get the number of elements in the list.

Parameters
[in,out]pMarkupInfoListActs as a handle to the native object of type TPtxPdfAnnots_MarkupInfoList.
Returns
May indicate an error in certain scenarios. For further information see the note section below.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_PolygonAnnotation_Create()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_PolygonAnnotation *PDFTOOLBOX_CALL PtxPdfAnnots_PolygonAnnotation_Create ( TPtxPdf_Document * pTargetDocument,
TPtxPdfContent_Path * pPath,
TPtxPdfContent_Stroke * pStroke,
TPtxPdfContent_Paint * pFill )

Create a polygon annotation. The returned polygon annotation is not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe output document with which the returned object is associated.
[in,out]pPathThe path of the polygon.
[in,out]pStrokeThe stroking parameters used for stroking the polygon. The stroking paint is used as the annotation's main paint. If NULL then the polygon is not filled.
[in,out]pFillThe paint used for filling the polygon. If NULL then the polygon is not filled.
Returns
The newly created polygon annotation.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_PolygonAnnotation_GetFill()

PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_PolygonAnnotation_GetFill ( TPtxPdfAnnots_PolygonAnnotation * pPolygonAnnotation)

The filling paint.

Parameters
[in,out]pPolygonAnnotationActs as a handle to the native object of type TPtxPdfAnnots_PolygonAnnotation.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_PolyLineAnnotation_Create()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_PolyLineAnnotation *PDFTOOLBOX_CALL PtxPdfAnnots_PolyLineAnnotation_Create ( TPtxPdf_Document * pTargetDocument,
TPtxPdfContent_Path * pPath,
TPtxPdfContent_Stroke * pStroke )

Create a poly-line annotation. The returned poly-line annotation is not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe output document with which the returned object is associated.
[in,out]pPathThe path of the poly line.
[in,out]pStrokeThe stroking parameters used for stroking the poly-line. The stroking paint is used as the annotation's main paint.
Returns
The newly created poly-line annotation.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_PolyLineAnnotation_GetEndStyle()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_LineEnding PDFTOOLBOX_CALL PtxPdfAnnots_PolyLineAnnotation_GetEndStyle ( TPtxPdfAnnots_PolyLineAnnotation * pPolyLineAnnotation)

The ending point's style.

Parameters
[in,out]pPolyLineAnnotationActs as a handle to the native object of type TPtxPdfAnnots_PolyLineAnnotation.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_PolyLineAnnotation_GetLineEndingFill()

PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_PolyLineAnnotation_GetLineEndingFill ( TPtxPdfAnnots_PolyLineAnnotation * pPolyLineAnnotation)

The line ending filling paint for both start and end.

Parameters
[in,out]pPolyLineAnnotationActs as a handle to the native object of type TPtxPdfAnnots_PolyLineAnnotation.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_PolyLineAnnotation_GetStartStyle()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_LineEnding PDFTOOLBOX_CALL PtxPdfAnnots_PolyLineAnnotation_GetStartStyle ( TPtxPdfAnnots_PolyLineAnnotation * pPolyLineAnnotation)

The starting point's style.

Parameters
[in,out]pPolyLineAnnotationActs as a handle to the native object of type TPtxPdfAnnots_PolyLineAnnotation.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_Popup_GetBoundingBox()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_Popup_GetBoundingBox ( TPtxPdfAnnots_Popup * pPopup,
TPtxGeomReal_Rectangle * pBoundingBox )

The pop-up location.

Parameters
[in,out]pPopupActs as a handle to the native object of type TPtxPdfAnnots_Popup.
[out]pBoundingBoxRetrieved value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_Popup_IsOpen()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxPdfAnnots_Popup_IsOpen ( TPtxPdfAnnots_Popup * pPopup)

The pop-up's visibility state.

Parameters
[in,out]pPopupActs as a handle to the native object of type TPtxPdfAnnots_Popup.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_RectangleAnnotation_Create()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_RectangleAnnotation *PDFTOOLBOX_CALL PtxPdfAnnots_RectangleAnnotation_Create ( TPtxPdf_Document * pTargetDocument,
const TPtxGeomReal_Rectangle * pBoundingBox,
TPtxPdfContent_Stroke * pStroke,
TPtxPdfContent_Paint * pFill )

Create a rectangle annotation. The returned rectangle annotation is not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe output document with which the returned object is associated.
[in]pBoundingBoxThe location on the page.
[in,out]pStrokeThe stroking parameters used for stroking the rectangle. The stroking paint is used as the annotation's main paint. If NULL then the rectangle is not stroked.
[in,out]pFillThe paint used for filling the rectangle. If NULL then the rectangle is not filled.
Returns
The newly created rectangle annotation.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_RectangleAnnotation_GetFill()

PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_RectangleAnnotation_GetFill ( TPtxPdfAnnots_RectangleAnnotation * pRectangleAnnotation)

The filling paint.

Parameters
[in,out]pRectangleAnnotationActs as a handle to the native object of type TPtxPdfAnnots_RectangleAnnotation.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_Squiggly_CreateFromQuadrilaterals()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_Squiggly *PDFTOOLBOX_CALL PtxPdfAnnots_Squiggly_CreateFromQuadrilaterals ( TPtxPdf_Document * pTargetDocument,
TPtxGeomReal_QuadrilateralList * pMarkupArea,
TPtxPdfContent_Paint * pPaint )

Create a new squiggly underline with defined area The area to be underlined is defined by the given pMarkupArea. The returned object is associated with the pTargetDocument but not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe document in which the links is used
[in,out]pMarkupAreaThe area on the page to be underlined.
[in,out]pPaintThe paint used for drawing the squiggly underline
Returns
The newly created object

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_Stamp_GetPopup()

The pop-up.

Parameters
[in,out]pStampActs as a handle to the native object of type TPtxPdfAnnots_Stamp.
Returns
Retrieved value.

NULL if either an error occurred or the returned object is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.

Note
An error occurred when NULL was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_Stamp_GetPopupPaint()

PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_Stamp_GetPopupPaint ( TPtxPdfAnnots_Stamp * pStamp)

The paint for the popup.

Parameters
[in,out]pStampActs as a handle to the native object of type TPtxPdfAnnots_Stamp.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_Stamp_GetType()

Get actual derived type of base type TPtxPdfAnnots_Stamp.

This function is invoked prior to downcasting to ascertain the derived object type.

Parameters
[in,out]pStampActs as a handle to a native object.
Returns
The item of the enumeration TPtxPdfAnnots_StampType that refers to the actual derived type. 0 in case of an error.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdfAnnots_StickyNote_CreateA()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_StickyNote *PDFTOOLBOX_CALL PtxPdfAnnots_StickyNote_CreateA ( TPtxPdf_Document * pTargetDocument,
const TPtxGeomReal_Point * pTopLeft,
const char * szContent,
TPtxPdfContent_Paint * pPaint )

Create a sticky note annotation. The returned sticky note annotation is not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe output document with which the returned object is associated
[in]pTopLeftThe location of the annotation's upper left corner on the page
[in]szContentThe text content
[in,out]pPaintThe paint for the sticky note icon.
Returns
The newly created sticky note annotation

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_StickyNote_CreateW()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_StickyNote *PDFTOOLBOX_CALL PtxPdfAnnots_StickyNote_CreateW ( TPtxPdf_Document * pTargetDocument,
const TPtxGeomReal_Point * pTopLeft,
const WCHAR * szContent,
TPtxPdfContent_Paint * pPaint )

Create a sticky note annotation. The returned sticky note annotation is not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe output document with which the returned object is associated
[in]pTopLeftThe location of the annotation's upper left corner on the page
[in]szContentThe text content
[in,out]pPaintThe paint for the sticky note icon.
Returns
The newly created sticky note annotation

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_StickyNote_GetPaint()

PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_StickyNote_GetPaint ( TPtxPdfAnnots_StickyNote * pStickyNote)

The paint for the icon and the popup.

Parameters
[in,out]pStickyNoteActs as a handle to the native object of type TPtxPdfAnnots_StickyNote.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_StickyNote_GetPopup()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_Popup *PDFTOOLBOX_CALL PtxPdfAnnots_StickyNote_GetPopup ( TPtxPdfAnnots_StickyNote * pStickyNote)

The pop-up.

Parameters
[in,out]pStickyNoteActs as a handle to the native object of type TPtxPdfAnnots_StickyNote.
Returns
Retrieved value.

NULL if either an error occurred or the returned object is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.

Note
An error occurred when NULL was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_StrikeThrough_CreateFromQuadrilaterals()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_StrikeThrough *PDFTOOLBOX_CALL PtxPdfAnnots_StrikeThrough_CreateFromQuadrilaterals ( TPtxPdf_Document * pTargetDocument,
TPtxGeomReal_QuadrilateralList * pMarkupArea,
TPtxPdfContent_Paint * pPaint )

Create a new strike-through with defined area The area to be striked through is defined by the given pMarkupArea. The returned object is associated with the pTargetDocument but not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe document in which the links is used
[in,out]pMarkupAreaThe area on the page to be striked through.
[in,out]pPaintThe paint used for drawing the strike through
Returns
The newly created object

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_TextInsert_GetPaint()

PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_TextInsert_GetPaint ( TPtxPdfAnnots_TextInsert * pTextInsert)

The paint for the annotation and the popup.

Parameters
[in,out]pTextInsertActs as a handle to the native object of type TPtxPdfAnnots_TextInsert.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_TextInsert_GetPopup()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_Popup *PDFTOOLBOX_CALL PtxPdfAnnots_TextInsert_GetPopup ( TPtxPdfAnnots_TextInsert * pTextInsert)

The pop-up.

Parameters
[in,out]pTextInsertActs as a handle to the native object of type TPtxPdfAnnots_TextInsert.
Returns
Retrieved value.

NULL if either an error occurred or the returned object is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.

Note
An error occurred when NULL was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_TextMarkup_GetMarkupArea()

PDFTOOLBOX_EXPORT TPtxGeomReal_QuadrilateralList *PDFTOOLBOX_CALL PtxPdfAnnots_TextMarkup_GetMarkupArea ( TPtxPdfAnnots_TextMarkup * pTextMarkup)

The markup area This list of TPtxGeomReal_Quadrilaterals defines the markup area on the page.

Parameters
[in,out]pTextMarkupActs as a handle to the native object of type TPtxPdfAnnots_TextMarkup.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_TextMarkup_GetPaint()

PDFTOOLBOX_EXPORT TPtxPdfContent_Paint *PDFTOOLBOX_CALL PtxPdfAnnots_TextMarkup_GetPaint ( TPtxPdfAnnots_TextMarkup * pTextMarkup)

The paint the annotation and the popup.

Parameters
[in,out]pTextMarkupActs as a handle to the native object of type TPtxPdfAnnots_TextMarkup.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_TextMarkup_GetPopup()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_Popup *PDFTOOLBOX_CALL PtxPdfAnnots_TextMarkup_GetPopup ( TPtxPdfAnnots_TextMarkup * pTextMarkup)

The pop-up.

Parameters
[in,out]pTextMarkupActs as a handle to the native object of type TPtxPdfAnnots_TextMarkup.
Returns
Retrieved value.

NULL if either an error occurred or the returned object is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.

Note
An error occurred when NULL was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_TextMarkup_GetType()

Get actual derived type of base type TPtxPdfAnnots_TextMarkup.

This function is invoked prior to downcasting to ascertain the derived object type.

Parameters
[in,out]pTextMarkupActs as a handle to a native object.
Returns
The item of the enumeration TPtxPdfAnnots_TextMarkupType that refers to the actual derived type. 0 in case of an error.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdfAnnots_TextStamp_Create()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_TextStamp *PDFTOOLBOX_CALL PtxPdfAnnots_TextStamp_Create ( TPtxPdf_Document * pTargetDocument,
const TPtxGeomReal_Point * pTopLeft,
const double * pHeight,
TPtxPdfAnnots_TextStampType iTextType )

Create a text stamp annotation. The width of the annotation is computed based on the given iTextType. The returned text stamp annotation is not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe output document with which the returned object is associated.
[in]pTopLeftThe location of the annotation's upper left corner on the page.
[in]pHeightThe height of the annotation.
[in]iTextTypeThe text stamp type.
Returns
The newly created text stamp annotation.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_TextStamp_CreateRawA()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_TextStamp *PDFTOOLBOX_CALL PtxPdfAnnots_TextStamp_CreateRawA ( TPtxPdf_Document * pTargetDocument,
const TPtxGeomReal_Point * pTopLeft,
const double * pHeight,
TPtxPdfAnnots_TextStampType iTextType,
const char * szText )

Create a text stamp annotation. The width of the annotation is computed from the given stamp text. The returned text stamp annotation is not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe output document with which the returned object is associated.
[in]pTopLeftThe location of the annotation's upper left corner on the page.
[in]pHeightThe height of the annotation.
[in]iTextTypeThe text stamp type.
[in]szTextThe text to be shown in this stamp.
Returns
The newly created text stamp annotation.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:
Deprecated
Deprecated in Version 4.2. Use static method TextStamp.Create instead.

◆ PtxPdfAnnots_TextStamp_CreateRawW()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_TextStamp *PDFTOOLBOX_CALL PtxPdfAnnots_TextStamp_CreateRawW ( TPtxPdf_Document * pTargetDocument,
const TPtxGeomReal_Point * pTopLeft,
const double * pHeight,
TPtxPdfAnnots_TextStampType iTextType,
const WCHAR * szText )

Create a text stamp annotation. The width of the annotation is computed from the given stamp text. The returned text stamp annotation is not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe output document with which the returned object is associated.
[in]pTopLeftThe location of the annotation's upper left corner on the page.
[in]pHeightThe height of the annotation.
[in]iTextTypeThe text stamp type.
[in]szTextThe text to be shown in this stamp.
Returns
The newly created text stamp annotation.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:
Deprecated
Deprecated in Version 4.2. Use static method TextStamp.Create instead.

◆ PtxPdfAnnots_TextStamp_GetTextType()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_TextStampType PDFTOOLBOX_CALL PtxPdfAnnots_TextStamp_GetTextType ( TPtxPdfAnnots_TextStamp * pTextStamp)

The displayed text This defines a predefined text for this text stamp.

Parameters
[in,out]pTextStampActs as a handle to the native object of type TPtxPdfAnnots_TextStamp.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdfAnnots_Underline_CreateFromQuadrilaterals()

PDFTOOLBOX_EXPORT TPtxPdfAnnots_Underline *PDFTOOLBOX_CALL PtxPdfAnnots_Underline_CreateFromQuadrilaterals ( TPtxPdf_Document * pTargetDocument,
TPtxGeomReal_QuadrilateralList * pMarkupArea,
TPtxPdfContent_Paint * pPaint )

Create a new underline with defined area The area to be underlined is defined by the given pMarkupArea. The returned object is associated with the pTargetDocument but not yet part of any page. It can be added to a page's list of annotations.

Parameters
[in,out]pTargetDocumentThe document in which the links is used
[in,out]pMarkupAreaThe area on the page to be underlined.
[in,out]pPaintThe paint used for drawing the underline
Returns
The newly created object

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes: