InsertImage

InsertImage(Image)

Infogar en bild från ett .NETImage objekt i dokumentet. Bilden infogas inline och i 100 % skala.

public Shape InsertImage(Image image)
ParameterTypBeskrivning
imageImageBilden som ska infogas i dokumentet.

Returvärde

Bildnoden som precis infogades.

Anmärkningar

Du kan ändra bildstorlek, plats, positioneringsmetod och andra inställningar med hjälp av Shape objekt som returneras med denna metod.

Exempel

Visar hur man infogar en bild från ett objekt i ett dokument.

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

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

// Nedan finns tre sätt att infoga en bild från en bildobjektsinstans.
// 1 - Inline form med en standardstorlek baserad på bildens ursprungliga mått:
builder.InsertImage(image);

builder.InsertBreak(BreakType.PageBreak);

// 2 - Inline form med anpassade mått:
builder.InsertImage(image, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Flytande form med anpassade mått:
builder.InsertImage(image, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

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

Se även


InsertImage(string)

Infogar en bild från en fil eller URL i dokumentet. Bilden infogas inline och i 100 % skala.

public Shape InsertImage(string fileName)
ParameterTypBeskrivning
fileNameStringFilen med bilden. Kan vara vilken giltig lokal eller fjärr-URI som helst.

Returvärde

Bildnoden som precis infogades.

Anmärkningar

Denna överbelastning kommer automatiskt att ladda ner bilden innan den infogas i document om du anger en fjärr-URI.

Du kan ändra bildstorlek, plats, positioneringsmetod och andra inställningar med hjälp av Shape objekt som returneras med denna metod.

Exempel

Visar hur man infogar gif-bild i dokumentet.

DocumentBuilder builder = new DocumentBuilder();

// Vi kan infoga gif-bild med hjälp av path eller bytes array.
// Det fungerar bara om DocumentBuilder är optimerat till Word version 2010 eller högre.
// Observera att åtkomst till bildbytes orsakar konvertering av Gif till 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");

Visar hur man infogar en form med en bild i ett dokument.

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

// Nedan finns två platser där dokumentbyggarens "InsertShape"-metod
// kan hämta bilden som formen kommer att visa.
// 1 - Skicka ett lokalt filsystems filnamn för en bildfil:
builder.Write("Image from local file: ");
builder.InsertImage(ImageDir + "Logo.jpg");
builder.Writeln();

// 2 - Skicka en URL som pekar på en bild.
builder.Write("Image from a URL: ");
builder.InsertImage(ImageUrl);
builder.Writeln();

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

Visar hur man infogar en flytande bild i mitten av en sida.

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

// Infoga en flytande bild som kommer att visas bakom den överlappande texten och justera den mot sidans mitt.
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");

Visar hur man bestämmer vilken bild som ska infogas.

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

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

// Aspose.Words infogar SVG-bild till dokumentet som PNG med svgBlip-tillägg
// som innehåller den ursprungliga vektorns SVG-bildrepresentation.
doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertSvgImage.SvgWithSvgBlip.docx");

// Aspose.Words infogar SVG-bild i dokumentet som PNG, precis som Microsoft Word gör för gamla format.
doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertSvgImage.Svg.doc");

doc.CompatibilityOptions.OptimizeFor(MsWordVersion.Word2003);

// Aspose.Words infogar SVG-bild i dokumentet som EMF-metafil för att behålla bilden i vektorrepresentation.
doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertSvgImage.Emf.docx");

Visar hur man infogar en bild från det lokala filsystemet i ett dokument.

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

// Nedan finns tre sätt att infoga en bild från ett lokalt systemfilnamn.
// 1 - Inline form med en standardstorlek baserad på bildens ursprungliga mått:
builder.InsertImage(ImageDir + "Logo.jpg");

builder.InsertBreak(BreakType.PageBreak);

// 2 - Inline form med anpassade mått:
builder.InsertImage(ImageDir + "Transparent background logo.png", ConvertUtil.PixelToPoint(250),
    ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Flytande form med anpassade mått:
builder.InsertImage(ImageDir + "Windows MetaFile.wmf", RelativeHorizontalPosition.Margin, 100, 
    RelativeVerticalPosition.Margin, 100, 200, 100, WrapType.Square);

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

Se även


InsertImage(Stream)

Infogar en bild från en ström i dokumentet. Bilden infogas inline och i 100 % skala.

public Shape InsertImage(Stream stream)
ParameterTypBeskrivning
streamStreamStrömmen som innehåller bilden.

Returvärde

Bildnoden som precis infogades.

Anmärkningar

Du kan ändra bildstorlek, plats, positioneringsmetod och andra inställningar med hjälp av Shape objekt som returneras med denna metod.

Exempel

Visar hur man infogar en form med en bild från en ström i ett dokument.

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

Visar hur man infogar en bild från en ström i ett dokument.

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

using (Stream stream = File.OpenRead(ImageDir + "Logo.jpg"))
{
    // Nedan finns tre sätt att infoga en bild från en ström.
    // 1 - Inline form med en standardstorlek baserad på bildens ursprungliga mått:
    builder.InsertImage(stream);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Inline form med anpassade mått:
    builder.InsertImage(stream, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Flytande form med anpassade mått:
    builder.InsertImage(stream, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
        100, 200, 100, WrapType.Square);
}

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

Se även


InsertImage(byte[])

Infogar en bild från en byte-array i dokumentet. Bilden infogas inline och i 100 % skala.

public Shape InsertImage(byte[] imageBytes)
ParameterTypBeskrivning
imageBytesByte[]Byte-arrayen som innehåller bilden.

Returvärde

Bildnoden som precis infogades.

Anmärkningar

Du kan ändra bildstorlek, plats, positioneringsmetod och andra inställningar med hjälp av Shape objekt som returneras med denna metod.

Exempel

Visar hur man infogar en bild från en byte-array i ett dokument.

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

    // Nedan finns tre sätt att infoga en bild från en byte-array.
    // 1 - Inline form med en standardstorlek baserad på bildens ursprungliga mått:
    builder.InsertImage(imageByteArray);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Inline form med anpassade mått:
    builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Flytande form med anpassade mått:
    builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin, 
    100, 200, 100, WrapType.Square);
}

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

Visar hur man infogar en bild från en byte-array i ett dokument (.NetStandard 2.0).

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

// Avkodning av bilden kommer att konvertera den till .png-formatet.
using (SKBitmap bitmap = SKBitmap.Decode(ImageDir + "Logo.jpg"))
{
    using (SKImage image = SKImage.FromBitmap(bitmap))
    {
        using (SKData data = image.Encode())
        {
            byte[] imageByteArray = data.ToArray();

            // Nedan finns tre sätt att infoga en bild från en byte-array.
            // 1 - Inline form med en standardstorlek baserad på bildens ursprungliga mått:
            builder.InsertImage(imageByteArray);

            builder.InsertBreak(BreakType.PageBreak);

            // 2 - Inline form med anpassade mått:
            builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

            builder.InsertBreak(BreakType.PageBreak);

            // 3 - Flytande form med anpassade mått:
            builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
                100, 200, 100, WrapType.Square);
        }
    }
}

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

Se även


InsertImage(Image, double, double)

Infogar en inline-bild från ett .NETImage objekt i dokumentet och skalar det till den angivna storleken.

public Shape InsertImage(Image image, double width, double height)
ParameterTypBeskrivning
imageImageBilden som ska infogas i dokumentet.
widthDoubleBildens bredd i punkter. Kan vara ett negativt eller noll värde för att begära 100 % skala.
heightDoubleBildens höjd i punkter. Kan vara ett negativt eller noll värde för att begära 100 % skala.

Returvärde

Bildnoden som precis infogades.

Anmärkningar

Du kan ändra bildstorlek, plats, positioneringsmetod och andra inställningar med hjälp av Shape objekt som returneras med denna metod.

Exempel

Visar hur man infogar en bild från ett objekt i ett dokument.

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

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

// Nedan finns tre sätt att infoga en bild från en bildobjektsinstans.
// 1 - Inline form med en standardstorlek baserad på bildens ursprungliga mått:
builder.InsertImage(image);

builder.InsertBreak(BreakType.PageBreak);

// 2 - Inline form med anpassade mått:
builder.InsertImage(image, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Flytande form med anpassade mått:
builder.InsertImage(image, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

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

Visar hur man infogar en bild från ett objekt i ett dokument (.NetStandard 2.0).

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

// Avkodning av bilden kommer att konvertera den till .png-formatet.
using (SKBitmap bitmap = SKBitmap.Decode(ImageDir + "Logo.jpg"))
{
    // Nedan finns tre sätt att infoga en bild från en bildobjektsinstans.
    // 1 - Inline form med en standardstorlek baserad på bildens ursprungliga mått:
    builder.InsertImage(bitmap);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Inline form med anpassade mått:
    builder.InsertImage(bitmap, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Flytande form med anpassade mått:
    builder.InsertImage(bitmap, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
        100, 200, 100, WrapType.Square);
}

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

Se även


InsertImage(string, double, double)

Infogar en inline-bild från en fil eller URL i dokumentet och skalar den till den angivna storleken.

public Shape InsertImage(string fileName, double width, double height)
ParameterTypBeskrivning
fileNameStringFilen som innehåller bilden.
widthDoubleBildens bredd i punkter. Kan vara ett negativt eller noll värde för att begära 100 % skala.
heightDoubleBildens höjd i punkter. Kan vara ett negativt eller noll värde för att begära 100 % skala.

Returvärde

Bildnoden som precis infogades.

Anmärkningar

Du kan ändra bildstorlek, plats, positioneringsmetod och andra inställningar med hjälp av Shape objekt som returneras med denna metod.

Exempel

Visar hur man infogar en bild från det lokala filsystemet i ett dokument.

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

// Nedan finns tre sätt att infoga en bild från ett lokalt systemfilnamn.
// 1 - Inline form med en standardstorlek baserad på bildens ursprungliga mått:
builder.InsertImage(ImageDir + "Logo.jpg");

builder.InsertBreak(BreakType.PageBreak);

// 2 - Inline form med anpassade mått:
builder.InsertImage(ImageDir + "Transparent background logo.png", ConvertUtil.PixelToPoint(250),
    ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Flytande form med anpassade mått:
builder.InsertImage(ImageDir + "Windows MetaFile.wmf", RelativeHorizontalPosition.Margin, 100, 
    RelativeVerticalPosition.Margin, 100, 200, 100, WrapType.Square);

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

Se även


InsertImage(Stream, double, double)

Infogar en inline-bild från en ström i dokumentet och skalar den till den angivna storleken.

public Shape InsertImage(Stream stream, double width, double height)
ParameterTypBeskrivning
streamStreamStrömmen som innehåller bilden.
widthDoubleBildens bredd i punkter. Kan vara ett negativt eller noll värde för att begära 100 % skala.
heightDoubleBildens höjd i punkter. Kan vara ett negativt eller noll värde för att begära 100 % skala.

Returvärde

Bildnoden som precis infogades.

Anmärkningar

Du kan ändra bildstorlek, plats, positioneringsmetod och andra inställningar med hjälp av Shape objekt som returneras med denna metod.

Exempel

Visar hur man infogar en bild från en ström i ett dokument.

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

using (Stream stream = File.OpenRead(ImageDir + "Logo.jpg"))
{
    // Nedan finns tre sätt att infoga en bild från en ström.
    // 1 - Inline form med en standardstorlek baserad på bildens ursprungliga mått:
    builder.InsertImage(stream);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Inline form med anpassade mått:
    builder.InsertImage(stream, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Flytande form med anpassade mått:
    builder.InsertImage(stream, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
        100, 200, 100, WrapType.Square);
}

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

Se även


InsertImage(byte[], double, double)

Infogar en inline-bild från en byte-array i dokumentet och skalar den till den angivna storleken.

public Shape InsertImage(byte[] imageBytes, double width, double height)
ParameterTypBeskrivning
imageBytesByte[]Byte-arrayen som innehåller bilden.
widthDoubleBildens bredd i punkter. Kan vara ett negativt eller noll värde för att begära 100 % skala.
heightDoubleBildens höjd i punkter. Kan vara ett negativt eller noll värde för att begära 100 % skala.

Returvärde

Bildnoden som precis infogades.

Anmärkningar

Du kan ändra bildstorlek, plats, positioneringsmetod och andra inställningar med hjälp av Shape objekt som returneras med denna metod.

Exempel

Visar hur man infogar en bild från en byte-array i ett dokument.

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

    // Nedan finns tre sätt att infoga en bild från en byte-array.
    // 1 - Inline form med en standardstorlek baserad på bildens ursprungliga mått:
    builder.InsertImage(imageByteArray);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Inline form med anpassade mått:
    builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Flytande form med anpassade mått:
    builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin, 
    100, 200, 100, WrapType.Square);
}

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

Visar hur man infogar en bild från en byte-array i ett dokument (.NetStandard 2.0).

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

// Avkodning av bilden kommer att konvertera den till .png-formatet.
using (SKBitmap bitmap = SKBitmap.Decode(ImageDir + "Logo.jpg"))
{
    using (SKImage image = SKImage.FromBitmap(bitmap))
    {
        using (SKData data = image.Encode())
        {
            byte[] imageByteArray = data.ToArray();

            // Nedan finns tre sätt att infoga en bild från en byte-array.
            // 1 - Inline form med en standardstorlek baserad på bildens ursprungliga mått:
            builder.InsertImage(imageByteArray);

            builder.InsertBreak(BreakType.PageBreak);

            // 2 - Inline form med anpassade mått:
            builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

            builder.InsertBreak(BreakType.PageBreak);

            // 3 - Flytande form med anpassade mått:
            builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
                100, 200, 100, WrapType.Square);
        }
    }
}

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

Se även


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

Infogar en bild från ett .NETImage objekt vid angiven position och storlek.

public Shape InsertImage(Image image, RelativeHorizontalPosition horzPos, double left, 
    RelativeVerticalPosition vertPos, double top, double width, double height, WrapType wrapType)
ParameterTypBeskrivning
imageImageBilden som ska infogas i dokumentet.
horzPosRelativeHorizontalPositionAnger varifrån avståndet till bilden mäts.
leftDoubleAvstånd i punkter från origo till vänster sida av bilden.
vertPosRelativeVerticalPositionAnger var avståndet till bilden mätt från.
topDoubleAvstånd i punkter från origo till bildens övre sida.
widthDoubleBildens bredd i punkter. Kan vara ett negativt eller noll värde för att begära 100 % skala.
heightDoubleBildens höjd i punkter. Kan vara ett negativt eller noll värde för att begära 100 % skala.
wrapTypeWrapTypeAnger hur text lindas runt bilden.

Returvärde

Bildnoden som precis infogades.

Anmärkningar

Du kan ändra bildstorlek, plats, positioneringsmetod och andra inställningar med hjälp av Shape objekt som returneras med denna metod.

Exempel

Visar hur man infogar en bild från ett objekt i ett dokument.

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

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

// Nedan finns tre sätt att infoga en bild från en bildobjektsinstans.
// 1 - Inline form med en standardstorlek baserad på bildens ursprungliga mått:
builder.InsertImage(image);

builder.InsertBreak(BreakType.PageBreak);

// 2 - Inline form med anpassade mått:
builder.InsertImage(image, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Flytande form med anpassade mått:
builder.InsertImage(image, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

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

Visar hur man infogar en bild från ett objekt i ett dokument (.NetStandard 2.0).

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

// Avkodning av bilden kommer att konvertera den till .png-formatet.
using (SKBitmap bitmap = SKBitmap.Decode(ImageDir + "Logo.jpg"))
{
    // Nedan finns tre sätt att infoga en bild från en bildobjektsinstans.
    // 1 - Inline form med en standardstorlek baserad på bildens ursprungliga mått:
    builder.InsertImage(bitmap);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Inline form med anpassade mått:
    builder.InsertImage(bitmap, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Flytande form med anpassade mått:
    builder.InsertImage(bitmap, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
        100, 200, 100, WrapType.Square);
}

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

Se även


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

Infogar en bild från en fil eller URL på angiven position och storlek.

public Shape InsertImage(string fileName, RelativeHorizontalPosition horzPos, double left, 
    RelativeVerticalPosition vertPos, double top, double width, double height, WrapType wrapType)
ParameterTypBeskrivning
fileNameStringFilen som innehåller bilden.
horzPosRelativeHorizontalPositionAnger varifrån avståndet till bilden mäts.
leftDoubleAvstånd i punkter från origo till vänster sida av bilden.
vertPosRelativeVerticalPositionAnger var avståndet till bilden mätt från.
topDoubleAvstånd i punkter från origo till bildens övre sida.
widthDoubleBildens bredd i punkter. Kan vara ett negativt eller noll värde för att begära 100 % skala.
heightDoubleBildens höjd i punkter. Kan vara ett negativt eller noll värde för att begära 100 % skala.
wrapTypeWrapTypeAnger hur text lindas runt bilden.

Returvärde

Bildnoden som precis infogades.

Anmärkningar

Du kan ändra bildstorlek, plats, positioneringsmetod och andra inställningar med hjälp av Shape objekt som returneras med denna metod.

Exempel

Visar hur man infogar en bild.

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

// Det finns två sätt att använda en dokumentbyggare för att skapa en bild och sedan infoga den som en flytande form.
// 1 - Från en fil i det lokala filsystemet:
builder.InsertImage(ImageDir + "Transparent background logo.png", RelativeHorizontalPosition.Margin, 100,
    RelativeVerticalPosition.Margin, 0, 200, 200, WrapType.Square);

// 2 - Från en URL:
builder.InsertImage(ImageUrl, RelativeHorizontalPosition.Margin, 100,
    RelativeVerticalPosition.Margin, 250, 200, 200, WrapType.Square);

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

Visar hur man infogar en bild från det lokala filsystemet i ett dokument samtidigt som dess dimensioner bevaras.

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

// InsertImage-metoden skapar en flytande form med den skickade bilden i dess bilddata.
// Vi kan ange dimensionerna av formen kan överföra dem till denna metod.
Shape imageShape = builder.InsertImage(ImageDir + "Logo.jpg", RelativeHorizontalPosition.Margin, 0,
    RelativeVerticalPosition.Margin, 0, -1, -1, WrapType.Square);

// Att skicka negativa värden som de avsedda dimensionerna kommer att definieras automatiskt
// Formens mått baserat på måtten på dess bild.
Assert.AreEqual(300.0d, imageShape.Width);
Assert.AreEqual(300.0d, imageShape.Height);

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

Visar hur man infogar en bild från det lokala filsystemet i ett dokument.

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

// Nedan finns tre sätt att infoga en bild från ett lokalt systemfilnamn.
// 1 - Inline form med en standardstorlek baserad på bildens ursprungliga mått:
builder.InsertImage(ImageDir + "Logo.jpg");

builder.InsertBreak(BreakType.PageBreak);

// 2 - Inline form med anpassade mått:
builder.InsertImage(ImageDir + "Transparent background logo.png", ConvertUtil.PixelToPoint(250),
    ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Flytande form med anpassade mått:
builder.InsertImage(ImageDir + "Windows MetaFile.wmf", RelativeHorizontalPosition.Margin, 100, 
    RelativeVerticalPosition.Margin, 100, 200, 100, WrapType.Square);

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

Se även


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

Infogar en bild från en ström vid angiven position och storlek.

public Shape InsertImage(Stream stream, RelativeHorizontalPosition horzPos, double left, 
    RelativeVerticalPosition vertPos, double top, double width, double height, WrapType wrapType)
ParameterTypBeskrivning
streamStreamStrömmen som innehåller bilden.
horzPosRelativeHorizontalPositionAnger varifrån avståndet till bilden mäts.
leftDoubleAvstånd i punkter från origo till vänster sida av bilden.
vertPosRelativeVerticalPositionAnger var avståndet till bilden mätt från.
topDoubleAvstånd i punkter från origo till bildens övre sida.
widthDoubleBildens bredd i punkter. Kan vara ett negativt eller noll värde för att begära 100 % skala.
heightDoubleBildens höjd i punkter. Kan vara ett negativt eller noll värde för att begära 100 % skala.
wrapTypeWrapTypeAnger hur text lindas runt bilden.

Returvärde

Bildnoden som precis infogades.

Anmärkningar

Du kan ändra bildstorlek, plats, positioneringsmetod och andra inställningar med hjälp av Shape objekt som returneras med denna metod.

Exempel

Visar hur man infogar en bild från en ström i ett dokument.

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

using (Stream stream = File.OpenRead(ImageDir + "Logo.jpg"))
{
    // Nedan finns tre sätt att infoga en bild från en ström.
    // 1 - Inline form med en standardstorlek baserad på bildens ursprungliga mått:
    builder.InsertImage(stream);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Inline form med anpassade mått:
    builder.InsertImage(stream, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Flytande form med anpassade mått:
    builder.InsertImage(stream, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
        100, 200, 100, WrapType.Square);
}

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

Se även


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

Infogar en bild från en byte-array vid angiven position och storlek.

public Shape InsertImage(byte[] imageBytes, RelativeHorizontalPosition horzPos, double left, 
    RelativeVerticalPosition vertPos, double top, double width, double height, WrapType wrapType)
ParameterTypBeskrivning
imageBytesByte[]Byte-arrayen som innehåller bilden.
horzPosRelativeHorizontalPositionAnger varifrån avståndet till bilden mäts.
leftDoubleAvstånd i punkter från origo till vänster sida av bilden.
vertPosRelativeVerticalPositionAnger var avståndet till bilden mätt från.
topDoubleAvstånd i punkter från origo till bildens övre sida.
widthDoubleBildens bredd i punkter. Kan vara ett negativt eller noll värde för att begära 100 % skala.
heightDoubleBildens höjd i punkter. Kan vara ett negativt eller noll värde för att begära 100 % skala.
wrapTypeWrapTypeAnger hur text lindas runt bilden.

Returvärde

Bildnoden som precis infogades.

Anmärkningar

Du kan ändra bildstorlek, plats, positioneringsmetod och andra inställningar med hjälp av Shape objekt som returneras med denna metod.

Exempel

Visar hur man infogar en bild från en byte-array i ett dokument.

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

    // Nedan finns tre sätt att infoga en bild från en byte-array.
    // 1 - Inline form med en standardstorlek baserad på bildens ursprungliga mått:
    builder.InsertImage(imageByteArray);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Inline form med anpassade mått:
    builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Flytande form med anpassade mått:
    builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin, 
    100, 200, 100, WrapType.Square);
}

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

Visar hur man infogar en bild från en byte-array i ett dokument (.NetStandard 2.0).

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

// Avkodning av bilden kommer att konvertera den till .png-formatet.
using (SKBitmap bitmap = SKBitmap.Decode(ImageDir + "Logo.jpg"))
{
    using (SKImage image = SKImage.FromBitmap(bitmap))
    {
        using (SKData data = image.Encode())
        {
            byte[] imageByteArray = data.ToArray();

            // Nedan finns tre sätt att infoga en bild från en byte-array.
            // 1 - Inline form med en standardstorlek baserad på bildens ursprungliga mått:
            builder.InsertImage(imageByteArray);

            builder.InsertBreak(BreakType.PageBreak);

            // 2 - Inline form med anpassade mått:
            builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

            builder.InsertBreak(BreakType.PageBreak);

            // 3 - Flytande form med anpassade mått:
            builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
                100, 200, 100, WrapType.Square);
        }
    }
}

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

Se även