SetCatalogInformationA

Właściwości dokumentu

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 SetCatalogInformation, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode

Ta funkcja umożliwia zapisanie niestandardowych informacji w dokumencie PDF. Działa podobnie do funkcji SetCustomInformation, lecz informacje są zapisywane w katalogu dokumentu zamiast w słowniku informacji o dokumencie. Metadane należy zapisywać w słowniku informacji o dokumencie za pomocą SetCustomInformation, natomiast treści prywatne lub informacje strukturalne należy zapisywać w katalogu dokumentu za pomocą tej funkcji

Klucz nie może być kluczem systemowym katalogu zarządzanym przez bibliotekę lub specyfikację PDF. Nazwy zastrzeżone obejmują Type, Version, Extensions, Pages, PageLabels, Names, Dests, ViewerPreferences, OpenAction, AA, AcroForm, Metadata, StructTreeRoot, MarkInfo, Lang, SpiderInfo, OutputIntents, PieceInfo, OCProperties, Perms, Legal, Requirements, Collection oraz NeedsRendering

Składnia

Delphi

Function DLSetCatalogInformationA(InstanceID: Integer; Key, NewValue: PAnsiChar): Integer;

DLL

int DLSetCatalogInformationA(int InstanceID, const char * Key, const char * NewValue);

Parametry

KeyNazwa ustawianego klucza. Aby uniknąć konfliktów z innym oprogramowaniem, klucz musi mieć specjalny prefiks przydzielony przez firmę Adobe
NewValueNowa wartość wskazanego klucza

Wartości zwracane

0Nie udało się ustawić wskazanego klucza, ponieważ mógł to być klucz systemowy
1Wartość wskazanego klucza została pomyślnie ustawiona