BeginArtifactA

Tagged PDF, Dostępność

Opis

Końcowa litera A oznacza punkt wejścia DLL ANSI (char); powierzchnia ActiveX/COM udostępnia wyłącznie postać Unicode. Zachowanie jest identyczne jak w BeginArtifact, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode

Otwiera region artefaktu PDF. Zawartość artefaktu ma charakter dekoracyjny lub strukturalny (nagłówki i stopki stron, numery stron, obrazy tła, linie rozdzielające) i jest jawnie wykluczona z logicznej kolejności odczytu dokumentu. Czytniki ekranu całkowicie pomijają regiony artefaktów.

Zapisz grafikę lub tekst artefaktu między wywołaniem BeginArtifact a odpowiadającym mu wywołaniem EndArtifact.

Składnia

Delphi

Function DLBeginArtifactA(InstanceID: Integer; SubType: PAnsiChar): Integer;

DLL

int DLBeginArtifactA(int InstanceID, const char * SubType);

Parametry

SubType	Opcjonalna nazwa podtypu artefaktu. Typowe wartości: `Header`, `Footer`, `Watermark`, `Background`. Przekaż pusty ciąg, aby pominąć podtyp

Wartości zwracane

0	Niepowodzenie (brak otwartego dokumentu)
1	Region artefaktu został pomyślnie otwarty

Przykład

// Page footer as artifact
PDF.BeginArtifact('Footer');
PDF.SetFontSize(8);
PDF.PrintText(50, 20, 'Page 1 of 10');
PDF.EndArtifact;