AddLinkToEmbeddedFile

Właściwości dokumentu, Adnotacje i łącza obszarów aktywnych

Opis

Dodaje do wybranej strony prostokątną adnotację FileAttachment i łączy ją z osadzonym plikiem już zapisanym w dokumencie.

Najpierw wywołaj AddEmbeddedFile, aby skopiować bajty pliku do PDF i uzyskać EmbeddedFileID. AddLinkToEmbeddedFile tworzy adnotację strony, zapisuje tytuł załącznika i zawartość okna podręcznego oraz kieruje adnotację do tej specyfikacji osadzonego pliku.

Zachowanie wersji PDF: adnotacje FileAttachment i strumienie osadzonych plików wymagają PDF 1.3. Wygląd adnotacji generowany przez tę funkcję może obejmować krycie adnotacji za pomocą /CA i zasobów przezroczystości, które wymagają PDF 1.4. Jeśli bieżąca wersja dokumentu jest niższa, a wersja zapisu nie jest zablokowana, AddLinkToEmbeddedFile automatycznie podnosi wersję dokumentu do PDF 1.4 i zapisuje /CA annotation opacity w AutoBumpedFeatures. Jeśli wywołujący zablokuje niższą wersję zapisu, kontrola zgodności odrzuci zapis z kodem LastErrorCode 602.

Składnia

Delphi

Function TPDFlib.AddLinkToEmbeddedFile(Left, Top, Width, Height: Double; EmbeddedFileID: Integer; Const Title, Contents: WideString; IconType, Transparency: Integer): Integer;

ActiveX

Function PDFlib::AddLinkToEmbeddedFile(Left As Double, Top As Double, Width As Double, Height As Double, EmbeddedFileID As Long, Title As String, Contents As String, IconType As Long, transpareny As Long) As Long

DLL

int DLAddLinkToEmbeddedFile(int InstanceID, double Left, double Top, double Width, double Height, int EmbeddedFileID, const wchar_t * Title, const wchar_t * Contents, int IconType, int transpareny);

Parametry

Left	Pozioma współrzędna lewej krawędzi prostokąta adnotacji.
Top	Pionowa współrzędna górnej krawędzi prostokąta adnotacji.
Width	Szerokość prostokąta adnotacji.
Height	Wysokość prostokąta adnotacji.
EmbeddedFileID	Wartość zwrócona przez AddEmbeddedFile.
Title	Tytuł załącznika wyświetlany przez przeglądarkę PDF.
Contents	Tekst wyświetlany w oknie podręcznym adnotacji.
IconType	Ikona adnotacji: 0 = PushPin, 1 = obraz dysku, 2 = brak ikony, 3 = wykres, 4 = spinacz, 5 = etykieta, 6 = pełny biały prostokąt.
Transparency	Procent przezroczystości od 0 do 100. Zero oznacza pełne krycie; 100 czyni ikonę niewidoczną.

Wartości zwracane

0	Wartość EmbeddedFileID jest nieprawidłowa, nie wybrano strony albo żaden dokument nie jest aktywny.
1	Adnotacja FileAttachment została utworzona pomyślnie.

Zobacz również

AddEmbeddedFile, AddFileAttachment, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount