InsertImage

InsertImage(Image)

إدراج صورة من .NETImage كائن في المستند. الصورة مُدرجة ضمنيًا وبمقياس ١٠٠٪.

public Shape InsertImage(Image image)

معامل	يكتب	وصف
image	Image	الصورة التي سيتم إدراجها في المستند.

قيمة الإرجاع

عقدة الصورة التي تم إدراجها للتو.

ملاحظات

يمكنك تغيير حجم الصورة وموقعها وطريقة تحديد الموقع والإعدادات الأخرى باستخدام Shape الكائن الذي تم إرجاعه بواسطة هذه الطريقة.

أمثلة

يوضح كيفية إدراج صورة من كائن إلى مستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

string imageFile = ImageDir + "Logo.jpg";

// فيما يلي ثلاث طرق لإدراج صورة من مثيل كائن الصورة.
// 1 - شكل مضمن بحجم افتراضي يعتمد على الأبعاد الأصلية للصورة:
builder.InsertImage(imageFile);

builder.InsertBreak(BreakType.PageBreak);

// 2 - شكل مضمن بأبعاد مخصصة:
builder.InsertImage(imageFile, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - الشكل العائم مع الأبعاد المخصصة:
builder.InsertImage(imageFile, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertImageFromImageObject.docx");

أنظر أيضا

• class Shape
• class DocumentBuilder
• مساحة الاسم Aspose.Words
• المجسم Aspose.Words

---

InsertImage(string)

يُدرج صورة من ملف أو رابط في المستند. تُدرج الصورة مضمنةً وبمقياس ١٠٠٪.

public Shape InsertImage(string fileName)

معامل	يكتب	وصف
fileName	String	الملف الذي يحتوي على الصورة. يمكن أن يكون أي عنوان URI صالح محليًا أو بعيدًا.

قيمة الإرجاع

عقدة الصورة التي تم إدراجها للتو.

ملاحظات

سيؤدي هذا التحميل الزائد إلى تنزيل الصورة تلقائيًا قبل إدراجها في document إذا قمت بتحديد عنوان URI بعيد.

يمكنك تغيير حجم الصورة وموقعها وطريقة تحديد الموقع والإعدادات الأخرى باستخدام Shape الكائن الذي تم إرجاعه بواسطة هذه الطريقة.

أمثلة

يوضح كيفية إدراج صورة WebP.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.InsertImage(ImageDir + "WebP image.webp");

doc.Save(ArtifactsDir + "Image.InsertWebpImage.docx");

يوضح كيفية إدراج صورة gif إلى المستند.

DocumentBuilder builder = new DocumentBuilder();

// يمكننا إدراج صورة gif باستخدام المسار أو مجموعة البايتات.
// يعمل فقط إذا تم تحسين DocumentBuilder إلى إصدار Word 2010 أو أعلى.
// لاحظ أن الوصول إلى بايتات الصورة يؤدي إلى تحويل Gif إلى Png.
Shape gifImage = builder.InsertImage(ImageDir + "Graphics Interchange Format.gif");

gifImage = builder.InsertImage(File.ReadAllBytes(ImageDir + "Graphics Interchange Format.gif"));

builder.Document.Save(ArtifactsDir + "InsertGif.docx");

يوضح كيفية إدراج شكل مع صورة في مستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// فيما يلي موقعان حيث يتم استخدام طريقة "InsertShape" الخاصة بمنشئ المستندات
//يمكن الحصول على مصدر الصورة التي سيتم عرض الشكل.
// 1 - قم بتمرير اسم ملف نظام الملفات المحلي لملف الصورة:
builder.Write("Image from local file: ");
builder.InsertImage(ImageDir + "Logo.jpg");
builder.Writeln();

// 2 - قم بتمرير عنوان URL الذي يشير إلى صورة.
builder.Write("Image from a URL: ");
builder.InsertImage(ImageUrl);
builder.Writeln();

doc.Save(ArtifactsDir + "Image.FromUrl.docx");

يوضح كيفية إدراج صورة عائمة في وسط الصفحة.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// قم بإدراج صورة عائمة ستظهر خلف النص المتداخل وقم بمحاذاتها مع مركز الصفحة.
Shape shape = builder.InsertImage(ImageDir + "Logo.jpg");
shape.WrapType = WrapType.None;
shape.BehindText = true;
shape.RelativeHorizontalPosition = RelativeHorizontalPosition.Page;
shape.RelativeVerticalPosition = RelativeVerticalPosition.Page;
shape.HorizontalAlignment = HorizontalAlignment.Center;
shape.VerticalAlignment = VerticalAlignment.Center;

doc.Save(ArtifactsDir + "Image.CreateFloatingPageCenter.docx");

يوضح كيفية تحديد الصورة التي سيتم إدراجها.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.InsertImage(ImageDir + "Scalable Vector Graphics.svg");

// يقوم Aspose.Words بإدراج صورة SVG في المستند بصيغة PNG مع امتداد svgBlip
// التي تحتوي على تمثيل صورة SVG المتجهة الأصلية.
doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertSvgImage.SvgWithSvgBlip.docx");

// يقوم Aspose.Words بإدراج صورة SVG في المستند بصيغة PNG، تمامًا كما يفعل Microsoft Word للتنسيق القديم.
doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertSvgImage.Svg.doc");

doc.CompatibilityOptions.OptimizeFor(MsWordVersion.Word2003);

// يقوم Aspose.Words بإدراج صورة SVG في المستند كملف EMF للحفاظ على الصورة في تمثيل متجه.
doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertSvgImage.Emf.docx");

يوضح كيفية إدراج صورة من نظام الملفات المحلي في مستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// فيما يلي ثلاث طرق لإدراج صورة من اسم ملف النظام المحلي.
// 1 - شكل مضمن بحجم افتراضي يعتمد على الأبعاد الأصلية للصورة:
builder.InsertImage(ImageDir + "Logo.jpg");

builder.InsertBreak(BreakType.PageBreak);

// 2 - شكل مضمن بأبعاد مخصصة:
builder.InsertImage(ImageDir + "Transparent background logo.png", ConvertUtil.PixelToPoint(250),
    ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - الشكل العائم مع الأبعاد المخصصة:
builder.InsertImage(ImageDir + "Windows MetaFile.wmf", RelativeHorizontalPosition.Margin, 100, 
    RelativeVerticalPosition.Margin, 100, 200, 100, WrapType.Square);

doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertImageFromFilename.docx");

أنظر أيضا

• class Shape
• class DocumentBuilder
• مساحة الاسم Aspose.Words
• المجسم Aspose.Words

---

InsertImage(Stream)

يُدرج صورة من تدفق في المستند. تُدرج الصورة مضمنةً وبمقياس ١٠٠٪.

public Shape InsertImage(Stream stream)

معامل	يكتب	وصف
stream	Stream	الدفق الذي يحتوي على الصورة.

قيمة الإرجاع

عقدة الصورة التي تم إدراجها للتو.

ملاحظات

يمكنك تغيير حجم الصورة وموقعها وطريقة تحديد الموقع والإعدادات الأخرى باستخدام Shape الكائن الذي تم إرجاعه بواسطة هذه الطريقة.

أمثلة

يوضح كيفية إدراج شكل مع صورة من مجرى إلى مستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

using (Stream stream = File.OpenRead(ImageDir + "Logo.jpg"))
{
    builder.Write("Image from stream: ");
    builder.InsertImage(stream);
}

doc.Save(ArtifactsDir + "Image.FromStream.docx");

يوضح كيفية إدراج صورة من مجرى إلى مستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

using (Stream stream = File.OpenRead(ImageDir + "Logo.jpg"))
{
    // فيما يلي ثلاث طرق لإدراج صورة من مجرى.
    // 1 - شكل مضمن بحجم افتراضي يعتمد على الأبعاد الأصلية للصورة:
    builder.InsertImage(stream);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - شكل مضمن بأبعاد مخصصة:
    builder.InsertImage(stream, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - الشكل العائم مع الأبعاد المخصصة:
    builder.InsertImage(stream, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
        100, 200, 100, WrapType.Square);
}

doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertImageFromStream.docx");

أنظر أيضا

• class Shape
• class DocumentBuilder
• مساحة الاسم Aspose.Words
• المجسم Aspose.Words

---

InsertImage(byte[])

يُدرج صورة من مصفوفة بايتات في المستند. تُدرج الصورة مضمنةً وبمقياس ١٠٠٪.

public Shape InsertImage(byte[] imageBytes)

معامل	يكتب	وصف
imageBytes	Byte[]	مجموعة البايتات التي تحتوي على الصورة.

قيمة الإرجاع

عقدة الصورة التي تم إدراجها للتو.

ملاحظات

يمكنك تغيير حجم الصورة وموقعها وطريقة تحديد الموقع والإعدادات الأخرى باستخدام Shape الكائن الذي تم إرجاعه بواسطة هذه الطريقة.

أمثلة

يوضح كيفية إدراج صورة من مجموعة بايتات في مستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

byte[] imageByteArray = TestUtil.ImageToByteArray(ImageDir + "Logo.jpg");

// فيما يلي ثلاث طرق لإدراج صورة من مجموعة بايتات.
// 1 - شكل مضمن بحجم افتراضي يعتمد على الأبعاد الأصلية للصورة:
builder.InsertImage(imageByteArray);

builder.InsertBreak(BreakType.PageBreak);

// 2 - شكل مضمن بأبعاد مخصصة:
builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - الشكل العائم مع الأبعاد المخصصة:
builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertImageFromByteArray.docx");

أنظر أيضا

• class Shape
• class DocumentBuilder
• مساحة الاسم Aspose.Words
• المجسم Aspose.Words

---

InsertImage(Image, double, double)

يقوم بإدراج صورة مضمنة من .NETImage الكائن في المستند ويقوم بتغيير حجمه إلى الحجم المحدد.

public Shape InsertImage(Image image, double width, double height)

معامل	يكتب	وصف
image	Image	الصورة التي سيتم إدراجها في المستند.
width	Double	عرض الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس ١٠٠٪.
height	Double	ارتفاع الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس ١٠٠٪.

قيمة الإرجاع

عقدة الصورة التي تم إدراجها للتو.

ملاحظات

يمكنك تغيير حجم الصورة وموقعها وطريقة تحديد الموقع والإعدادات الأخرى باستخدام Shape الكائن الذي تم إرجاعه بواسطة هذه الطريقة.

أمثلة

يوضح كيفية إدراج صورة من كائن إلى مستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

string imageFile = ImageDir + "Logo.jpg";

// فيما يلي ثلاث طرق لإدراج صورة من مثيل كائن الصورة.
// 1 - شكل مضمن بحجم افتراضي يعتمد على الأبعاد الأصلية للصورة:
builder.InsertImage(imageFile);

builder.InsertBreak(BreakType.PageBreak);

// 2 - شكل مضمن بأبعاد مخصصة:
builder.InsertImage(imageFile, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - الشكل العائم مع الأبعاد المخصصة:
builder.InsertImage(imageFile, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertImageFromImageObject.docx");

أنظر أيضا

• class Shape
• class DocumentBuilder
• مساحة الاسم Aspose.Words
• المجسم Aspose.Words

---

InsertImage(string, double, double)

يقوم بإدراج صورة مضمنة من ملف أو عنوان URL في المستند ويقوم بتغيير حجمها إلى الحجم المحدد.

public Shape InsertImage(string fileName, double width, double height)

معامل	يكتب	وصف
fileName	String	الملف الذي يحتوي على الصورة.
width	Double	عرض الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس ١٠٠٪.
height	Double	ارتفاع الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس ١٠٠٪.

قيمة الإرجاع

عقدة الصورة التي تم إدراجها للتو.

ملاحظات

يمكنك تغيير حجم الصورة وموقعها وطريقة تحديد الموقع والإعدادات الأخرى باستخدام Shape الكائن الذي تم إرجاعه بواسطة هذه الطريقة.

أمثلة

يوضح كيفية إدراج صورة من نظام الملفات المحلي في مستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// فيما يلي ثلاث طرق لإدراج صورة من اسم ملف النظام المحلي.
// 1 - شكل مضمن بحجم افتراضي يعتمد على الأبعاد الأصلية للصورة:
builder.InsertImage(ImageDir + "Logo.jpg");

builder.InsertBreak(BreakType.PageBreak);

// 2 - شكل مضمن بأبعاد مخصصة:
builder.InsertImage(ImageDir + "Transparent background logo.png", ConvertUtil.PixelToPoint(250),
    ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - الشكل العائم مع الأبعاد المخصصة:
builder.InsertImage(ImageDir + "Windows MetaFile.wmf", RelativeHorizontalPosition.Margin, 100, 
    RelativeVerticalPosition.Margin, 100, 200, 100, WrapType.Square);

doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertImageFromFilename.docx");

أنظر أيضا

• class Shape
• class DocumentBuilder
• مساحة الاسم Aspose.Words
• المجسم Aspose.Words

---

InsertImage(Stream, double, double)

يقوم بإدراج صورة مضمنة من مجرى في المستند ويقوم بتغيير حجمها إلى الحجم المحدد.

public Shape InsertImage(Stream stream, double width, double height)

معامل	يكتب	وصف
stream	Stream	التيار الذي يحتوي على الصورة.
width	Double	عرض الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس ١٠٠٪.
height	Double	ارتفاع الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس ١٠٠٪.

قيمة الإرجاع

عقدة الصورة التي تم إدراجها للتو.

ملاحظات

يمكنك تغيير حجم الصورة وموقعها وطريقة تحديد الموقع والإعدادات الأخرى باستخدام Shape الكائن الذي تم إرجاعه بواسطة هذه الطريقة.

أمثلة

يوضح كيفية إدراج صورة من مجرى إلى مستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

using (Stream stream = File.OpenRead(ImageDir + "Logo.jpg"))
{
    // فيما يلي ثلاث طرق لإدراج صورة من مجرى.
    // 1 - شكل مضمن بحجم افتراضي يعتمد على الأبعاد الأصلية للصورة:
    builder.InsertImage(stream);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - شكل مضمن بأبعاد مخصصة:
    builder.InsertImage(stream, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - الشكل العائم مع الأبعاد المخصصة:
    builder.InsertImage(stream, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
        100, 200, 100, WrapType.Square);
}

doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertImageFromStream.docx");

أنظر أيضا

• class Shape
• class DocumentBuilder
• مساحة الاسم Aspose.Words
• المجسم Aspose.Words

---

InsertImage(byte[], double, double)

يقوم بإدراج صورة مضمنة من مجموعة بايتات في المستند ويقوم بتغيير حجمها إلى الحجم المحدد.

public Shape InsertImage(byte[] imageBytes, double width, double height)

معامل	يكتب	وصف
imageBytes	Byte[]	مجموعة البايتات التي تحتوي على الصورة.
width	Double	عرض الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس ١٠٠٪.
height	Double	ارتفاع الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس ١٠٠٪.

قيمة الإرجاع

عقدة الصورة التي تم إدراجها للتو.

ملاحظات

يمكنك تغيير حجم الصورة وموقعها وطريقة تحديد الموقع والإعدادات الأخرى باستخدام Shape الكائن الذي تم إرجاعه بواسطة هذه الطريقة.

أمثلة

يوضح كيفية إدراج صورة من مجموعة بايتات في مستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

byte[] imageByteArray = TestUtil.ImageToByteArray(ImageDir + "Logo.jpg");

// فيما يلي ثلاث طرق لإدراج صورة من مجموعة بايتات.
// 1 - شكل مضمن بحجم افتراضي يعتمد على الأبعاد الأصلية للصورة:
builder.InsertImage(imageByteArray);

builder.InsertBreak(BreakType.PageBreak);

// 2 - شكل مضمن بأبعاد مخصصة:
builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - الشكل العائم مع الأبعاد المخصصة:
builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertImageFromByteArray.docx");

أنظر أيضا

• class Shape
• class DocumentBuilder
• مساحة الاسم Aspose.Words
• المجسم Aspose.Words

---

InsertImage(Image, RelativeHorizontalPosition, double, RelativeVerticalPosition, double, double, double, WrapType)

إدراج صورة من .NETImage الكائن في الموضع والحجم المحددين.

public Shape InsertImage(Image image, RelativeHorizontalPosition horzPos, double left, 
    RelativeVerticalPosition vertPos, double top, double width, double height, WrapType wrapType)

معامل	يكتب	وصف
image	Image	الصورة التي سيتم إدراجها في المستند.
horzPos	RelativeHorizontalPosition	يحدد المكان الذي يتم قياس المسافة منه إلى الصورة.
left	Double	المسافة بالنقاط من الأصل إلى الجانب الأيسر من الصورة.
vertPos	RelativeVerticalPosition	يحدد المكان الذي يتم قياس المسافة منه إلى الصورة.
top	Double	المسافة بالنقاط من الأصل إلى الجانب العلوي من الصورة.
width	Double	عرض الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس ١٠٠٪.
height	Double	ارتفاع الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس ١٠٠٪.
wrapType	WrapType	يحدد كيفية لف النص حول الصورة.

قيمة الإرجاع

عقدة الصورة التي تم إدراجها للتو.

ملاحظات

يمكنك تغيير حجم الصورة وموقعها وطريقة تحديد الموقع والإعدادات الأخرى باستخدام Shape الكائن الذي تم إرجاعه بواسطة هذه الطريقة.

أمثلة

يوضح كيفية إدراج صورة من كائن إلى مستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

string imageFile = ImageDir + "Logo.jpg";

// فيما يلي ثلاث طرق لإدراج صورة من مثيل كائن الصورة.
// 1 - شكل مضمن بحجم افتراضي يعتمد على الأبعاد الأصلية للصورة:
builder.InsertImage(imageFile);

builder.InsertBreak(BreakType.PageBreak);

// 2 - شكل مضمن بأبعاد مخصصة:
builder.InsertImage(imageFile, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - الشكل العائم مع الأبعاد المخصصة:
builder.InsertImage(imageFile, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertImageFromImageObject.docx");

أنظر أيضا

• class Shape
• enum RelativeHorizontalPosition
• enum RelativeVerticalPosition
• enum WrapType
• class DocumentBuilder
• مساحة الاسم Aspose.Words
• المجسم Aspose.Words

---

InsertImage(string, RelativeHorizontalPosition, double, RelativeVerticalPosition, double, double, double, WrapType)

يقوم بإدراج صورة من ملف أو عنوان URL في الموضع والحجم المحددين.

public Shape InsertImage(string fileName, RelativeHorizontalPosition horzPos, double left, 
    RelativeVerticalPosition vertPos, double top, double width, double height, WrapType wrapType)

معامل	يكتب	وصف
fileName	String	الملف الذي يحتوي على الصورة.
horzPos	RelativeHorizontalPosition	يحدد المكان الذي يتم قياس المسافة منه إلى الصورة.
left	Double	المسافة بالنقاط من الأصل إلى الجانب الأيسر من الصورة.
vertPos	RelativeVerticalPosition	يحدد المكان الذي يتم قياس المسافة منه إلى الصورة.
top	Double	المسافة بالنقاط من الأصل إلى الجانب العلوي من الصورة.
width	Double	عرض الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس ١٠٠٪.
height	Double	ارتفاع الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس ١٠٠٪.
wrapType	WrapType	يحدد كيفية لف النص حول الصورة.

قيمة الإرجاع

عقدة الصورة التي تم إدراجها للتو.

ملاحظات

يمكنك تغيير حجم الصورة وموقعها وطريقة تحديد الموقع والإعدادات الأخرى باستخدام Shape الكائن الذي تم إرجاعه بواسطة هذه الطريقة.

أمثلة

يوضح كيفية إدراج صورة.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// هناك طريقتان لاستخدام منشئ المستندات لتحديد مصدر الصورة ثم إدراجها كشكل عائم.
// 1 - من ملف في نظام الملفات المحلي:
builder.InsertImage(ImageDir + "Transparent background logo.png", RelativeHorizontalPosition.Margin, 100,
    RelativeVerticalPosition.Margin, 0, 200, 200, WrapType.Square);

// 2 - من عنوان URL:
builder.InsertImage(ImageUrl, RelativeHorizontalPosition.Margin, 100,
    RelativeVerticalPosition.Margin, 250, 200, 200, WrapType.Square);

doc.Save(ArtifactsDir + "DocumentBuilder.InsertFloatingImage.docx");

يوضح كيفية إدراج صورة من نظام الملفات المحلي في مستند مع الحفاظ على أبعادها.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// تقوم طريقة InsertImage بإنشاء شكل عائم بالصورة المرسلة في بيانات صورته.
//يمكننا تحديد أبعاد الشكل عن طريق تمريرها إلى هذه الطريقة.
Shape imageShape = builder.InsertImage(ImageDir + "Logo.jpg", RelativeHorizontalPosition.Margin, 0,
    RelativeVerticalPosition.Margin, 0, -1, -1, WrapType.Square);

// تمرير القيم السلبية كأبعاد مقصودة سيحدد تلقائيًا
// أبعاد الشكل بناءً على أبعاد صورته.
Assert.AreEqual(300.0d, imageShape.Width);
Assert.AreEqual(300.0d, imageShape.Height);

doc.Save(ArtifactsDir + "DocumentBuilder.InsertImageOriginalSize.docx");

يوضح كيفية إدراج صورة من نظام الملفات المحلي في مستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// فيما يلي ثلاث طرق لإدراج صورة من اسم ملف النظام المحلي.
// 1 - شكل مضمن بحجم افتراضي يعتمد على الأبعاد الأصلية للصورة:
builder.InsertImage(ImageDir + "Logo.jpg");

builder.InsertBreak(BreakType.PageBreak);

// 2 - شكل مضمن بأبعاد مخصصة:
builder.InsertImage(ImageDir + "Transparent background logo.png", ConvertUtil.PixelToPoint(250),
    ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - الشكل العائم مع الأبعاد المخصصة:
builder.InsertImage(ImageDir + "Windows MetaFile.wmf", RelativeHorizontalPosition.Margin, 100, 
    RelativeVerticalPosition.Margin, 100, 200, 100, WrapType.Square);

doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertImageFromFilename.docx");

أنظر أيضا

• class Shape
• enum RelativeHorizontalPosition
• enum RelativeVerticalPosition
• enum WrapType
• class DocumentBuilder
• مساحة الاسم Aspose.Words
• المجسم Aspose.Words

---

InsertImage(Stream, RelativeHorizontalPosition, double, RelativeVerticalPosition, double, double, double, WrapType)

يقوم بإدراج صورة من مجرى في الموضع والحجم المحددين.

public Shape InsertImage(Stream stream, RelativeHorizontalPosition horzPos, double left, 
    RelativeVerticalPosition vertPos, double top, double width, double height, WrapType wrapType)

معامل	يكتب	وصف
stream	Stream	التيار الذي يحتوي على الصورة.
horzPos	RelativeHorizontalPosition	يحدد المكان الذي يتم قياس المسافة منه إلى الصورة.
left	Double	المسافة بالنقاط من الأصل إلى الجانب الأيسر من الصورة.
vertPos	RelativeVerticalPosition	يحدد المكان الذي يتم قياس المسافة منه إلى الصورة.
top	Double	المسافة بالنقاط من الأصل إلى الجانب العلوي من الصورة.
width	Double	عرض الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس ١٠٠٪.
height	Double	ارتفاع الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس ١٠٠٪.
wrapType	WrapType	يحدد كيفية لف النص حول الصورة.

قيمة الإرجاع

عقدة الصورة التي تم إدراجها للتو.

ملاحظات

يمكنك تغيير حجم الصورة وموقعها وطريقة تحديد الموقع والإعدادات الأخرى باستخدام Shape الكائن الذي تم إرجاعه بواسطة هذه الطريقة.

أمثلة

يوضح كيفية إدراج صورة من مجرى إلى مستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

using (Stream stream = File.OpenRead(ImageDir + "Logo.jpg"))
{
    // فيما يلي ثلاث طرق لإدراج صورة من مجرى.
    // 1 - شكل مضمن بحجم افتراضي يعتمد على الأبعاد الأصلية للصورة:
    builder.InsertImage(stream);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - شكل مضمن بأبعاد مخصصة:
    builder.InsertImage(stream, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - الشكل العائم مع الأبعاد المخصصة:
    builder.InsertImage(stream, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
        100, 200, 100, WrapType.Square);
}

doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertImageFromStream.docx");

أنظر أيضا

• class Shape
• enum RelativeHorizontalPosition
• enum RelativeVerticalPosition
• enum WrapType
• class DocumentBuilder
• مساحة الاسم Aspose.Words
• المجسم Aspose.Words

---

InsertImage(byte[], RelativeHorizontalPosition, double, RelativeVerticalPosition, double, double, double, WrapType)

يقوم بإدراج صورة من مجموعة بايتات في الموضع والحجم المحددين.

public Shape InsertImage(byte[] imageBytes, RelativeHorizontalPosition horzPos, double left, 
    RelativeVerticalPosition vertPos, double top, double width, double height, WrapType wrapType)

معامل	يكتب	وصف
imageBytes	Byte[]	مجموعة البايتات التي تحتوي على الصورة.
horzPos	RelativeHorizontalPosition	يحدد المكان الذي يتم قياس المسافة منه إلى الصورة.
left	Double	المسافة بالنقاط من الأصل إلى الجانب الأيسر من الصورة.
vertPos	RelativeVerticalPosition	يحدد المكان الذي يتم قياس المسافة منه إلى الصورة.
top	Double	المسافة بالنقاط من الأصل إلى الجانب العلوي من الصورة.
width	Double	عرض الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس ١٠٠٪.
height	Double	ارتفاع الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس ١٠٠٪.
wrapType	WrapType	يحدد كيفية لف النص حول الصورة.

قيمة الإرجاع

عقدة الصورة التي تم إدراجها للتو.

ملاحظات

يمكنك تغيير حجم الصورة وموقعها وطريقة تحديد الموقع والإعدادات الأخرى باستخدام Shape الكائن الذي تم إرجاعه بواسطة هذه الطريقة.

أمثلة

يوضح كيفية إدراج صورة من مجموعة بايتات في مستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

byte[] imageByteArray = TestUtil.ImageToByteArray(ImageDir + "Logo.jpg");

// فيما يلي ثلاث طرق لإدراج صورة من مجموعة بايتات.
// 1 - شكل مضمن بحجم افتراضي يعتمد على الأبعاد الأصلية للصورة:
builder.InsertImage(imageByteArray);

builder.InsertBreak(BreakType.PageBreak);

// 2 - شكل مضمن بأبعاد مخصصة:
builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - الشكل العائم مع الأبعاد المخصصة:
builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertImageFromByteArray.docx");

أنظر أيضا

• class Shape
• enum RelativeHorizontalPosition
• enum RelativeVerticalPosition
• enum WrapType
• class DocumentBuilder
• مساحة الاسم Aspose.Words
• المجسم Aspose.Words