تكوين الخطوط لتقديم جداول البيانات

سيناريوهات الاستخدام الممكنة

توفر واجهات برمجة التطبيقات Aspose.Cells إمكانية عرض جداول البيانات بتنسيقات صور بالإضافة إلى تحويلها إلى تنسيقات PDF و XPS. لتحقيق أقصى قدر من دقة التحويل ، من الضروري أن تكون الخطوط المستخدمة في جدول البيانات متاحة في دليل الخطوط الافتراضي لنظام التشغيل. في حالة عدم وجود الخطوط المطلوبة ، ستحاول واجهات برمجة تطبيقات Aspose.Cells استبدال الخطوط المطلوبة بالخطوط المتاحة.

اختيار الخطوط

فيما يلي العملية التي تتبعها واجهات برمجة التطبيقات Aspose.Cells خلف الكواليس.

1. يحاول API العثور على الخطوط في نظام الملفات المطابقة لاسم الخط الدقيق المستخدم في جدول البيانات.
2. إذا لم يتمكن API من العثور على الخطوط التي لها نفس الاسم بالضبط ، فإنه يحاول استخدام الخط الافتراضي المحدد ضمن المصنفDefaultStyle.Font خاصية.
3. إذا كان API لا يمكنه تحديد مكان الخط المعرف ضمن المصنفDefaultStyle.Font الخاصية ، يحاول استخدام الخط المحدد ضمنPdfSaveOptions.DefaultFont أوImageOrPrintOptions.DefaultFont خاصية.
4. إذا كان API لا يمكنه تحديد مكان الخط المعرف أسفلPdfSaveOptions.DefaultFont أوImageOrPrintOptions.DefaultFont الخاصية ، يحاول استخدام الخط المحدد ضمنFontConfigs.DefaultFontName خاصية.
5. إذا كان API لا يمكنه تحديد مكان الخط المعرف أسفلFontConfigs.DefaultFontName الخاصية ، فهو يحاول تحديد أنسب الخطوط من جميع الخطوط المتاحة.
6. أخيرًا ، إذا لم يتمكن API من العثور على أي خطوط في نظام الملفات ، فسيتم عرض جدول البيانات باستخدام Arial.

تقوم واجهات برمجة التطبيقات Aspose.Cells دائمًا بمسح دليل الخطوط الافتراضي لنظام التشغيل مع استثناء واحد ، وهو ؛ عندما الحجج JVM**-DAspose.Cells.FontDirExc = “YourFontDir”**تم تعيينها. في هذه الحالة ، ستتخطى واجهات برمجة التطبيقات Aspose.Cells فحص دليل الخطوط الافتراضية لنظام التشغيل وستبحث فقط في المسار كما هو محدد في وسيطات JVM المذكورة أعلاه.

تعيين مجلدات الخطوط المخصصة

Aspose.Cells تقوم واجهات برمجة التطبيقات (API) بالبحث في دليل الخط الافتراضي لنظام التشغيل عن الخطوط المطلوبة. في حالة عدم توفر الخطوط المطلوبة في دليل خطوط النظام ، تقوم واجهات برمجة التطبيقات بالبحث من خلال الدلائل المخصصة (المعرفة من قبل المستخدم). الFontConfigsكشفت class عن عدد من الطرق لتعيين أدلة الخطوط المخصصة كما هو مفصل أدناه.

1. FontConfigs.setFontFolder: هذه الطريقة مفيدة إذا كان هناك مجلد واحد فقط ليتم تعيينه.
2. FontConfigs.setFontFolders: هذه الطريقة مفيدة عندما تكون الخطوط موجودة في مجلدات متعددة ويريد المستخدم تعيين جميع المجلدات بشكل منفصل بدلاً من دمج كل الخطوط في مجلد واحد.
3. FontConfigs.setFontSources: هذه الآلية مفيدة عندما يرغب المستخدم في تحميل خطوط من مجلدات متعددة أو ملف خط واحد أو بيانات خط من مصفوفة من البايت.

كلاهماFontConfigs.setFontFolder & FontConfigs.setFontFolders تقبل أساليب المعامل الثاني من النوع المنطقي. تمريرحقيقيكمعامل ثانٍ سيوجه Aspose.Cells APIs للبحث في المجلدات الفرعية عن ملفات الخطوط.

يرجى استخدام أي من الطرق المذكورة أعلاه في بداية التطبيق ، أي ؛ قبل استدعاء أي كائنات أخرى من Aspose.Cells APIs.

إذا تم استخدام أكثر من طريقة من الطرق المذكورة أعلاه لتعيين مصادر الخطوط ، فسيتم تفعيل الإعدادات الأخيرة فقط.

آلية استبدال الخط

توفر واجهات برمجة التطبيقات Aspose.Cells أيضًا القدرة على تحديد طاقم الطباعة البديل لأغراض التصيير. هذه الآلية مفيدة عندما لا يكون الخط المطلوب متاحًا على الجهاز حيث يجب إجراء التحويل. يمكن للمستخدمين توفير قائمة بأسماء الخطوط كبديل للخط المطلوب في الأصل. من أجل تحقيق ذلك ، كشفت واجهات برمجة التطبيقات Aspose.Cells طريقة FontConfigs.setFontSubstitutes التي تقبل معلمتين. المعلمة الأولى من النوعسلسلة ، والذي يجب أن يكون اسم الخط الذي يجب استبداله. المعلمة الثانية هي مصفوفة من النوعسلسلة. يمكن للمستخدمين توفير قائمة بأسماء الخطوط كبدائل للخط الأصلي (المحدد في المعلمة الأولى).

هنا سيناريو استخدام بسيط.

 //Substituting the Arial font with Times New Roman & Calibri

FontConfigs.setFontSubstitutes("Arial", new String[]{ "Times New Roman", "Calibri" });

جمع المعلومات

بالإضافة إلى الأساليب المذكورة أعلاه ، قدمت واجهات برمجة التطبيقات Aspose.Cells أيضًا وسائل لجمع المعلومات حول المصادر والبدائل التي تم تعيينها.

1. FontConfigs.getFontSources: ترجع هذه الطريقة مصفوفة من النوعFontSourceBaseتحتوي على قائمة بمصادر الخطوط المحددة. في حالة عدم وجود مصادر محددة ، فإنFontConfigs.getFontSources سيعيد التابع مصفوفة فارغة.
2. FontConfigs.getFontSubstitutes: تقبل هذه الطريقة معلمة من النوعسلسلة السماح بتحديد اسم الخط الذي تم استبداله. في حالة عدم تعيين أي استبدال لاسم الخط المحدد ثم ملفFontConfigs.getFontSubstitutes ستعيد الطريقة فارغة.