AddLinkToFileA

Annotationer og hotspot-links

Beskrivelse

Det afsluttende A angiver ANSI-indgangspunktet (char) i DLL'en; ActiveX/COM-overfladen eksponerer kun Unicode-formen. Adfærden er identisk med AddLinkToFile, og strengargumenter fortolkes ud fra den aktuelle kodetabel i SetAnsiMode

Denne side dokumenterer AddLinkToFile i PDFlibPas under emnet Annotationer og hotspot-links. API-navne, parametre, klasser, filnavne og literale værdier bevares, så de matcher Delphi-biblioteket og DLL-indgangspunkterne.

Gennemgå syntaks, parametre og returværdier, før du kalder funktionen. Kodeblokke bevares i original form, så eksemplerne kan kopieres uden ændringer.

Syntaks

Delphi

Function DLAddLinkToFileA(InstanceID: Integer; Left, Top, Width, Height: Double; FileName: PAnsiChar; Page: Integer; Position: Double; NewWindow, Options: Integer): Integer;

DLL

int DLAddLinkToFileA(int InstanceID, double Left, double Top, double Width, double Height, const char * FileName, int Page, double Position, int NewWindow, int Options);

Parametre

Left	`Left` definerer en koordinat, dimension eller måling i de aktuelle sideenheder.
Top	`Top` definerer en koordinat, dimension eller måling i de aktuelle sideenheder.
Width	`Width` definerer en koordinat, dimension eller måling i de aktuelle sideenheder.
Height	`Height` definerer en koordinat, dimension eller måling i de aktuelle sideenheder.
FileName	`FileName` angiver en filsti eller et filnavn. Brug en gyldig sti til den aktuelle arbejdsgang, og bevar den kodning, som API'et forventer.
Page	`Page` identificerer en side eller sidereference i det aktuelle PDF-dokument.
Position	`Position` er en parameter til `AddLinkToFile`. Brug typen fra signaturen, og angiv en værdi, der passer til det aktuelle PDF-dokument, den valgte side eller den aktive ressource.
NewWindow	`NewWindow` er en parameter til `AddLinkToFile`. Brug typen fra signaturen, og angiv en værdi, der passer til det aktuelle PDF-dokument, den valgte side eller den aktive ressource.
Options	`Options` er en bitmaske eller numerisk indstilling, der justerer kaldets adfærd.

Returværdier

0	Denne værdi beskriver resultatet af `AddLinkToFile`. Som hovedregel betyder en værdi forskellig fra nul succes, mens 0 betyder, at handlingen ikke blev fuldført.
1	Denne værdi beskriver resultatet af `AddLinkToFile`. Som hovedregel betyder en værdi forskellig fra nul succes, mens 0 betyder, at handlingen ikke blev fuldført.