AddStampAnnotationA

Annotations and hotspot links

Description

The trailing A denotes the ANSI (char) DLL entry point; the ActiveX/COM surface exposes only the Unicode form. Behaviour is identical to AddStampAnnotation and string arguments are interpreted using the current SetAnsiMode code page

Adds a stamp annotation to the selected page. The values of the colour parameters range from 0 to 1, with 0 indicating 0% and 1 indicating 100% of the colour. The colour only affects the background colour of the popup and not the stamp itself.

When the selected document is below PDF 1.3, the writer automatically raises the effective PDF version to 1.3 because stamp annotations were introduced in PDF 1.3.

Syntax

Delphi

Function DLAddStampAnnotationA(InstanceID: Integer; Left, Top, Width, Height: Double; StampType: Integer; Title, Contents: PAnsiChar; Red, Green, Blue: Double; Options: Integer): Integer;

DLL

int DLAddStampAnnotationA(int InstanceID, double Left, double Top, double Width, double Height, int StampType, const char * Title, const char * Contents, double Red, double Green, double Blue, int Options);

Parameters

Left

The horizontal coordinate of the left edge of the stamp annotation

Top

The vertical coordinate of the top edge of the stamp annotation

Width

The width of the annotation

Height

The height of the annotation

StampType

0 = Approved

1 = Experimental

2 = NotApproved

3 = AsIs

4 = Expired

5 = NotForPublicRelease

6 = Confidential

7 = Final

8 = Sold

9 = Departmental

10 = ForComment

11 = TopSecret

12 = Draft

13 = ForPublicRelease

Title

The title of the popup annotation

Contents

The contents of the popup annotation

Red

The red component of the popup annotation's background colour

Green

The green component of the popup annotation's background colour

The blue component of the popup annotation's background colour

Blue

Options

Reserved for future use. Should always be set to 0.

Return values