InsertImage

InsertImage(Image)

Inserisce un’immagine da un .NETImage nel documento. L’immagine viene inserita in linea e in scala 100%.

public Shape InsertImage(Image image)

Parametro	Tipo	Descrizione
image	Image	L’immagine da inserire nel documento.

Valore di ritorno

Il nodo immagine appena inserito.

Osservazioni

Puoi modificare le dimensioni dell’immagine, la posizione, il metodo di posizionamento e altre impostazioni utilizzando Shape oggetto restituito da questo metodo.

Esempi

Mostra come inserire un’immagine da un oggetto in un documento.

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

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

// Di seguito sono riportati tre modi per inserire un'immagine da un'istanza dell'oggetto Image.
// 1 - Forma in linea con una dimensione predefinita basata sulle dimensioni originali dell'immagine:
builder.InsertImage(image);

builder.InsertBreak(BreakType.PageBreak);

// 2 - Forma in linea con dimensioni personalizzate:
builder.InsertImage(image, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Forma fluttuante con dimensioni personalizzate:
builder.InsertImage(image, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

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

Guarda anche

class Shape
class DocumentBuilder
spazio dei nomi Aspose.Words
assemblea Aspose.Words

InsertImage(string)

Inserisce un’immagine da un file o un URL nel documento. L’immagine viene inserita in linea e in scala 100%.

public Shape InsertImage(string fileName)

Parametro	Tipo	Descrizione
fileName	String	Il file con l’immagine. Può essere qualsiasi URI locale o remoto valido.

Valore di ritorno

Il nodo immagine appena inserito.

Osservazioni

Questo sovraccarico scaricherà automaticamente l’immagine prima di inserirla in document se specifichi un URI remoto.

Puoi modificare le dimensioni dell’immagine, la posizione, il metodo di posizionamento e altre impostazioni utilizzando Shape oggetto restituito da questo metodo.

Esempi

Mostra come inserire un’immagine GIF nel documento.

DocumentBuilder builder = new DocumentBuilder();

// Possiamo inserire un'immagine gif utilizzando il percorso o l'array di byte.
// Funziona solo se DocumentBuilder è ottimizzato per Word versione 2010 o successiva.
// Nota che l'accesso ai byte dell'immagine provoca la conversione da Gif a 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");

Mostra come inserire una forma con un’immagine in un documento.

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

// Di seguito sono riportate due posizioni in cui si trova il metodo "InsertShape" del generatore di documenti
// può generare l'immagine che verrà visualizzata dalla forma.
// 1 - Passa il nome file del file system locale di un file immagine:
builder.Write("Image from local file: ");
builder.InsertImage(ImageDir + "Logo.jpg");
builder.Writeln();

// 2 - Passa un URL che punta a un'immagine.
builder.Write("Image from a URL: ");
builder.InsertImage(ImageUrl);
builder.Writeln();

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

Mostra come inserire un’immagine mobile al centro di una pagina.

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

// Inserisci un'immagine mobile che apparirà dietro il testo sovrapposto e allineala al centro della pagina.
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");

Mostra come determinare quale immagine verrà inserita.

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

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

// Aspose.Words inserisce l'immagine SVG nel documento come PNG con estensione svgBlip
// che contiene la rappresentazione dell'immagine SVG vettoriale originale.
doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertSvgImage.SvgWithSvgBlip.docx");

// Aspose.Words inserisce l'immagine SVG nel documento come PNG, proprio come fa Microsoft Word per il vecchio formato.
doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertSvgImage.Svg.doc");

doc.CompatibilityOptions.OptimizeFor(MsWordVersion.Word2003);

// Aspose.Words inserisce l'immagine SVG nel documento come metafile EMF per mantenere l'immagine nella rappresentazione vettoriale.
doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertSvgImage.Emf.docx");

Mostra come inserire un’immagine dal file system locale in un documento.

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

// Di seguito sono riportati tre modi per inserire un'immagine da un nome file di sistema locale.
// 1 - Forma in linea con una dimensione predefinita basata sulle dimensioni originali dell'immagine:
builder.InsertImage(ImageDir + "Logo.jpg");

builder.InsertBreak(BreakType.PageBreak);

// 2 - Forma in linea con dimensioni personalizzate:
builder.InsertImage(ImageDir + "Transparent background logo.png", ConvertUtil.PixelToPoint(250),
    ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Forma fluttuante con dimensioni personalizzate:
builder.InsertImage(ImageDir + "Windows MetaFile.wmf", RelativeHorizontalPosition.Margin, 100, 
    RelativeVerticalPosition.Margin, 100, 200, 100, WrapType.Square);

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

Guarda anche

class Shape
class DocumentBuilder
spazio dei nomi Aspose.Words
assemblea Aspose.Words

InsertImage(Stream)

Inserisce un’immagine da uno stream nel documento. L’immagine viene inserita in linea e in scala 100%.

public Shape InsertImage(Stream stream)

Parametro	Tipo	Descrizione
stream	Stream	Lo stream che contiene l’immagine.

Valore di ritorno

Il nodo immagine appena inserito.

Osservazioni

Puoi modificare le dimensioni dell’immagine, la posizione, il metodo di posizionamento e altre impostazioni utilizzando Shape oggetto restituito da questo metodo.

Esempi

Mostra come inserire una forma con un’immagine da un flusso in un documento.

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

Mostra come inserire un’immagine da uno stream in un documento.

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

using (Stream stream = File.OpenRead(ImageDir + "Logo.jpg"))
{
    // Di seguito sono riportati tre modi per inserire un'immagine da uno stream.
    // 1 - Forma in linea con una dimensione predefinita basata sulle dimensioni originali dell'immagine:
    builder.InsertImage(stream);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Forma in linea con dimensioni personalizzate:
    builder.InsertImage(stream, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Forma fluttuante con dimensioni personalizzate:
    builder.InsertImage(stream, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
        100, 200, 100, WrapType.Square);
}

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

Guarda anche

class Shape
class DocumentBuilder
spazio dei nomi Aspose.Words
assemblea Aspose.Words

InsertImage(byte[])

Inserisce un’immagine da un array di byte nel documento. L’immagine viene inserita in linea e in scala 100%.

public Shape InsertImage(byte[] imageBytes)

Parametro	Tipo	Descrizione
imageBytes	Byte[]	La matrice di byte che contiene l’immagine.

Valore di ritorno

Il nodo immagine appena inserito.

Osservazioni

Puoi modificare le dimensioni dell’immagine, la posizione, il metodo di posizionamento e altre impostazioni utilizzando Shape oggetto restituito da questo metodo.

Esempi

Mostra come inserire un’immagine da un array di byte in un documento.

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

    // Di seguito sono riportati tre modi per inserire un'immagine da un array di byte.
    // 1 - Forma in linea con una dimensione predefinita basata sulle dimensioni originali dell'immagine:
    builder.InsertImage(imageByteArray);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Forma in linea con dimensioni personalizzate:
    builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Forma fluttuante con dimensioni personalizzate:
    builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin, 
    100, 200, 100, WrapType.Square);
}

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

Mostra come inserire un’immagine da un array di byte in un documento (.NetStandard 2.0).

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

// La decodifica dell'immagine la convertirà nel formato .png.
using (SKBitmap bitmap = SKBitmap.Decode(ImageDir + "Logo.jpg"))
{
    using (SKImage image = SKImage.FromBitmap(bitmap))
    {
        using (SKData data = image.Encode())
        {
            byte[] imageByteArray = data.ToArray();

            // Di seguito sono riportati tre modi per inserire un'immagine da un array di byte.
            // 1 - Forma in linea con una dimensione predefinita basata sulle dimensioni originali dell'immagine:
            builder.InsertImage(imageByteArray);

            builder.InsertBreak(BreakType.PageBreak);

            // 2 - Forma in linea con dimensioni personalizzate:
            builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

            builder.InsertBreak(BreakType.PageBreak);

            // 3 - Forma fluttuante con dimensioni personalizzate:
            builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
                100, 200, 100, WrapType.Square);
        }
    }
}

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

Guarda anche

class Shape
class DocumentBuilder
spazio dei nomi Aspose.Words
assemblea Aspose.Words

InsertImage(Image, double, double)

Inserisce un’immagine in linea da un .NETImage nel documento e lo ridimensiona alla dimensione specificata.

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

Parametro	Tipo	Descrizione
image	Image	L’immagine da inserire nel documento.
width	Double	La larghezza dell’immagine in punti. Può essere un valore negativo o zero per richiedere una scala del 100%.
height	Double	L’altezza dell’immagine in punti. Può essere un valore negativo o zero per richiedere una scala del 100%.

Valore di ritorno

Il nodo immagine appena inserito.

Osservazioni

Puoi modificare le dimensioni dell’immagine, la posizione, il metodo di posizionamento e altre impostazioni utilizzando Shape oggetto restituito da questo metodo.

Esempi

Mostra come inserire un’immagine da un oggetto in un documento.

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

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

// Di seguito sono riportati tre modi per inserire un'immagine da un'istanza dell'oggetto Image.
// 1 - Forma in linea con una dimensione predefinita basata sulle dimensioni originali dell'immagine:
builder.InsertImage(image);

builder.InsertBreak(BreakType.PageBreak);

// 2 - Forma in linea con dimensioni personalizzate:
builder.InsertImage(image, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Forma fluttuante con dimensioni personalizzate:
builder.InsertImage(image, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

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

Mostra come inserire un’immagine da un oggetto in un documento (.NetStandard 2.0).

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

// La decodifica dell'immagine la convertirà nel formato .png.
using (SKBitmap bitmap = SKBitmap.Decode(ImageDir + "Logo.jpg"))
{
    // Di seguito sono riportati tre modi per inserire un'immagine da un'istanza dell'oggetto Image.
    // 1 - Forma in linea con una dimensione predefinita basata sulle dimensioni originali dell'immagine:
    builder.InsertImage(bitmap);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Forma in linea con dimensioni personalizzate:
    builder.InsertImage(bitmap, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Forma fluttuante con dimensioni personalizzate:
    builder.InsertImage(bitmap, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
        100, 200, 100, WrapType.Square);
}

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

Guarda anche

class Shape
class DocumentBuilder
spazio dei nomi Aspose.Words
assemblea Aspose.Words

InsertImage(string, double, double)

Inserisce un’immagine in linea da un file o un URL nel documento e la ridimensiona alla dimensione specificata.

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

Parametro	Tipo	Descrizione
fileName	String	Il file che contiene l’immagine.
width	Double	La larghezza dell’immagine in punti. Può essere un valore negativo o zero per richiedere una scala del 100%.
height	Double	L’altezza dell’immagine in punti. Può essere un valore negativo o zero per richiedere una scala del 100%.

Valore di ritorno

Il nodo immagine appena inserito.

Osservazioni

Puoi modificare le dimensioni dell’immagine, la posizione, il metodo di posizionamento e altre impostazioni utilizzando Shape oggetto restituito da questo metodo.

Esempi

Mostra come inserire un’immagine dal file system locale in un documento.

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

// Di seguito sono riportati tre modi per inserire un'immagine da un nome file di sistema locale.
// 1 - Forma in linea con una dimensione predefinita basata sulle dimensioni originali dell'immagine:
builder.InsertImage(ImageDir + "Logo.jpg");

builder.InsertBreak(BreakType.PageBreak);

// 2 - Forma in linea con dimensioni personalizzate:
builder.InsertImage(ImageDir + "Transparent background logo.png", ConvertUtil.PixelToPoint(250),
    ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Forma fluttuante con dimensioni personalizzate:
builder.InsertImage(ImageDir + "Windows MetaFile.wmf", RelativeHorizontalPosition.Margin, 100, 
    RelativeVerticalPosition.Margin, 100, 200, 100, WrapType.Square);

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

Guarda anche

class Shape
class DocumentBuilder
spazio dei nomi Aspose.Words
assemblea Aspose.Words

InsertImage(Stream, double, double)

Inserisce un’immagine in linea da uno stream nel documento e la ridimensiona alla dimensione specificata.

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

Parametro	Tipo	Descrizione
stream	Stream	Il flusso che contiene l’immagine.
width	Double	La larghezza dell’immagine in punti. Può essere un valore negativo o zero per richiedere una scala del 100%.
height	Double	L’altezza dell’immagine in punti. Può essere un valore negativo o zero per richiedere una scala del 100%.

Valore di ritorno

Il nodo immagine appena inserito.

Osservazioni

Puoi modificare le dimensioni dell’immagine, la posizione, il metodo di posizionamento e altre impostazioni utilizzando Shape oggetto restituito da questo metodo.

Esempi

Mostra come inserire un’immagine da uno stream in un documento.

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

using (Stream stream = File.OpenRead(ImageDir + "Logo.jpg"))
{
    // Di seguito sono riportati tre modi per inserire un'immagine da uno stream.
    // 1 - Forma in linea con una dimensione predefinita basata sulle dimensioni originali dell'immagine:
    builder.InsertImage(stream);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Forma in linea con dimensioni personalizzate:
    builder.InsertImage(stream, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Forma fluttuante con dimensioni personalizzate:
    builder.InsertImage(stream, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
        100, 200, 100, WrapType.Square);
}

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

Guarda anche

class Shape
class DocumentBuilder
spazio dei nomi Aspose.Words
assemblea Aspose.Words

InsertImage(byte[], double, double)

Inserisce un’immagine in linea da un array di byte nel documento e la ridimensiona alla dimensione specificata.

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

Parametro	Tipo	Descrizione
imageBytes	Byte[]	La matrice di byte che contiene l’immagine.
width	Double	La larghezza dell’immagine in punti. Può essere un valore negativo o zero per richiedere una scala del 100%.
height	Double	L’altezza dell’immagine in punti. Può essere un valore negativo o zero per richiedere una scala del 100%.

Valore di ritorno

Il nodo immagine appena inserito.

Osservazioni

Puoi modificare le dimensioni dell’immagine, la posizione, il metodo di posizionamento e altre impostazioni utilizzando Shape oggetto restituito da questo metodo.

Esempi

Mostra come inserire un’immagine da un array di byte in un documento.

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

    // Di seguito sono riportati tre modi per inserire un'immagine da un array di byte.
    // 1 - Forma in linea con una dimensione predefinita basata sulle dimensioni originali dell'immagine:
    builder.InsertImage(imageByteArray);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Forma in linea con dimensioni personalizzate:
    builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Forma fluttuante con dimensioni personalizzate:
    builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin, 
    100, 200, 100, WrapType.Square);
}

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

Mostra come inserire un’immagine da un array di byte in un documento (.NetStandard 2.0).

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

// La decodifica dell'immagine la convertirà nel formato .png.
using (SKBitmap bitmap = SKBitmap.Decode(ImageDir + "Logo.jpg"))
{
    using (SKImage image = SKImage.FromBitmap(bitmap))
    {
        using (SKData data = image.Encode())
        {
            byte[] imageByteArray = data.ToArray();

            // Di seguito sono riportati tre modi per inserire un'immagine da un array di byte.
            // 1 - Forma in linea con una dimensione predefinita basata sulle dimensioni originali dell'immagine:
            builder.InsertImage(imageByteArray);

            builder.InsertBreak(BreakType.PageBreak);

            // 2 - Forma in linea con dimensioni personalizzate:
            builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

            builder.InsertBreak(BreakType.PageBreak);

            // 3 - Forma fluttuante con dimensioni personalizzate:
            builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
                100, 200, 100, WrapType.Square);
        }
    }
}

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

Guarda anche

class Shape
class DocumentBuilder
spazio dei nomi Aspose.Words
assemblea Aspose.Words

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

Inserisce un’immagine da un .NETImageOggetto nella posizione e dimensione specificate.

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

Parametro	Tipo	Descrizione
image	Image	L’immagine da inserire nel documento.
horzPos	RelativeHorizontalPosition	Specifica da dove viene misurata la distanza dall’immagine.
left	Double	Distanza in punti dall’origine al lato sinistro dell’immagine.
vertPos	RelativeVerticalPosition	Specifica da dove viene misurata la distanza dall’immagine.
top	Double	Distanza in punti dall’origine al lato superiore dell’immagine.
width	Double	La larghezza dell’immagine in punti. Può essere un valore negativo o zero per richiedere una scala del 100%.
height	Double	L’altezza dell’immagine in punti. Può essere un valore negativo o zero per richiedere una scala del 100%.
wrapType	WrapType	Specifica come disporre il testo attorno all’immagine.

Valore di ritorno

Il nodo immagine appena inserito.

Osservazioni

Puoi modificare le dimensioni dell’immagine, la posizione, il metodo di posizionamento e altre impostazioni utilizzando Shape oggetto restituito da questo metodo.

Esempi

Mostra come inserire un’immagine da un oggetto in un documento.

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

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

// Di seguito sono riportati tre modi per inserire un'immagine da un'istanza dell'oggetto Image.
// 1 - Forma in linea con una dimensione predefinita basata sulle dimensioni originali dell'immagine:
builder.InsertImage(image);

builder.InsertBreak(BreakType.PageBreak);

// 2 - Forma in linea con dimensioni personalizzate:
builder.InsertImage(image, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Forma fluttuante con dimensioni personalizzate:
builder.InsertImage(image, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

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

Mostra come inserire un’immagine da un oggetto in un documento (.NetStandard 2.0).

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

// La decodifica dell'immagine la convertirà nel formato .png.
using (SKBitmap bitmap = SKBitmap.Decode(ImageDir + "Logo.jpg"))
{
    // Di seguito sono riportati tre modi per inserire un'immagine da un'istanza dell'oggetto Image.
    // 1 - Forma in linea con una dimensione predefinita basata sulle dimensioni originali dell'immagine:
    builder.InsertImage(bitmap);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Forma in linea con dimensioni personalizzate:
    builder.InsertImage(bitmap, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Forma fluttuante con dimensioni personalizzate:
    builder.InsertImage(bitmap, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
        100, 200, 100, WrapType.Square);
}

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

Guarda anche

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

Inserisce un’immagine da un file o da un URL nella posizione e dimensione specificate.

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

Parametro	Tipo	Descrizione
fileName	String	Il file che contiene l’immagine.
horzPos	RelativeHorizontalPosition	Specifica da dove viene misurata la distanza dall’immagine.
left	Double	Distanza in punti dall’origine al lato sinistro dell’immagine.
vertPos	RelativeVerticalPosition	Specifica da dove viene misurata la distanza dall’immagine.
top	Double	Distanza in punti dall’origine al lato superiore dell’immagine.
width	Double	La larghezza dell’immagine in punti. Può essere un valore negativo o zero per richiedere una scala del 100%.
height	Double	L’altezza dell’immagine in punti. Può essere un valore negativo o zero per richiedere una scala del 100%.
wrapType	WrapType	Specifica come disporre il testo attorno all’immagine.

Valore di ritorno

Il nodo immagine appena inserito.

Osservazioni

Puoi modificare le dimensioni dell’immagine, la posizione, il metodo di posizionamento e altre impostazioni utilizzando Shape oggetto restituito da questo metodo.

Esempi

Mostra come inserire un’immagine.

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

// Esistono due modi per utilizzare un generatore di documenti per generare un'immagine e quindi inserirla come forma mobile.
// 1 - Da un file nel file system locale:
builder.InsertImage(ImageDir + "Transparent background logo.png", RelativeHorizontalPosition.Margin, 100,
    RelativeVerticalPosition.Margin, 0, 200, 200, WrapType.Square);

// 2 - Da un URL:
builder.InsertImage(ImageUrl, RelativeHorizontalPosition.Margin, 100,
    RelativeVerticalPosition.Margin, 250, 200, 200, WrapType.Square);

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

Mostra come inserire un’immagine dal file system locale in un documento preservandone le dimensioni.

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

// Il metodo InsertImage crea una forma mobile con l'immagine passata nei suoi dati immagine.
// Possiamo specificare le dimensioni della forma passandole a questo metodo.
Shape imageShape = builder.InsertImage(ImageDir + "Logo.jpg", RelativeHorizontalPosition.Margin, 0,
    RelativeVerticalPosition.Margin, 0, -1, -1, WrapType.Square);

// Il passaggio di valori negativi come dimensioni previste verrà definito automaticamente
// le dimensioni della forma in base alle dimensioni della sua immagine.
Assert.AreEqual(300.0d, imageShape.Width);
Assert.AreEqual(300.0d, imageShape.Height);

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

Mostra come inserire un’immagine dal file system locale in un documento.

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

// Di seguito sono riportati tre modi per inserire un'immagine da un nome file di sistema locale.
// 1 - Forma in linea con una dimensione predefinita basata sulle dimensioni originali dell'immagine:
builder.InsertImage(ImageDir + "Logo.jpg");

builder.InsertBreak(BreakType.PageBreak);

// 2 - Forma in linea con dimensioni personalizzate:
builder.InsertImage(ImageDir + "Transparent background logo.png", ConvertUtil.PixelToPoint(250),
    ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Forma fluttuante con dimensioni personalizzate:
builder.InsertImage(ImageDir + "Windows MetaFile.wmf", RelativeHorizontalPosition.Margin, 100, 
    RelativeVerticalPosition.Margin, 100, 200, 100, WrapType.Square);

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

Guarda anche

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

Inserisce un’immagine da uno stream nella posizione e dimensione specificate.

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

Parametro	Tipo	Descrizione
stream	Stream	Il flusso che contiene l’immagine.
horzPos	RelativeHorizontalPosition	Specifica da dove viene misurata la distanza dall’immagine.
left	Double	Distanza in punti dall’origine al lato sinistro dell’immagine.
vertPos	RelativeVerticalPosition	Specifica da dove viene misurata la distanza dall’immagine.
top	Double	Distanza in punti dall’origine al lato superiore dell’immagine.
width	Double	La larghezza dell’immagine in punti. Può essere un valore negativo o zero per richiedere una scala del 100%.
height	Double	L’altezza dell’immagine in punti. Può essere un valore negativo o zero per richiedere una scala del 100%.
wrapType	WrapType	Specifica come disporre il testo attorno all’immagine.

Valore di ritorno

Il nodo immagine appena inserito.

Osservazioni

Puoi modificare le dimensioni dell’immagine, la posizione, il metodo di posizionamento e altre impostazioni utilizzando Shape oggetto restituito da questo metodo.

Esempi

Mostra come inserire un’immagine da uno stream in un documento.

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

using (Stream stream = File.OpenRead(ImageDir + "Logo.jpg"))
{
    // Di seguito sono riportati tre modi per inserire un'immagine da uno stream.
    // 1 - Forma in linea con una dimensione predefinita basata sulle dimensioni originali dell'immagine:
    builder.InsertImage(stream);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Forma in linea con dimensioni personalizzate:
    builder.InsertImage(stream, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Forma fluttuante con dimensioni personalizzate:
    builder.InsertImage(stream, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
        100, 200, 100, WrapType.Square);
}

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

Guarda anche

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

Inserisce un’immagine da un array di byte nella posizione e dimensione specificate.

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

Parametro	Tipo	Descrizione
imageBytes	Byte[]	La matrice di byte che contiene l’immagine.
horzPos	RelativeHorizontalPosition	Specifica da dove viene misurata la distanza dall’immagine.
left	Double	Distanza in punti dall’origine al lato sinistro dell’immagine.
vertPos	RelativeVerticalPosition	Specifica da dove viene misurata la distanza dall’immagine.
top	Double	Distanza in punti dall’origine al lato superiore dell’immagine.
width	Double	La larghezza dell’immagine in punti. Può essere un valore negativo o zero per richiedere una scala del 100%.
height	Double	L’altezza dell’immagine in punti. Può essere un valore negativo o zero per richiedere una scala del 100%.
wrapType	WrapType	Specifica come disporre il testo attorno all’immagine.

Valore di ritorno

Il nodo immagine appena inserito.

Osservazioni

Puoi modificare le dimensioni dell’immagine, la posizione, il metodo di posizionamento e altre impostazioni utilizzando Shape oggetto restituito da questo metodo.

Esempi

Mostra come inserire un’immagine da un array di byte in un documento.

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

    // Di seguito sono riportati tre modi per inserire un'immagine da un array di byte.
    // 1 - Forma in linea con una dimensione predefinita basata sulle dimensioni originali dell'immagine:
    builder.InsertImage(imageByteArray);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Forma in linea con dimensioni personalizzate:
    builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Forma fluttuante con dimensioni personalizzate:
    builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin, 
    100, 200, 100, WrapType.Square);
}

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

Mostra come inserire un’immagine da un array di byte in un documento (.NetStandard 2.0).

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

// La decodifica dell'immagine la convertirà nel formato .png.
using (SKBitmap bitmap = SKBitmap.Decode(ImageDir + "Logo.jpg"))
{
    using (SKImage image = SKImage.FromBitmap(bitmap))
    {
        using (SKData data = image.Encode())
        {
            byte[] imageByteArray = data.ToArray();

            // Di seguito sono riportati tre modi per inserire un'immagine da un array di byte.
            // 1 - Forma in linea con una dimensione predefinita basata sulle dimensioni originali dell'immagine:
            builder.InsertImage(imageByteArray);

            builder.InsertBreak(BreakType.PageBreak);

            // 2 - Forma in linea con dimensioni personalizzate:
            builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

            builder.InsertBreak(BreakType.PageBreak);

            // 3 - Forma fluttuante con dimensioni personalizzate:
            builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
                100, 200, 100, WrapType.Square);
        }
    }
}

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

Guarda anche

DocumentBuilder.InsertHyperlink DocumentBuilder.InsertNode