ReplacePageRanges
טיפול במסמכים
תיאור
מחליף את התוכן החזותי ואת התצוגה ברמת העמוד של עמודים קיימים במסמך הנבחר בעמודים המיובאים ממסמך אחר שנפתח, תוך שמירה על אובייקטי העמוד היעד
תחביר
Delphi
Function TPDFlib.ReplacePageRanges(DocumentID, TargetStartPage: Integer; Const RangeList: WideString; Options: Integer= 0): Integer;פרמטרים
| DocumentID | המזהה של מסמך המקור הפתוח, שחייב להיות שונה ממסמך היעד הנבחר |
|---|---|
| TargetStartPage | מספר העמוד, החל מ-1, במסמך היעד הנבחר שבו מתחילה ההחלפה |
| RangeList | ביטוי טווחי עמודי המקור, למשל "1-3,5"; תווים בלתי תקינים או עמודים מחוץ לטווח מכשילים את הקריאה כולה |
| Options | 0 ממיין את העמודים ומסיר כפילויות; 1 שומר על סדר המקור ומרשה מספרי עמודים חוזרים |
ערכים מוחזרים
| 0 | האימות או ההחלפה נכשלו ועמודי היעד נותרו ללא שינוי |
|---|---|
| 1 | עמודי היעד המבוקשים הוחלפו |
הערות
הפעולה מעבירה את Contents, Resources, את חמשת תיבות העמוד, Rotate, Group, UserUnit ואת BoxColorInfo. מספרי אובייקטי העמוד היעד, הערות, Widget של טופס, יעדי סימניות והפניות קיימות אחרות נשארים מחוברים. הערות מקור, שדות טופס ומתארים אינם מיובאים. מספר העמודים נשאר ללא שינוי, וכל טווחי המקור וכן הקיבולת של היעד מאומתים לפני השינוי
דוגמה
var SourceDoc: Integer;
SourceDoc := PDF.LoadFromFile('source.pdf', '');
PDF.SelectDocument(MainDoc);
// Replace page 2 of MainDoc with page 1 of source.pdf
PDF.ReplacePageRanges(SourceDoc, 2, '1', 0);