שאלות נפוצות

איך אני מתקין את Aspose.Slides FOSS?

התקן מ‑NuGet באמצעות .NET CLI. נדרש .NET 9.0 או גרסה מאוחרת יותר.

dotnet add package Aspose.Slides.Foss

אמת את ההתקנה:

using Aspose.Slides.Foss;

using var prs = new Presentation();
Console.WriteLine($"Slides: {prs.Slides.Count}");

אין צורך ב‑Microsoft Office או ברנטיימים אחרים של המערכת.

למה עלי להשתמש `using var prs = new Presentation();`?

המחלקה Presentation מיישמת IDisposable ומנהלת משאבי XML פנימיים. ללא הצהרת using, משאבים אלה אינם משתחררים כאשר האובייקט Presentation יוצא מהטווח, מה שעלול לגרום לדליפות משאבים או נעילות קבצים.

תמיד עקבו אחרי תבנית זו:

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation("input.pptx");
// work here
prs.Save("output.pptx", SaveFormat.Pptx);

לאילו פורמטים של קבצים ניתן לשמור?

ה‑SaveFormat enum מגדיר קבועים עבור פורמטים רבים — Pptx, Pdf, Html, Svg, Jpeg, Png, ואחרים — לתאימות API עם הגרסה המסחרית. בזמן ריצה בגרסה הזו של FOSS, כל העומסים של Save() מתעלמים ממפרט הפורמט ותמיד כותבים פלט PPTX. העברת SaveFormat.Pdf מתקומפלת כראוי אך מייצרת קובץ .pptx, ולא .pdf.

using Aspose.Slides.Foss.Export;

prs.Save("output.pptx", SaveFormat.Pptx);

ייצוא לפורמטים שאינם PPTX אינו זמין מבחינה תפקודית בגרסה זו. השתמש ב-SaveFormat.Pptx לכל פעולות השמירה.

האם אני יכול לפתוח `.ppt` (PowerPoint ישן 97-2003) קבצים?

הספרייה תומכת בעיקר ב-.pptx (Office Open XML). הקונסטרקטור Presentation מקבל נתיב קובץ .ppt ויזהה את הפורמט, אך פענוח אמין של קבצי .ppt בינריים אינו מובטח ואינו מקרה שימוש נתמך במהדורה זו. השתמשו בקבצי .pptx בכל תרחישי הייצור.

איך אני ניגש לשקופיות?

שקופיות הן אוסף מבוסס‑אפס הנגיש דרך prs.Slides:

var firstSlide = prs.Slides[0];
int slideCount = prs.Slides.Count;

איך אני מוסיף שקף שני?

השתמש בprs.Slides.AddEmptySlide() עם פריסה:

using var prs = new Presentation();
var layout = prs.LayoutSlides[0];
prs.Slides.AddEmptySlide(layout);
var slide2 = prs.Slides[1];
prs.Save("two-slides.pptx", SaveFormat.Pptx);

איך אני מגדיר את צבע הרקע של השקופית?

מילוי רקע אינו זמין בגרסה זו.

איך משתמשים ב`NullableBool`?

NullableBool הוא enum בעל שלושה מצבים המשמש לתכונות עיצוב. השתמש ב-NullableBool.True (ולא ב-true של C#) עבור מודגש, נטוי ותכונות דומות:

using Aspose.Slides.Foss;

fmt.FontBold = NullableBool.True;
fmt.FontItalic = NullableBool.False;
fmt.FontUnderline = TextUnderlineType.Single;

למה הגדרת צבע הטקסט לא משפיעה?

עליך גם להגדיר FillType = FillType.Solid לפני הקצאת הצבע:

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;

fmt.FillFormat.FillType = FillType.Solid;
fmt.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 200, 0, 0);

האם אני יכול להשתמש בתרשימים או ב‑SmartArt?

לא. תרשימים, SmartArt, אובייקטי OLE, אנימציות, מעברים, קישורים, מקרו VBA, וחתימות דיגיטליות אינם מיושמים בגרסה זו.

האם הספרייה תומכת ב‑.NET 8?

לא. נדרש .NET 9.0 או גרסה מאוחרת יותר.

האם הספרייה הזו בטוחה לשימוש מרובה תהליכים?

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

איך אני משלב תמונה?

קרא את בתי התמונה והוסף אותם לprs.Images, ואז צור PictureFrame:

byte[] imageData = File.ReadAllBytes("logo.png");
var image = prs.Images.AddImage(imageData);
slide.Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 50, 200, 150, image);

שאלות נפוצות