IWarningCallback
محتويات
[
يخفي
]IWarningCallback interface
قم بتنفيذ هذه الواجهة إذا كنت تريد استدعاء طريقتك المخصصة لالتقاط تحذيرات فقدان الدقة التي قد تحدث أثناء تحميل المستند أو حفظه.
public interface IWarningCallback
طُرق
اسم | وصف |
---|---|
Warning(WarningInfo) | يستدعي Aspose.Words هذه الطريقة عندما يواجه بعض المشكلات أثناء تحميل المستند أو حفظه، مما قد يؤدي إلى فقدان التنسيق أو دقة البيانات. |
أمثلة
يوضح كيفية استخدام واجهة IWarningCallback لمراقبة تحذيرات استبدال الخط.
public void SubstitutionWarning()
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Font.Name = "Times New Roman";
builder.Writeln("Hello world!");
FontSubstitutionWarningCollector callback = new FontSubstitutionWarningCollector();
doc.WarningCallback = callback;
// قم بتخزين المجموعة الحالية من مصادر الخطوط، والتي ستكون مصدر الخط الافتراضي لكل مستند
// حيث لا نحدد مصدر خط مختلف.
FontSourceBase[] originalFontSources = FontSettings.DefaultInstance.GetFontsSources();
// لأغراض الاختبار، سنقوم بتعيين Aspose.Words للبحث عن الخطوط فقط في مجلد غير موجود.
FontSettings.DefaultInstance.SetFontsFolder(string.Empty, false);
// عند عرض المستند، لن يكون هناك مكان للعثور على الخط "Times New Roman".
// سيؤدي هذا إلى ظهور تحذير استبدال الخط، والذي ستكتشفه معاودة الاتصال الخاصة بنا.
doc.Save(ArtifactsDir + "FontSettings.SubstitutionWarning.pdf");
FontSettings.DefaultInstance.SetFontsSources(originalFontSources);
Assert.True(callback.FontSubstitutionWarnings[0].WarningType == WarningType.FontSubstitution);
Assert.True(callback.FontSubstitutionWarnings[0].Description
.Equals(
"Font 'Times New Roman' has not been found. Using 'Fanwood' font instead. Reason: first available font."));
}
private class FontSubstitutionWarningCollector : IWarningCallback
{
/// <summary>
/// يتم استدعاؤها في كل مرة يحدث فيها تحذير أثناء التحميل/الحفظ.
/// </summary>
public void Warning(WarningInfo info)
{
if (info.WarningType == WarningType.FontSubstitution)
FontSubstitutionWarnings.Warning(info);
}
public WarningInfoCollection FontSubstitutionWarnings = new WarningInfoCollection();
}
يُظهر العرض إضافة بديل لعرض الخريطة النقطية وتغيير نوع التحذيرات حول سجلات الملفات التعريفية غير المدعومة.
public void HandleBinaryRasterWarnings()
{
Document doc = new Document(MyDir + "WMF with image.docx");
MetafileRenderingOptions metafileRenderingOptions = new MetafileRenderingOptions();
// اضبط خاصية "EmulateRasterOperations" على "false" للعودة إلى الخريطة النقطية عندما
// يواجه ملفًا تعريفيًا، والذي سيتطلب عمليات نقطية لعرضه في ملف PDF الناتج.
metafileRenderingOptions.EmulateRasterOperations = false;
// قم بتعيين خاصية "RenderingMode" إلى "VectorWithFallback" لمحاولة عرض كل ملف تعريفي باستخدام الرسومات المتجهة.
metafileRenderingOptions.RenderingMode = MetafileRenderingMode.VectorWithFallback;
// قم بإنشاء كائن "PdfSaveOptions" الذي يمكننا تمريره إلى طريقة "حفظ" الخاصة بالمستند
// لتعديل كيفية تحويل هذه الطريقة للمستند إلى .PDF وتطبيق التكوين
// في كائن MetafileRenderingOptions الخاص بنا لعملية الحفظ.
PdfSaveOptions saveOptions = new PdfSaveOptions();
saveOptions.MetafileRenderingOptions = metafileRenderingOptions;
HandleDocumentWarnings callback = new HandleDocumentWarnings();
doc.WarningCallback = callback;
doc.Save(ArtifactsDir + "PdfSaveOptions.HandleBinaryRasterWarnings.pdf", saveOptions);
Assert.AreEqual(1, callback.Warnings.Count);
Assert.AreEqual("'R2_XORPEN' binary raster operation is not supported.",
callback.Warnings[0].Description);
}
/// <summary>
/// يطبع ويجمع تحذيرات فقدان التنسيق التي تحدث عند حفظ المستند.
/// </summary>
public class HandleDocumentWarnings : IWarningCallback
{
public void Warning(WarningInfo info)
{
if (info.WarningType == WarningType.MinorFormattingLoss)
{
Console.WriteLine("Unsupported operation: " + info.Description);
Warnings.Warning(info);
}
}
public WarningInfoCollection Warnings = new WarningInfoCollection();
}
يوضح كيفية تعيين الخاصية للعثور على أقرب تطابق لخط مفقود من مصادر الخطوط المتوفرة.
public void EnableFontSubstitution()
{
// افتح مستندًا يحتوي على نص منسق بخط غير موجود في أي من مصادر الخطوط لدينا.
Document doc = new Document(MyDir + "Missing font.docx");
// تعيين معاودة الاتصال للتعامل مع تحذيرات استبدال الخط.
HandleDocumentSubstitutionWarnings substitutionWarningHandler = new HandleDocumentSubstitutionWarnings();
doc.WarningCallback = substitutionWarningHandler;
// تعيين اسم الخط الافتراضي وتمكين استبدال الخط.
FontSettings fontSettings = new FontSettings();
fontSettings.SubstitutionSettings.DefaultFontSubstitution.DefaultFontName = "Arial";
;
fontSettings.SubstitutionSettings.FontInfoSubstitution.Enabled = true;
// ينبغي استخدام مقاييس الخط الأصلية بعد استبدال الخط.
doc.LayoutOptions.KeepOriginalFontMetrics = true;
// سوف نحصل على تحذير استبدال الخط إذا قمنا بحفظ مستند بخط مفقود.
doc.FontSettings = fontSettings;
doc.Save(ArtifactsDir + "FontSettings.EnableFontSubstitution.pdf");
using (IEnumerator<WarningInfo> warnings = substitutionWarningHandler.FontWarnings.GetEnumerator())
while (warnings.MoveNext())
Console.WriteLine(warnings.Current.Description);
//يمكننا أيضًا التحقق من التحذيرات الموجودة في المجموعة ومسحها.
Assert.AreEqual(WarningSource.Layout, substitutionWarningHandler.FontWarnings[0].Source);
Assert.AreEqual(
"Font '28 Days Later' has not been found. Using 'Calibri' font instead. Reason: alternative name from document.",
substitutionWarningHandler.FontWarnings[0].Description);
substitutionWarningHandler.FontWarnings.Clear();
Assert.AreEqual(0, substitutionWarningHandler.FontWarnings.Count);
}
public class HandleDocumentSubstitutionWarnings : IWarningCallback
{
/// <summary>
/// يتم استدعاؤها في كل مرة يحدث فيها تحذير أثناء التحميل/الحفظ.
/// </summary>
public void Warning(WarningInfo info)
{
if (info.WarningType == WarningType.FontSubstitution)
FontWarnings.Warning(info);
}
public WarningInfoCollection FontWarnings = new WarningInfoCollection();
}
أنظر أيضا
- مساحة الاسم Aspose.Words
- المجسم Aspose.Words