CapturePage

מניפולציה של עמודים

תיאור

הפונקציה "לוכדת" עמוד. אחרי שהעמוד נלכד אפשר לצייר אותו על עמודים אחרים. זה שימושי לשילוב עמודים שונים או להצבת יותר מעמוד מקור אחד על עמוד אחר (imposition). אחרי שעמוד נלכד הוא מוסר מהמסמך. אם ברצונכם שהעמוד יישאר במסמך, עליכם ליצור עמוד ריק ולצייר עליו את העמוד הלכוד

בנוסף, משום שלמסמך חייב להיות לפחות עמוד אחד בכל עת לא ניתן ללכוד עמוד אם הוא העמוד היחיד במסמך; במקרה זה יש להוסיף עמוד ריק חדש לפני שהעמוד הקיים ניתן ללכידה

אי אפשר להשתמש ב-CapturePage כדי להעביר עמודים ממסמך אחד למסמך חדש אחר, ולכן צריך למזג את כל העמודים הנדרשים למסמך אחד לפני הקריאה ל-CapturePage. ה-CaptureID הוא רק מצביע לעמוד נסתר, ולכן אין צורך לשחרר זיכרון

ה-"media box" של העמוד משמש כמלבן התוחם לעמוד הלכוד. את הפונקציה CapturePage אפשר להשתמש בה במקרים שבהם יש להשתמש במקום זאת ב-"crop box" של העמוד

תחביר

Delphi

Function TPDFlib.CapturePage(Page: Integer): Integer;

ActiveX

Function PDFlib::CapturePage(Page As Long) As Long

DLL

int DLCapturePage(int InstanceID, int Page);

פרמטרים

ערכי החזרה