CapturePageEx

טיפול בעמודים

תיאור

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

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

ImportPageAsFormXObject כדי לשמר את עמוד המקור או לייבא אותו ממסמך פתוח אחר"תיבת המדיה" (media box) של העמוד משמשת כמלבן התוחם עבור העמוד שנלכד. ניתן להשתמש בפונקציה CapturePageEx במקרים שבהם יש להשתמש במקום זאת ב"תיבת החיתוך" (crop box) של העמוד

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

תחביר

Delphi

Function TPDFlib.CapturePageEx(Page, Options: Integer): Integer;

ActiveX

Function PDFlib::CapturePageEx(Page As Long, Options As Long) As Long

DLL

int DLCapturePageEx(int InstanceID, int Page, int Options);

פרמטרים

Pageמספר העמוד ללכידה. העמוד הראשון במסמך הוא עמוד 1
Options0 = שימוש בתיבת המדיה של העמוד כמלבן התוחם 1 = שימוש בתיבת החיתוך של העמוד כמלבן התוחם אם קיימת, אחרת שימוש בתיבת המדיה 2 = שימוש בתיבת הדימום של העמוד כמלבן התוחם אם קיימת, אחרת שימוש בתיבת החיתוך 3 = שימוש בתיבת החיתוך הסופי (trim box) של העמוד כמלבן התוחם אם קיימת, אחרת שימוש בתיבת החיתוך 4 = שימוש בתיבת האמנות (art box) של העמוד כמלבן התוחם אם קיימת, אחרת שימוש בתיבת החיתוך

ערכים מוחזרים

0העמוד שצוין אינו קיים, או שהוא העמוד היחיד במסמך
Non-zeroהמזהה של תהליך הלכידה. מזהה זה חייב להימסר לפונקציה DrawCapturedPage