Attachments
Attachments
דף זה מכסה הטמעת קבצים בתוך PDF. קיימים שני מנגנונים נפרדים: קבצים מצורפים ברמת המסמך, שהם קבצים מוטמעים ללא נוכחות גלויה על אף דף, והערות קבצים מצורפים מעוגנות לדף, אשר מציבות סמל ניתן ללחיצה על דף ספציפי.
קבצים מצורפים ברמת המסמך
Document.AddAttachment() משלב את bytes תחת name, ומעדכן/מכניס אותו לעץ שמות הקבצים המוטמעים של המסמך — הוספה חוזרת עם אותו שם מחליפה את הרשומה הקיימת. הוא מחזיר מצביע Attachment. Document.GetAttachments() מחזיר כל קובץ מצורף ברמת המסמך כמערך של מצביעי Attachment, ממוינים לפי שם, ו-Document.RemoveAttachment() מסיר אחד לפי שם.
המזהה Attachment חושף את Name, Description, MimeType, Size, CreationDate ו-ModDate כמאפיינים, GetBytes() לקריאת תוכן הגולמי של הקובץ המוטמע, ו-GetField() / SetField() / RemoveField() לגישה ברמת נמוכה לשדות /Filespec בודדים. ה-AttachmentOptions האופציונלי שמועבר ל-AddAttachment() מקבל את mimeType, description, compress, creationDate, ו-modDate.
אין דוגמת קוד מאומתת זמינה עבור API זה בצילומי הידע הנוכחיים עבור פלטפורמה זו — ראה את סיכום API Reference למטה עבור שמות השיטה והמאפיינים המדויקים.
קבצים מצורפים מעוגנים לדף
Page.AddFileAttachment() משבץ קובץ וממקם הערת אייקון /FileAttachment במיקום rect נתון בדף ספציפי, ומחזיר FileAttachmentAnnotation. בניגוד לקובץ מצורף ברמת המסמך, קובץ זה גלוי וניתן ללחיצה במציג PDF. FileAttachmentAnnotation חולק את תכונות ההערה המשותפות (Rect, Color, Contents, Name, Flags, Print, Hidden, Opacity) וכן את Icon ו-FileName שלו, ותומך ב-GetBytes() לקריאת התוכן המשובץ ו-Flatten() להטמעת האייקון שלו בתוכן סטטי של העמוד.
טיפים ושיטות עבודה מומלצות
- השתמש בקובץ מצורף ברמת המסמך (
Document.AddAttachment()) עבור קובץ שצריך לנסוע יחד עם ה-PDF מבלי להופיע באף דף; השתמש ב-Page.AddFileAttachment()כאשר הקובץ צריך להיות מיוצג על ידי אייקון ניתן ללחיצה במיקום ספציפי. Document.AddAttachment()מחליף קובץ מצורף קיים עם אותוname— בדוק אתDocument.GetAttachments()תחילה אם אתה צריך להימנע מהחלפה בלתי מכוונת.- קרא את תוכן הקובץ המצורף בחזרה עם
GetBytes()על כל סוג ידית — השיטה קיימת ב-Attachmentוב-FileAttachmentAnnotation.
בעיות נפוצות
| בעיה | סיבה | פתרון |
|---|---|---|
| קובץ מצורף שנוסף לאחרונה החליף קובץ קיים | Document.AddAttachment() נקרא עם name שכבר נמצא בשימוש | קרא ל-Document.GetAttachments() תחילה כדי לבדוק התנגשות שם |
| למצרף אין סמל נראה בעמוד | Document.AddAttachment() שומש, שהוא ברמת המסמך ואין לו נוכחות בעמוד לפי העיצוב | השתמש ב-Page.AddFileAttachment() במקום עבור סמל גלוי, מעוגן בעמוד |
Document.RemoveAttachment() מחזיר false | אין קובץ מצורף עם name הנתון בעץ השמות | אשר את השם המדויק דרך Document.GetAttachments() לפני המחיקה |
FAQ
מה ההבדל בין Document.AddAttachment ל-Page.AddFileAttachment?
Document.AddAttachment() משלב קובץ ברמת המסמך ללא סמל נראה על אף דף. Page.AddFileAttachment() משלב קובץ וממקם אנוטציה של סמל /FileAttachment שניתן ללחוץ במיקום ספציפי על דף אחד.
איך אני יכול לרשום את כל הקבצים המצורפים שכבר משולבים במסמך?
קרא ל-Document.GetAttachments(), שמחזיר את כל הקבצים המצורפים ברמת המסמך כמערך של מצביעי Attachment ממוינים לפי שם.
איך ניתן לקרוא את תוכן הקובץ של קובץ מצורף?
קרא ל-GetBytes() על מצביע ה-Attachment (או FileAttachmentAnnotation) — הוא זמין בשניהם.
האם אפשר להסיר קובץ מצורף?
כן — Document.RemoveAttachment(name) מסיר קובץ מצורף ברמת המסמך לפי שם ומחזיר האם נמצא והוסר קובץ.
API Reference סיכום
| מחלקה/מתודה | תיאור |
|---|---|
Document.AddAttachment() | הטמע בתים כקובץ מצורף בשם, ברמת המסמך |
Document.GetAttachments() | רשום את כל הקבצים המצורפים ברמת המסמך |
Document.RemoveAttachment() | הסר קובץ מצורף ברמת המסמך לפי שם |
Attachment | טפל ביותר מקובץ משובץ אחד; Name, Description, MimeType, Size, GetBytes() |
Page.AddFileAttachment() | הטמע קובץ כסימון אייקון ניתן ללחיצה ומקובע בעמוד |
FileAttachmentAnnotation | ידית ההערה של הקובץ המצורף המעוגן לדף; מוסיפה Icon, FileName |
