InsertImage

InsertImage(Image)

Вставляет изображение из .NET.Image в документ. Изображение вставляется встроенным в масштаб 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");

// Ниже приведены три способа вставки изображения из экземпляра объекта Image.
// 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)

Вставляет встроенное изображение из .NET.Image объект в документ и масштабирует его до указанного размера.

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");

// Ниже приведены три способа вставки изображения из экземпляра объекта Image.
// 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"))
{
    // Ниже приведены три способа вставки изображения из экземпляра объекта Image.
    // 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)

Вставляет изображение из .NET.ImageОбъект в указанном положении и размере.

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");

// Ниже приведены три способа вставки изображения из экземпляра объекта Image.
// 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"))
{
    // Ниже приведены три способа вставки изображения из экземпляра объекта Image.
    // 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