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
| Key | Nazwa ustawianego klucza. Aby uniknąć konfliktów z innym oprogramowaniem, klucz musi mieć specjalny prefiks przydzielony przez firmę Adobe |
|---|---|
| NewValue | Nowa wartość wskazanego klucza |
Wartości zwracane
| 0 | Nie udało się ustawić wskazanego klucza, ponieważ mógł to być klucz systemowy |
|---|---|
| 1 | Wartość wskazanego klucza została pomyślnie ustawiona |