Class ImageSavingArgs

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 ImageSavingArgs

الأعضاء الموروثين

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; }

قيمة الممتلكات

ShapeBase

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; }

قيمة الممتلكات

Document

ImageFileName

يحصل أو يضع اسم الملف (بدون مسار) حيث سيتم حفظ الصورة.

public string ImageFileName { get; set; }

قيمة الممتلكات

string

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; }

قيمة الممتلكات

Stream

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; }

قيمة الممتلكات

bool

Remarks

بعض الصور في الوثيقة قد تكون غير متوفرة، على سبيل المثال، لأن الصورة مرتبطة والروابط غير متوفرة أو لا تشير إلى صورة صالحة.في هذه الحالة Aspose.Words تصدير أيقونة مع الصليب الأحمر.هذه الممتلكات تعود إذا كانت الصورة الأصلية متوفرة؛ تعود إذا كانت الصورة الأصلية غير متوفرة وسيتم تقديم أيقونة “لا صورة” لإنقاذ.

عند حفظ شكل مجموعة أو شكل لا يتطلب أي صورة هذه الممتلكات هي دائما .

انظر أيضا

ImageSavingArgs . CurrentShape

KeepImageStreamOpen

يحدد ما إذا كان Aspose.Words يجب أن تبقى التيار مفتوحة أو مغلقة بعد حفظ صورة.

public bool KeepImageStreamOpen { get; set; }

قيمة الممتلكات

bool

Remarks

الافتراضي هو و Aspose.Words سوف يغلق التدفق الذي قدمته في Aspose.Words.Saving.ImageSavingArgs.ImageStream الممتلكات بعد كتابة صورة في ذلك.

أرشيف الوسم : أرشيف الوسم : أرشيف

 عربي