Class ImageSavingArgs
اسم الفضاء : Aspose.Words.Saving تجميع: Aspose.Words.dll (25.4.0)
يقدم بيانات عن حدث Aspose.Words.Saving.IImageSavingCallback.ImageSaving(Aspose.Words.Saving.ImageSavingArgs).
لمعرفة المزيد، قم بزيارة Save a Document مقالة الوثائق .
public class ImageSavingArgs
Inheritance
الأعضاء الموروثين
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Remarks
بشكل افتراضي ، عندما يقوم Aspose.Words بتخزين مستند إلى HTML ، يقوم بتخزين كل صورة إلى ملف منفصل. يستخدم Aspose.Words اسم ملف المستند ورقم فريد لإنشاء اسم ملف فريد لكل صورة موجودة في المستند.
Aspose.Words.Saving.ImageSachingArgs يسمح لك لإعادة تعريف كيفية إنشاء أسماء ملفات الصورة أو للتحويل الكامل من تخزين الصور إلى الملفات من خلال توفير كائنات التدفق الخاصة بك.
لتطبيق منطقتك الخاصة لإنتاج أسماء ملفات الصورة باستخدام Aspose.Words.Saving.ImageSavingArgs.ImageFileName، Aspose.Words.Saving.ImageSavingArgs.CurrentShape و Aspose.Words.Saving.ImageSavingArgs.IsImageالخصائص المتاحة.
لتخزين الصور في التدفقات بدلاً من الملفات، استخدم خصائص Aspose.Words.Saving.ImageSavingArgs.ImageStream.
Properties
CurrentShape
يحصل على Aspose.Words.Drawing.ShapeBase الكائن الذي يتوافق مع الشكل أو شكل المجموعةهذا هو على وشك أن ينقذ.
public ShapeBase CurrentShape { get; }
قيمة الممتلكات
Remarks
Aspose.Words.Saving.IImageSwingCallback يمكن إخراجها أثناء حفظ شكل أو شكل جماعي. وهذا هو السبب في أن الممتلكات لديها نوع Wl26.Drawing.ShapeBase. يمكنك التحقق مما إذا كان شكل مجموعة مقارنة مع _ www.wl26..draw.shape.type مع __ww.a.b.
تستخدم Aspose.Words اسم ملف المستند ورقم فريد لإنشاء اسم ملف فريد لكل صورة موجودة في المستند.يمكنك استخدام Aspose.Words.Saving.ImageSavingArgs.CurrentShape خصائص لإنشاء اسم ملف “أفضل” من خلال فحص خصائص الشكل مثل Aspose.Words.Drawing.ImageData.Title (شكل فقط)، Aspose.Words.Drawing.ImageData.SourceFullName (شكل فقط) و Aspose.Words.Drawing.ShapeBase.Name.
بعض الصور في الوثيقة قد تكون غير متوفرة.للتحقق من توافر الصورة، استخدم Aspose.Words.Saving.ImageSavingArgs.IsImageالممتلكات المتاحة.
Document
يحصل على موضوع الوثيقة الذي يتم حفظه حاليا.
public Document Document { get; }
قيمة الممتلكات
ImageFileName
يحصل أو يضع اسم الملف (بدون مسار) حيث سيتم حفظ الصورة.
public string ImageFileName { get; set; }
قيمة الممتلكات
Remarks
تتيح لك هذه الخصائص إعادة تعريف كيف يتم إنشاء أسماء ملفات الصورة أثناء تصديرها إلى HTML.
عند إطلاق الحدث ، يحتوي هذا الممتلكات على اسم الملف الذي تم إنشاؤه بواسطة Aspose.Words. يمكنك تغيير قيمة هذا الممتلكات لتخزين الصورة إلى ملف مختلف.
يتم إنشاء Aspose.Words تلقائيًا اسم ملف فريد لكل صورة مدمجة عند تصديرها إلى تنسيق HTML. كيف يتم إنشاء اسم ملف الصورة يعتمد على ما إذا كنت تخزن المستند إلى ملف أو تدفق.
عند حفظ مستند إلى ملف ، يبدو اسم ملف الصورة التي تم إنشاؤها .
عند حفظ مستند إلى تدفق ، يبدو اسم ملف الصورة التي تم إنشاؤها .
ويجب أن يحتوي اسم الملف فقط دون المسار. Aspose.Words يحدد مسار التخزين والقيمة للخصائص للكتابة إلى HTML باستخدام اسم ملف الوثيقة، www.Wl26.Saving.HtmlSaveOptions.ImagesFolder و _ www.wl26.
Aspose.Words.Saving.ImageSavingArgs.CurrentShape Aspose.Words.Saving.ImageSavingArgs.IsImageAvailable Aspose.Words.Saving.ImageSavingArgs.ImageStream Aspose.Words.Saving.HtmlSaveOptions.ImagesFolder Aspose.Words.Saving.HtmlSaveOptions.ImagesFolderAlias
ImageStream
يسمح بتحديد التيار الذي سيتم حفظ الصورة إليه.
public Stream ImageStream { get; set; }
قيمة الممتلكات
Remarks
هذه الخصائص تسمح لك لتخزين الصور إلى التدفقات بدلا من الملفات أثناء HTML.
عندما يكون هذا الممتلكات ، سيتم حفظ الصورة إلى ملف محدد في Aspose.Words.Saving.ImageSavingArgs.ImageFileName الممتلكات.
باستخدام Aspose.Words.Saving.IImageSavingCallback لا يمكنك استبدال صورة واحدة مع صورة أخرى.
Aspose.Words.Saving.ImageSavingArgs.ImageFileName Aspose.Words.Saving.ImageSavingArgs.KeepImageStreamOpen
IsImageAvailable
يعود “حقيقي” إذا كانت الصورة الحالية متاحة للتصدير.
public bool IsImageAvailable { get; }
قيمة الممتلكات
Remarks
بعض الصور في الوثيقة قد تكون غير متوفرة، على سبيل المثال، لأن الصورة مرتبطة والروابط غير متوفرة أو لا تشير إلى صورة صالحة.في هذه الحالة Aspose.Words تصدير أيقونة مع الصليب الأحمر.هذه الممتلكات تعود إذا كانت الصورة الأصلية متوفرة؛ تعود إذا كانت الصورة الأصلية غير متوفرة وسيتم تقديم أيقونة “لا صورة” لإنقاذ.
عند حفظ شكل مجموعة أو شكل لا يتطلب أي صورة هذه الممتلكات هي دائما .
انظر أيضا
ImageSavingArgs . CurrentShape
KeepImageStreamOpen
يحدد ما إذا كان Aspose.Words يجب أن تبقى التيار مفتوحة أو مغلقة بعد حفظ صورة.
public bool KeepImageStreamOpen { get; set; }
قيمة الممتلكات
Remarks
الافتراضي هو و Aspose.Words سوف يغلق التدفق الذي قدمته في Aspose.Words.Saving.ImageSavingArgs.ImageStream الممتلكات بعد كتابة صورة في ذلك.
أرشيف الوسم : أرشيف الوسم : أرشيف