שתף באמצעות

פונקציית PDF (ניסויי)

  • מאמר

חל על: אפליקציות קנבס אפליקציות מונחות דגמים

‏‫[מאמר זה הוא תיעוד קדם-הפצה והוא עשוי להשתנות.]‬

מייצא תוכן מהמסך הנוכחי לאובייקט לשימוש בתרחישים מרובים.

חשוב

תיאור‬‏‫‬

פונקציית PDF מאפשרת לבחור מסך או חלקים של מסך לייצוא לאובייקט PDF ‏(Blob).

אפשרויות תצורה שונות מאפשרות תוצאות שונות עבור ה-PDF שנוצר.

חשוב

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

הערה

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

תחביר

PDF(שם מסך או פקד [,{גודל, DPI, Margin, Orientation, ExpandContainers}])

  • שם מסך או פקד - נדרש. המסך או הפקד המכילים את התוכן שישמש ליצירת ה- PDF. פקדים נתמכים: גלריה אנכית, גורם מכיל לפריסה אנכית, גורם מכיל לפריסה אופקית, גורם מכיל, מסך.

  • גודל – אופציונלי. שולט במידות של ה- PDF שנוצר. ערך ברירת המחדל תלוי במקום של משתמש האפליקציה; מכתב עבור ארה"ב וקנדה ו- A4 עבור אזורים אחרים.

  • DPI – אופציונלי. שולט בשינוי קנה מידה/רזולציה של ה- PDF שנוצר. הערך חייב להיות גדול מ- 0. תוכן החורג מהשטח המותר בשוליים שצוינו עלול לגרום ל- DPI אפקטיבי גבוה יותר. ערך ברירת המחדל הוא 96.

  • שוליים – אופציונלי. מחרוזת המציינת את גודל הרווח השמור בין התוכן לקצה החיצוני של ה-PDF שנוצר. כל שולי ב-PDF שנוצר (עליון, ימין, תחתון, שמאל) יכול לתמוך בערך שונה. יחידות מדידה נתמכות עבור ערך זה כוללות אינץ', ס"מ, מ"מ, נק' ופיקסל. ערך ברירת המחדל הוא 0.5 אינץ' (12.7 מ"מ) עבור כל השוליים.

  • התמצאות – אופציונלי. קובע אם ל- PDF שנוצר יש כיוון לאורך (אנכי) או לרוחב (אופקי). ערך ברירת המחדל הוא לאורך (אנכי).

  • ExpandContainers - אופציונלי. בוליאני. קובע אם גורמים מכילים מסוימים עם תוכן שחורג מהגודל שהוקצה יתרחבו כדי להציג את כל התוכן ב- PDF שנוצר. הפקדים המושפעים כוללים מסכים, גורמים מכילים, גורמים מכילים אנכיים ואופקיים, גלריות אנכיות בגובה קבוע (לא מקוננות), טפסים ופקדי בד ציור שניתנים לגלילה. ערך ברירת המחדל הוא false.

דוגמאות

נוּסחָה תיאור תוֹצָאָה
PDF (מסך 1) יוצר אובייקט PDF עם הגדרות ברירת המחדל. אובייקט PDF נוצר מהתוכן הגלוי של מסך1.
PDF(Container1, {גודל: A3}) יוצר אובייקט PDF שגודל הנייר מוגדר ל- A3. אובייקט PDF בגודל A3 נוצר מהתוכן הגלוי של גורם מכיל1.
PDF(מסך1, {DPI: 72, שוליים: "25 מ"מ", כיוון: "נוף"}) יוצר אובייקט PDF כשהרזולוציה (DPI) מוגדרת ל-72, השוליים מוגדרים ל-25 מילימטרים, והכיוון מוגדר לרוחב (אופקי). PDF עם ה-DPI, השוליים והכיוון שצוינו נוצר בגודל ברירת המחדל (תלוי במקום) מהתוכן הגלוי במסך1.
PDF(Screen1, {ExpandContainers: true}) יוצר אובייקט PDF עם פקדים רלוונטיים מורחבים. קובץ PDF נוצר כאשר כל הגלריות/הגורמים המכילים שכוללים יותר תוכן מהתוכן הגלוי מורחבות כדי להציג את כל התוכן ב-PDF שנוצר.

‏‫מגבלות ידועות‬

  • נכון לעכשיו אין תמיכה בפקדים מסוימים. אלה כוללים תרשימים, אריח Power BI, מפה וכמה תצורות של פקדי PCF של צד שלישי.

  • גלריות מקוננות אינן נתמכות.

  • ייתכן שסוגי סקריפטים שאינם לטיניים ומשקלים וסגנונות של גופנים כגון מודגש ונטוי לא יופיעו ב-PDF שנוצר עבור גופנים מסוימים.

  • יצירת קובצי PDF הניתנים למילוי אינה נתמכת.