SetOutlineRemoteDestinationA

Konspekty

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

Ustawia element konspektu (zakładkę) tak, aby po kliknięciu otwierał inny plik PDF

Można określić numer otwieranej strony oraz różne wartości rozmiaru i położenia

Uwaga: ponieważ rozmiar strony dokumentu docelowego jest nieznany, wszystkie pozycje są podawane w punktach mierzonych od lewego dolnego rogu otwieranej strony

Składnia

Delphi

Function DLSetOutlineRemoteDestinationA(InstanceID, OutlineID: Integer; FileName: PAnsiChar; OpenPage, Zoom, DestType: Integer; PntLeft, PntTop, PntRight, PntBottom: Double; NewWindow: Integer): Integer;

DLL

int DLSetOutlineRemoteDestinationA(int InstanceID, int OutlineID, const char * FileName, int OpenPage, int Zoom, int DestType, double PntLeft, double PntTop, double PntRight, double PntBottom, int NewWindow);

Parametry

OutlineID

Identyfikator konspektu zwrócony przez funkcję NewOutline. Prawidłowy identyfikator można też uzyskać za pomocą GetOutlineID

FileName

Nazwa pliku dokumentu PDF otwieranego po kliknięciu konspektu. Powinna mieć określony format. Ukośniki odwrotne należy zamienić na zwykłe, a dysk, jeśli występuje, podać wyłącznie jako literę dysku między zwykłymi ukośnikami, bez dwukropka. Na przykład plik "c:\my documents\hello.pdf" należy podać jako "/c/my documents/hello.pdf". Dozwolone są ścieżki względne, w tym ścieżki zawierające operator ".." przejścia do katalogu nadrzędnego

OpenPage

Numer strony otwieranej w dokumencie docelowym. Pierwsza strona ma indeks zero (0)

Zoom

Procent powiększenia po otwarciu dokumentu, od 0 do 6400. Używany tylko dla DestType = 1; dla innych wartości DestType powinien wynosić 0

DestType

1 = "XYZ" - strona docelowa jest ustawiana w punkcie określonym przez parametry Left i Top. Parametr Zoom określa procent powiększenia

2 = "Fit" - cała strona jest skalowana tak, aby zmieściła się w oknie. Pozostałe parametry nie są używane i należy ustawić je na zero

3 = "FitH" - skala strony jest dobierana tak, aby widoczna była cała szerokość strony. Wysokość strony może być większa lub mniejsza od wysokości okna. Strona jest ustawiana w pionowej pozycji określonej przez parametr Top

4 = "FitV" - skala strony jest dobierana tak, aby widoczna była cała wysokość strony. Szerokość strony może być większa lub mniejsza od szerokości okna. Strona jest ustawiana w poziomej pozycji określonej przez parametr Left

5 = "FitR" - skala strony jest dobierana tak, aby był widoczny określony prostokąt strony. Parametry Left, Top, Right i Bottom definiują prostokątny obszar strony

6 = "FitB" - skala strony jest dobierana tak, aby widoczny był jej prostokąt ograniczający'

7 = "FitBH" - strona jest ustawiana w pionowej pozycji określonej przez parametr Top. Skala strony jest dobierana tak, aby widoczna była cała szerokość prostokąta ograniczającego stronę'

8 = "FitBV" - strona jest ustawiana w poziomej pozycji określonej przez parametr Left. Skala strony jest dobierana tak, aby w oknie zmieściła się cała wysokość prostokąta ograniczającego

PntLeft

Położenie poziome używane przez DestType = 1, 4, 5 i 8. Położenie podaje się w punktach mierzonych od lewego dolnego narożnika strony dokumentu docelowego's

PntTop

Pozycja pionowa używana przez DestType = 1, 3, 5 i 7. Jest podawana w punktach mierzonych od lewego dolnego rogu strony dokumentu docelowego's

PntRight

Pozycja pozioma prawej krawędzi prostokąta, używana przez DestType = 5. Jest podawana w punktach mierzonych od lewego dolnego rogu strony dokumentu docelowego's

PntBottom

Pozycja pozioma dolnej krawędzi prostokąta, używana przez DestType = 5. Jest podawana w punktach mierzonych od lewego dolnego rogu strony dokumentu docelowego's

NewWindow

0 = Zastąp bieżący dokument dokumentem docelowym

1 = otwórz dokument docelowy w nowym oknie, chyba że użytkownik ustawił inną preferencję w przeglądarce PDF

Wartości zwracane