דף – Aspose FOSS API Reference

דף

סקירה כללית

Page היא מחלקה ב‑Aspose.PDF FOSS עבור .NET. יורשת מ: IDisposable.

מייצג דף במסמך PDF.

מחלקה זו מספקת 53 שיטות לעבודה עם אובייקטי Page בתוכניות .NET. השיטות הזמינות כוללות: Accept, AddContent, AddContentStream, AddExtGState, AddFloatingBox, AddGraph, AddGraphics, AddImage, AddStamp, AddTable, AsByteArray, AsXml, ו‑27 שיטות נוספות. כל החברים הציבוריים נגישים לכל יישום .NET לאחר התקנת חבילת Aspose.PDF FOSS for .NET. מאפיינים: Actions, Annotations, ArtBox, Artifacts, Background, BackgroundImage, ו‑34 נוספים.

מאפיינים

שם	סוג	גישה	תיאור
`Number`	`int`	Read	מספר עמוד שמתחיל ב‑1.
`FieldsInTabOrder`	`IList<Forms.Field>`	Read	שדות טופס שהווידג’טים שלהם מופיעים בעמוד זה, ממוינים לפי סדר הטאבים שלהם.
`Rect`	`Rectangle`	Read/Write	מלבן העמוד (בברירת מחדל ל‑MediaBox).
`Rectangle`	`Rectangle`	Read/Write	מלבן העמוד.
`PageInfo`	`PageInfo`	Read/Write	מכולת מידע על העמוד עם תכונות רוחב/גובה/שוליים.
`Background`	`Color?`	Read/Write	מקבל או מגדיר את הרקע.
`MediaBox`	`Rectangle`	Read/Write	תיבת המדיה (MediaBox) עבור עמוד זה (נדרשת לפי המפרט).
`CropBox`	`Rectangle`	Read/Write	תיבת החיתוך (CropBox) (בברירת מחדל לתיבת המדיה).
`BleedBox`	`Rectangle`	Read/Write	תיבת הדימום (BleedBox) (בברירת מחדל לתיבת החיתוך).
`TrimBox`	`Rectangle`	Read/Write	תיבת החיתוך הסופי (TrimBox) (בברירת מחדל לתיבת החיתוך).
`ArtBox`	`Rectangle`	Read/Write	תיבת האמנות (ArtBox) (בברירת מחדל לתיבת החיתוך).
`Rotate`	`Rotation`	Read/Write	סיבוב העמוד כמחלקת Rotation.
`RotateDegrees`	`int`	Read/Write	סיבוב העמוד במעלות כמספר שלם (0, 90, 180, 270).
`RotationMatrix`	`Matrix`	Read	טרנספורמציה אפינית שממפה את מערכת הקואורדינטות של PDF ללא סיבוב למערכת הנראית למשתמש (מסובבת) של העמוד.
`Duration`	`double`	Read/Write	משך הצגת העמוד בשניות במצב מצגת.
`Annotations`	`AnnotationCollection`	Read	הסברים (Annotations) על עמוד זה.
`Images`	`XImageCollection`	Read	אובייקטי תמונה XObjects בעמוד זה.
`Fonts`	`FontCollection`	Read	גופנים שמופנים בעמוד זה.
`Resources`	`Resources`	Read	משאבי העמוד (גופנים, תמונות) — מספק גישה דרך אובייקט Resources מאוחד.
`Patterns`	`IReadOnlyDictionary<string, Pattern>`	Read	משאבי תבנית (Pattern) בעמוד זה (ממופים לפי שם התבנית).
`Contents`	`OperatorCollection`	Read	אוסף של מפעילי זרם תוכן.
`Width`	`double`	Read	רוחב העמוד הנראה בהתחשב בסיבוב.
`Height`	`double`	Read	גובה העמוד הנראה בהתחשב בסיבוב.
`ColorType`	`ColorType`	Read	מקבל את סוג הצבע של עמוד זה על ידי ניתוח מפעילי זרם התוכן ומרחבי הצבע של התמונות.
`Transition`	`PageTransition?`	Read	אפקט המעבר של העמוד, או null אם לא הוגדר.
`Header`	`HeaderFooter?`	Read/Write	כותרת עליונה (Header) להצגה בחלק העליון של העמוד.
`Footer`	`HeaderFooter?`	Read/Write	כותרת תחתונה (Footer) להצגה בחלק התחתון של העמוד.
`TocInfo`	`TocInfo?`	Read/Write	מידע TOC (תוכן עניינים) עבור עמוד זה.
`Paragraphs`	`Paragraphs`	Read/Write	אוסף של אובייקטי פסקה להוספה לעמוד זה (TextFragment, HtmlFragment, Table, Heading וכו’).
`NoteLineStyle`	`GraphInfo`	Read/Write	סגנון קו ברירת מחדל (stroke/fill) המשמש לציור קווי הפרדה של הערות שוליים / הערות סיום.
`Artifacts`	`ArtifactCollection`	Read	אוסף להוספת פריטים (כגון סימני מים וכו’) לעמוד זה.
`OcgLayers`	`LayerCollection`	Read	מקבל את השכבות (Optional Content Groups) שמופנות בעמוד זה.
`Actions`	`PageActionCollection`	Read	פעולות נוספות לכל עמוד (פתיחה / סגירה / וכו’).
`UserUnit`	`double`	Read/Write	גורם יחידת משתמש (User-unit factor) (PDF 32000 §14.8.4 /כניסת UserUnit).
`IsAddParagraphsAfterLast`	`bool`	Read/Write	האם הוספות פסקאות מצורפות בסוף (לעומת מיקום הזרימה).
`BackgroundImage`	`Image?`	Read/Write	תמונת רקע של העמוד.
`Group`	`Group?`	Read/Write	מילון קבוצת / מרחב צבע למיזוג עבור עמוד זה.
`TabOrder`	`TabOrder`	Read/Write	סדר טאבים (Tab order) (PDF 32000 §12.5 /כניסת Tabs).
`Watermark`	`Watermark?`	Read/Write	סימן מים (Watermark) המיושם על עמוד זה.
`Layers`	`System.Collections.Generic.List<Layer>`	Read/Write	רשימת שכבות אפקטיבית אמיתית הנתמכת על ידי OcgLayers — כל OCG שמופנה בעמוד מתממש לשכבה (Layer) ספציפית.

שיטות

Signature	Description
`SetRotation(degrees: int)`	הגדר את סיבוב העמוד במעלות (0, 90, 180, 270).
`SetMediaBox(rect: Rectangle)`	הגדר את תיבת המדיה עבור עמוד זה.
`SetCropBox(rect: Rectangle)`	הגדר את תיבת החיתוך עבור עמוד זה.
`SetBleedBox(rect: Rectangle)`	הגדר את תיבת הדימום עבור עמוד זה.
`SetTrimBox(rect: Rectangle)`	הגדר את תיבת החיתוך הסופי עבור עמוד זה.
`SetArtBox(rect: Rectangle)`	הגדר את תיבת האמנות עבור עמוד זה.
`Accept(visitor: Annotations.AnnotationSelector)`	הולך על כל ההערה בעמוד זה דרך מבקר; ההתאמות מצטברות ב‑Selected.
`GetResources()`	גישה בסגנון שיטה ל‑Resources.
`SetPageSize(width: double, height: double)`	הגדר את גודל העמוד על‑ידי עדכון ה‑MediaBox.
`GetPageRect(considerRotation: bool)`	קבל את מלבן העמוד, באופן אופציונלי בהתחשב ב‑CropBox.
`Accept(visitor: Text.TextAbsorber)`	קבל מבקר TextAbsorber (מתאים ל‑API הציבורי).
`GetText()`	חלץ את כל הטקסט מהעמוד באמצעות TextAbsorber.
`Accept(visitor: Text.TextFragmentAbsorber)`	קבל מבקר TextFragmentAbsorber (מתאים ל‑API הציבורי).
`Accept(visitor: ImagePlacementAbsorber)`	קבל מבקר ImagePlacementAbsorber (מתאים ל‑API הציבורי).
`SendTo(device: Devices.ImageDevice, outputFileName: string)`	הוסף חותמת לעמוד זה.
`SendTo(device: Devices.ImageDevice, output: Stream)`	הצג את העמוד הזה באמצעות המכשיר המוגדר וכתוב ל‑stream.
`AddStamp(stamp: ImageStamp)`	החל חותמת תמונה על עמוד זה.
`AddStamp(stamp: Aspose.Pdf.Stamps.Stamp)`	קורא ל‑AddStamp על מופע ה‑Page הזה.
`AddContentStream(contentBytes: byte[])`	הוסף זרם תוכן לעמוד זה.
`PrependContentStream(contentBytes: byte[])`	הוסף בתים של זרם תוכן לפני תוכן העמוד הקיים (לרכיבי רקע).
`AddContent(contentStreamBytes: byte[])`	הוסף בתים של זרם תוכן לעמוד זה.
`AddTable(table: Table)`	הוסף טבלה לעמוד זה.
`AddGraph(graph: Drawing.Graph)`	הוסף גרף (אוסף של צורות) לעמוד זה.
`AddFloatingBox(box: FloatingBox)`	הוסף תיבה צפה לעמוד זה.
`AddExtGState(extGState: Content.ExtGState)`	הוסף מילון ExtGState למשאבי העמוד הזה והחזר את שם המשאב.
`AddImage(imageData: byte[], rect: Rectangle)`	הוסף תמונה לעמוד זה במיקום ובגודל המוגדרים.
`AddImage(imageStream: Stream, rect: Rectangle)`	הוסף תמונה מ‑stream לעמוד זה במיקום ובגודל המוגדרים.
`AddImage(imagePath: string, rectangle: Rectangle)`	הוסף תמונה מנתיב קובץ במלבן המוגדר.
`AddImage(imageStream: Stream, imageRect: Rectangle, bbox: Rectangle, autoAdjustRectangle: bool)`	הוסף תמונה ב‑imageRect עם תיבת גבול מפורשת.
`AddImage(imageStream: Stream, imageRect: Rectangle, imageWidth: int, imageHeight: int, saveImageProportions: bool, bbox: Rectangle)`	הוסף תמונה עם גודל פיקסלים מפורש + תיבת גבול.
`AddImage(hocr: string, imageStream: Stream, imageRect: Rectangle, bbox: Rectangle)`	הוסף תמונה מלווה במחרוזת HOCR (שכבת OCR).
`Resize(targetSize: Aspose.Pdf.PageSize)`	שנה את גודל העמוד הזה ל‑targetSize על‑ידי עדכון ה‑media-box.
`AsByteArray(resolution: Aspose.Pdf.Devices.Resolution)`	הצג את העמוד הזה למערך בתים PNG ברזולוציה המבוקשת.
`Flatten()`	שטח את כל ההערות בעמוד זה — הצג את המראה החזותי שלהן בזרם תוכן העמוד והסר אותן ממערך ההערות.
`ConvertToPNGMemoryStream()`	קובע האם העמוד ריק (אין בו תוכן משמעותי).
`IsBlank(fillThresholdFactor: double)`	קורא ל‑IsBlank על מופע ה‑Page הזה.
`MergeLayers(newLayerName: string)`	מזג את כל השכבות בעמוד זה לשכבה אחת עם השם הנתון.
`MergeLayers(newLayerName: string, newOptionalContentGroupId: string)`	מזג את כל השכבות בעמוד זה, והקצה ל‑OCG החדש את המזהה הנתון.
`HasVectorGraphics()`	האם עמוד זה מכיל גרפיקה וקטורית.
`TrySaveVectorGraphics(pathToSave: string)`	שמור גרפיקה וקטורית מהעמוד ל‑pathToSave.
`AsXml()`	ייצוג XML אבחוני של עמוד זה.
`GetNotifications()`	טקסט הודעת שמסופק על‑ידי השומר ומשודר בזמן הצגת העמוד הזה.
`MakeGrayscale()`	המר כל מילוי/קו צבעוני בעמוד זה לגווני אפור.
`IntToRotation(rotation: int)`	המר סיבוב במעלות (int) ל‑Rotation.
`RotationToInt(rotation: Rotation)`	המר Rotation למעלות כ‑int.
`FreeMemory()`	מנקה נתונים במטמון.
`Dispose()`	משחרר זיכרון.
`CalculateContentBBox()`	חשב את המלבן הקטן ביותר המיושר לצירים במרחב העמוד הכולל את כל התוכן הצבוע בעמוד זה (טקסט, נתיבי וקטור, תמונות, תמונות משולבות, באופן רקורסיבי דרך Form XObjects).
`SendTo(device: PageDevice, output: Stream)`	הצג את העמוד הזה דרך PageDevice ל‑stream.
`SendTo(device: PageDevice, outputFileName: string)`	הצג את העמוד הזה דרך PageDevice לקובץ.
`AddStamp(stamp: Stamp)`	החל חותמת דרך דריסת Put(Page) שלה.
`AddGraphics(elements: GraphicElementCollection, rectangle: Rectangle)`	הפלט של אלמנט וקטורי אינו מיושם — המנוע עדיין אינו צורך את GraphicElementCollection.
`DeleteGraphics(elementsToDelete: GraphicElementCollection)`	זהה — הסרת אלמנט וקטורי אינה מחוברת.

ראה גם

Aspose.PDF for .NET — מדריך API ארגוני