InsertImage

InsertImage(Image)

إدراج صورة من .NETImage كائن في المستند. تم إدراج الصورة سطريًا وبحجم 100%.

public Shape InsertImage(Image image)

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

قيمة الإرجاع

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

ملاحظات

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

أمثلة

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

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

Image image = Image.FromFile(ImageDir + "Logo.jpg");

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

builder.InsertBreak(BreakType.PageBreak);

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

builder.InsertBreak(BreakType.PageBreak);

// 3 - شكل عائم بأبعاد مخصصة:
builder.InsertImage(image, 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)

إدراج صورة من ملف أو عنوان URL في المستند. تم إدراج الصورة سطريًا وبحجم 100%.

public Shape InsertImage(string fileName)

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

قيمة الإرجاع

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

ملاحظات

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

أمثلة

يوضح كيفية إدراج صورة 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)

يقوم بإدراج صورة من الدفق إلى المستند. تم إدراج الصورة سطريًا وبحجم 100%.

public Shape InsertImage(Stream stream)

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

قيمة الإرجاع

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

ملاحظات

أمثلة

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

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[])

إدراج صورة من مصفوفة بايت في المستند. تم إدراج الصورة سطريًا وبحجم 100%.

public Shape InsertImage(byte[] imageBytes)

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

قيمة الإرجاع

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

ملاحظات

أمثلة

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

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

Image image = Image.FromFile(ImageDir + "Logo.jpg");

using (MemoryStream ms = new MemoryStream())
{
    image.Save(ms, ImageFormat.Png);
    byte[] imageByteArray = ms.ToArray();

    // فيما يلي ثلاث طرق لإدراج صورة من مصفوفة بايت.
    // 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");

يوضح كيفية إدراج صورة من مصفوفة بايت في مستند (.NetStandard 2.0).

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

// سيؤدي فك تشفير الصورة إلى تحويلها إلى تنسيق .png.
using (SKBitmap bitmap = SKBitmap.Decode(ImageDir + "Logo.jpg"))
{
    using (SKImage image = SKImage.FromBitmap(bitmap))
    {
        using (SKData data = image.Encode())
        {
            byte[] imageByteArray = data.ToArray();

            // فيما يلي ثلاث طرق لإدراج صورة من مصفوفة بايت.
            // 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.InsertImageFromByteArrayNetStandard2.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	عرض الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس 100%.
height	Double	ارتفاع الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس 100%.

قيمة الإرجاع

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

ملاحظات

أمثلة

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

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

Image image = Image.FromFile(ImageDir + "Logo.jpg");

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

builder.InsertBreak(BreakType.PageBreak);

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

builder.InsertBreak(BreakType.PageBreak);

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

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

يوضح كيفية إدراج صورة من كائن في مستند (.NetStandard 2.0).

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

// سيؤدي فك تشفير الصورة إلى تحويلها إلى تنسيق .png.
using (SKBitmap bitmap = SKBitmap.Decode(ImageDir + "Logo.jpg"))
{
    // فيما يلي ثلاث طرق لإدراج صورة من مثيل كائن الصورة.
    // 1 - شكل سطري بحجم افتراضي يعتمد على الأبعاد الأصلية للصورة:
    builder.InsertImage(bitmap);

    builder.InsertBreak(BreakType.PageBreak);

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

    builder.InsertBreak(BreakType.PageBreak);

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

doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertImageFromImageObjectNetStandard2.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	عرض الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس 100%.
height	Double	ارتفاع الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس 100%.

قيمة الإرجاع

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

ملاحظات

أمثلة

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

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	عرض الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس 100%.
height	Double	ارتفاع الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس 100%.

قيمة الإرجاع

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

ملاحظات

أمثلة

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

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	عرض الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس 100%.
height	Double	ارتفاع الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس 100%.

قيمة الإرجاع

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

ملاحظات

أمثلة

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

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

Image image = Image.FromFile(ImageDir + "Logo.jpg");

using (MemoryStream ms = new MemoryStream())
{
    image.Save(ms, ImageFormat.Png);
    byte[] imageByteArray = ms.ToArray();

    // فيما يلي ثلاث طرق لإدراج صورة من مصفوفة بايت.
    // 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");

يوضح كيفية إدراج صورة من مصفوفة بايت في مستند (.NetStandard 2.0).

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

// سيؤدي فك تشفير الصورة إلى تحويلها إلى تنسيق .png.
using (SKBitmap bitmap = SKBitmap.Decode(ImageDir + "Logo.jpg"))
{
    using (SKImage image = SKImage.FromBitmap(bitmap))
    {
        using (SKData data = image.Encode())
        {
            byte[] imageByteArray = data.ToArray();

            // فيما يلي ثلاث طرق لإدراج صورة من مصفوفة بايت.
            // 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.InsertImageFromByteArrayNetStandard2.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	عرض الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس 100%.
height	Double	ارتفاع الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس 100%.
wrapType	WrapType	يحدد كيفية التفاف النص حول الصورة.

قيمة الإرجاع

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

ملاحظات

أمثلة

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

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

Image image = Image.FromFile(ImageDir + "Logo.jpg");

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

builder.InsertBreak(BreakType.PageBreak);

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

builder.InsertBreak(BreakType.PageBreak);

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

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

يوضح كيفية إدراج صورة من كائن في مستند (.NetStandard 2.0).

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

// سيؤدي فك تشفير الصورة إلى تحويلها إلى تنسيق .png.
using (SKBitmap bitmap = SKBitmap.Decode(ImageDir + "Logo.jpg"))
{
    // فيما يلي ثلاث طرق لإدراج صورة من مثيل كائن الصورة.
    // 1 - شكل سطري بحجم افتراضي يعتمد على الأبعاد الأصلية للصورة:
    builder.InsertImage(bitmap);

    builder.InsertBreak(BreakType.PageBreak);

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

    builder.InsertBreak(BreakType.PageBreak);

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

doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertImageFromImageObjectNetStandard2.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	عرض الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس 100%.
height	Double	ارتفاع الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس 100%.
wrapType	WrapType	يحدد كيفية التفاف النص حول الصورة.

قيمة الإرجاع

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

ملاحظات

أمثلة

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

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	عرض الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس 100%.
height	Double	ارتفاع الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس 100%.
wrapType	WrapType	يحدد كيفية التفاف النص حول الصورة.

قيمة الإرجاع

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

ملاحظات

أمثلة

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

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	عرض الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس 100%.
height	Double	ارتفاع الصورة بالنقاط. يمكن أن تكون قيمة سالبة أو صفرية لطلب مقياس 100%.
wrapType	WrapType	يحدد كيفية التفاف النص حول الصورة.

قيمة الإرجاع

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

ملاحظات

أمثلة

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

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

Image image = Image.FromFile(ImageDir + "Logo.jpg");

using (MemoryStream ms = new MemoryStream())
{
    image.Save(ms, ImageFormat.Png);
    byte[] imageByteArray = ms.ToArray();

    // فيما يلي ثلاث طرق لإدراج صورة من مصفوفة بايت.
    // 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");

يوضح كيفية إدراج صورة من مصفوفة بايت في مستند (.NetStandard 2.0).

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

// سيؤدي فك تشفير الصورة إلى تحويلها إلى تنسيق .png.
using (SKBitmap bitmap = SKBitmap.Decode(ImageDir + "Logo.jpg"))
{
    using (SKImage image = SKImage.FromBitmap(bitmap))
    {
        using (SKData data = image.Encode())
        {
            byte[] imageByteArray = data.ToArray();

            // فيما يلي ثلاث طرق لإدراج صورة من مصفوفة بايت.
            // 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.InsertImageFromByteArrayNetStandard2.docx");

أنظر أيضا

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

DocumentBuilder.InsertHyperlink DocumentBuilder.InsertNode