DAAppendFile

Zarządzanie dokumentem, Funkcje dostępu bezpośredniego

Opis

Dołącza wszystkie zmiany wprowadzone w dokumencie otwartym pierwotnie funkcją DAOpenFile. Jest to szybka operacja, ponieważ na końcu oryginalnego pliku trzeba dodać tylko zmienione obiekty. Po operacji plik zostaje zamknięty, a jego uchwyt traci ważność.

Ta funkcja nie zadziała, jeśli plik źródłowy otwarto w trybie tylko do odczytu albo dokument wczytano z nieprawidłowego pliku, na przykład z białymi znakami dodanymi na jego początku. W takich przypadkach należy zamiast niej użyć funkcji DASaveAsFile.

Składnia

Delphi

Function TPDFlib.DAAppendFile(FileHandle: Integer): Integer;

ActiveX

Function PDFlib::DAAppendFile(FileHandle As Long) As Long

DLL

int DLDAAppendFile(int InstanceID, int FileHandle);

Parametry

FileHandle	Uchwyt zwrócony przez funkcję DAOpenFile, DAOpenFileReadOnly lub DAOpenFromStream

Wartości zwracane

0	Podany FileHandle był nieprawidłowy Zmiany pliku zostały pomyślnie dołączone
1	2 Plik otwarto w trybie tylko do odczytu i nie można zapisać aktualizacji. Użyj zamiast tego DASaveAsFile. 3 Dokument otwarto z nieprawidłowego pliku i operacja dołączania nie jest możliwa. Zobacz funkcję DAShiftedHeader.