InsertImage

InsertImage(Image)

Insère une image à partir d’un .NETImage Objet dans le document. L’image est insérée en ligne et à l’échelle 100 %.

public Shape InsertImage(Image image)

Paramètre	Taper	La description
image	Image	L’image à insérer dans le document.

Return_Value

Le nœud d’image qui vient d’être inséré.

Remarques

Vous pouvez modifier la taille de l’image, l’emplacement, la méthode de positionnement et d’autres paramètres à l’aide de Shape objet renvoyé par cette méthode.

Exemples

Montre comment insérer une image d’un objet dans un document.

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

string imageFile = ImageDir + "Logo.jpg";

// Vous trouverez ci-dessous trois manières d'insérer une image à partir d'une instance d'objet Image.
// 1 - Forme en ligne avec une taille par défaut basée sur les dimensions d'origine de l'image :
builder.InsertImage(imageFile);

builder.InsertBreak(BreakType.PageBreak);

// 2 - Forme en ligne avec dimensions personnalisées :
builder.InsertImage(imageFile, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Forme flottante aux dimensions personnalisées :
builder.InsertImage(imageFile, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

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

Voir également

• class Shape
• class DocumentBuilder
• espace de noms Aspose.Words
• Assemblée Aspose.Words

---

InsertImage(string)

Insère une image depuis un fichier ou une URL dans le document. L’image est insérée en ligne et à l’échelle 100 %.

public Shape InsertImage(string fileName)

Paramètre	Taper	La description
fileName	String	Le fichier contenant l’image. Il peut s’agir de n’importe quelle URI locale ou distante valide.

Return_Value

Le nœud d’image qui vient d’être inséré.

Remarques

Cette surcharge téléchargera automatiquement l’image avant de l’insérer dans le document si vous spécifiez un URI distant.

Vous pouvez modifier la taille de l’image, l’emplacement, la méthode de positionnement et d’autres paramètres à l’aide de Shape objet renvoyé par cette méthode.

Exemples

Montre comment insérer une image WebP.

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

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

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

Montre comment insérer une image gif dans le document.

DocumentBuilder builder = new DocumentBuilder();

// Nous pouvons insérer une image gif en utilisant un chemin ou un tableau d'octets.
// Cela ne fonctionne que si DocumentBuilder est optimisé pour la version Word 2010 ou supérieure.
// Notez que l'accès aux octets de l'image provoque la conversion du Gif en 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");

Montre comment insérer une forme avec une image dans un document.

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

// Vous trouverez ci-dessous deux emplacements où la méthode « InsertShape » du générateur de documents
// peut générer l'image que la forme affichera.
// 1 - Transmettez un nom de fichier de système de fichiers local d'un fichier image :
builder.Write("Image from local file: ");
builder.InsertImage(ImageDir + "Logo.jpg");
builder.Writeln();

// 2 - Passez une URL qui pointe vers une image.
builder.Write("Image from a URL: ");
builder.InsertImage(ImageUrl);
builder.Writeln();

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

Montre comment insérer une image flottante au centre d’une page.

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

// Insérez une image flottante qui apparaîtra derrière le texte superposé et alignez-la au centre de la page.
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");

Montre comment déterminer quelle image sera insérée.

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

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

// Aspose.Words insère une image SVG dans le document au format PNG avec l'extension svgBlip
// qui contient la représentation de l'image vectorielle SVG d'origine.
doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertSvgImage.SvgWithSvgBlip.docx");

// Aspose.Words insère une image SVG dans le document au format PNG, tout comme le fait Microsoft Word pour l'ancien format.
doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertSvgImage.Svg.doc");

doc.CompatibilityOptions.OptimizeFor(MsWordVersion.Word2003);

// Aspose.Words insère une image SVG dans le document en tant que métafichier EMF pour conserver l'image en représentation vectorielle.
doc.Save(ArtifactsDir + "DocumentBuilderImages.InsertSvgImage.Emf.docx");

Montre comment insérer une image du système de fichiers local dans un document.

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

// Vous trouverez ci-dessous trois manières d'insérer une image à partir d'un nom de fichier système local.
// 1 - Forme en ligne avec une taille par défaut basée sur les dimensions d'origine de l'image :
builder.InsertImage(ImageDir + "Logo.jpg");

builder.InsertBreak(BreakType.PageBreak);

// 2 - Forme en ligne avec dimensions personnalisées :
builder.InsertImage(ImageDir + "Transparent background logo.png", ConvertUtil.PixelToPoint(250),
    ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Forme flottante aux dimensions personnalisées :
builder.InsertImage(ImageDir + "Windows MetaFile.wmf", RelativeHorizontalPosition.Margin, 100, 
    RelativeVerticalPosition.Margin, 100, 200, 100, WrapType.Square);

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

Voir également

• class Shape
• class DocumentBuilder
• espace de noms Aspose.Words
• Assemblée Aspose.Words

---

InsertImage(Stream)

Insère une image d’un flux dans le document. L’image est insérée en ligne et à l’échelle 100 %.

public Shape InsertImage(Stream stream)

Paramètre	Taper	La description
stream	Stream	Le flux qui contient l’image.

Return_Value

Le nœud d’image qui vient d’être inséré.

Remarques

Vous pouvez modifier la taille de l’image, l’emplacement, la méthode de positionnement et d’autres paramètres à l’aide de Shape objet renvoyé par cette méthode.

Exemples

Montre comment insérer une forme avec une image à partir d’un flux dans un document.

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

Montre comment insérer une image d’un flux dans un document.

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

using (Stream stream = File.OpenRead(ImageDir + "Logo.jpg"))
{
    // Vous trouverez ci-dessous trois manières d’insérer une image à partir d’un flux.
    // 1 - Forme en ligne avec une taille par défaut basée sur les dimensions d'origine de l'image :
    builder.InsertImage(stream);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Forme en ligne avec dimensions personnalisées :
    builder.InsertImage(stream, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Forme flottante aux dimensions personnalisées :
    builder.InsertImage(stream, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
        100, 200, 100, WrapType.Square);
}

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

Voir également

• class Shape
• class DocumentBuilder
• espace de noms Aspose.Words
• Assemblée Aspose.Words

---

InsertImage(byte[])

Insère une image d’un tableau d’octets dans le document. L’image est insérée en ligne et à l’échelle 100 %.

public Shape InsertImage(byte[] imageBytes)

Paramètre	Taper	La description
imageBytes	Byte[]	Le tableau d’octets qui contient l’image.

Return_Value

Le nœud d’image qui vient d’être inséré.

Remarques

Vous pouvez modifier la taille de l’image, l’emplacement, la méthode de positionnement et d’autres paramètres à l’aide de Shape objet renvoyé par cette méthode.

Exemples

Montre comment insérer une image à partir d’un tableau d’octets dans un document.

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

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

// Vous trouverez ci-dessous trois manières d’insérer une image à partir d’un tableau d’octets.
// 1 - Forme en ligne avec une taille par défaut basée sur les dimensions d'origine de l'image :
builder.InsertImage(imageByteArray);

builder.InsertBreak(BreakType.PageBreak);

// 2 - Forme en ligne avec dimensions personnalisées :
builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Forme flottante aux dimensions personnalisées :
builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

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

Voir également

• class Shape
• class DocumentBuilder
• espace de noms Aspose.Words
• Assemblée Aspose.Words

---

InsertImage(Image, double, double)

Insère une image en ligne à partir d’un .NETImage objet dans le document et le met à l’échelle à la taille spécifiée.

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

Paramètre	Taper	La description
image	Image	L’image à insérer dans le document.
width	Double	Largeur de l’image en points. Cette valeur peut être négative ou nulle pour une échelle de 100 %.
height	Double	Hauteur de l’image en points. Cette valeur peut être négative ou nulle pour une échelle de 100 %.

Return_Value

Le nœud d’image qui vient d’être inséré.

Remarques

Vous pouvez modifier la taille de l’image, l’emplacement, la méthode de positionnement et d’autres paramètres à l’aide de Shape objet renvoyé par cette méthode.

Exemples

Montre comment insérer une image d’un objet dans un document.

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

string imageFile = ImageDir + "Logo.jpg";

// Vous trouverez ci-dessous trois manières d'insérer une image à partir d'une instance d'objet Image.
// 1 - Forme en ligne avec une taille par défaut basée sur les dimensions d'origine de l'image :
builder.InsertImage(imageFile);

builder.InsertBreak(BreakType.PageBreak);

// 2 - Forme en ligne avec dimensions personnalisées :
builder.InsertImage(imageFile, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Forme flottante aux dimensions personnalisées :
builder.InsertImage(imageFile, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

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

Voir également

• class Shape
• class DocumentBuilder
• espace de noms Aspose.Words
• Assemblée Aspose.Words

---

InsertImage(string, double, double)

Insère une image en ligne à partir d’un fichier ou d’une URL dans le document et la met à l’échelle à la taille spécifiée.

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

Paramètre	Taper	La description
fileName	String	Le fichier qui contient l’image.
width	Double	Largeur de l’image en points. Cette valeur peut être négative ou nulle pour une échelle de 100 %.
height	Double	Hauteur de l’image en points. Cette valeur peut être négative ou nulle pour une échelle de 100 %.

Return_Value

Le nœud d’image qui vient d’être inséré.

Remarques

Vous pouvez modifier la taille de l’image, l’emplacement, la méthode de positionnement et d’autres paramètres à l’aide de Shape objet renvoyé par cette méthode.

Exemples

Montre comment insérer une image du système de fichiers local dans un document.

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

// Vous trouverez ci-dessous trois manières d'insérer une image à partir d'un nom de fichier système local.
// 1 - Forme en ligne avec une taille par défaut basée sur les dimensions d'origine de l'image :
builder.InsertImage(ImageDir + "Logo.jpg");

builder.InsertBreak(BreakType.PageBreak);

// 2 - Forme en ligne avec dimensions personnalisées :
builder.InsertImage(ImageDir + "Transparent background logo.png", ConvertUtil.PixelToPoint(250),
    ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Forme flottante aux dimensions personnalisées :
builder.InsertImage(ImageDir + "Windows MetaFile.wmf", RelativeHorizontalPosition.Margin, 100, 
    RelativeVerticalPosition.Margin, 100, 200, 100, WrapType.Square);

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

Voir également

• class Shape
• class DocumentBuilder
• espace de noms Aspose.Words
• Assemblée Aspose.Words

---

InsertImage(Stream, double, double)

Insère une image en ligne à partir d’un flux dans le document et la met à l’échelle à la taille spécifiée.

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

Paramètre	Taper	La description
stream	Stream	Le flux qui contient l’image.
width	Double	Largeur de l’image en points. Cette valeur peut être négative ou nulle pour une échelle de 100 %.
height	Double	Hauteur de l’image en points. Cette valeur peut être négative ou nulle pour une échelle de 100 %.

Return_Value

Le nœud d’image qui vient d’être inséré.

Remarques

Vous pouvez modifier la taille de l’image, l’emplacement, la méthode de positionnement et d’autres paramètres à l’aide de Shape objet renvoyé par cette méthode.

Exemples

Montre comment insérer une image d’un flux dans un document.

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

using (Stream stream = File.OpenRead(ImageDir + "Logo.jpg"))
{
    // Vous trouverez ci-dessous trois manières d’insérer une image à partir d’un flux.
    // 1 - Forme en ligne avec une taille par défaut basée sur les dimensions d'origine de l'image :
    builder.InsertImage(stream);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Forme en ligne avec dimensions personnalisées :
    builder.InsertImage(stream, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Forme flottante aux dimensions personnalisées :
    builder.InsertImage(stream, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
        100, 200, 100, WrapType.Square);
}

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

Voir également

• class Shape
• class DocumentBuilder
• espace de noms Aspose.Words
• Assemblée Aspose.Words

---

InsertImage(byte[], double, double)

Insère une image en ligne à partir d’un tableau d’octets dans le document et la met à l’échelle à la taille spécifiée.

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

Paramètre	Taper	La description
imageBytes	Byte[]	Le tableau d’octets qui contient l’image.
width	Double	Largeur de l’image en points. Cette valeur peut être négative ou nulle pour une échelle de 100 %.
height	Double	Hauteur de l’image en points. Cette valeur peut être négative ou nulle pour une échelle de 100 %.

Return_Value

Le nœud d’image qui vient d’être inséré.

Remarques

Vous pouvez modifier la taille de l’image, l’emplacement, la méthode de positionnement et d’autres paramètres à l’aide de Shape objet renvoyé par cette méthode.

Exemples

Montre comment insérer une image à partir d’un tableau d’octets dans un document.

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

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

// Vous trouverez ci-dessous trois manières d’insérer une image à partir d’un tableau d’octets.
// 1 - Forme en ligne avec une taille par défaut basée sur les dimensions d'origine de l'image :
builder.InsertImage(imageByteArray);

builder.InsertBreak(BreakType.PageBreak);

// 2 - Forme en ligne avec dimensions personnalisées :
builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Forme flottante aux dimensions personnalisées :
builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

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

Voir également

• class Shape
• class DocumentBuilder
• espace de noms Aspose.Words
• Assemblée Aspose.Words

---

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

Insère une image à partir d’un .NETImage objet à la position et à la taille spécifiées.

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

Paramètre	Taper	La description
image	Image	L’image à insérer dans le document.
horzPos	RelativeHorizontalPosition	Spécifie l’endroit à partir duquel la distance par rapport à l’image est mesurée.
left	Double	Distance en points de l’origine au côté gauche de l’image.
vertPos	RelativeVerticalPosition	Spécifie d’où la distance par rapport à l’image est mesurée.
top	Double	Distance en points de l’origine au côté supérieur de l’image.
width	Double	Largeur de l’image en points. Cette valeur peut être négative ou nulle pour une échelle de 100 %.
height	Double	Hauteur de l’image en points. Cette valeur peut être négative ou nulle pour une échelle de 100 %.
wrapType	WrapType	Spécifie comment envelopper le texte autour de l’image.

Return_Value

Le nœud d’image qui vient d’être inséré.

Remarques

Vous pouvez modifier la taille de l’image, l’emplacement, la méthode de positionnement et d’autres paramètres à l’aide de Shape objet renvoyé par cette méthode.

Exemples

Montre comment insérer une image d’un objet dans un document.

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

string imageFile = ImageDir + "Logo.jpg";

// Vous trouverez ci-dessous trois manières d'insérer une image à partir d'une instance d'objet Image.
// 1 - Forme en ligne avec une taille par défaut basée sur les dimensions d'origine de l'image :
builder.InsertImage(imageFile);

builder.InsertBreak(BreakType.PageBreak);

// 2 - Forme en ligne avec dimensions personnalisées :
builder.InsertImage(imageFile, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Forme flottante aux dimensions personnalisées :
builder.InsertImage(imageFile, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

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

Voir également

• class Shape
• enum RelativeHorizontalPosition
• enum RelativeVerticalPosition
• enum WrapType
• class DocumentBuilder
• espace de noms Aspose.Words
• Assemblée Aspose.Words

---

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

Insère une image à partir d’un fichier ou d’une URL à la position et à la taille spécifiées.

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

Paramètre	Taper	La description
fileName	String	Le fichier qui contient l’image.
horzPos	RelativeHorizontalPosition	Spécifie l’endroit à partir duquel la distance par rapport à l’image est mesurée.
left	Double	Distance en points de l’origine au côté gauche de l’image.
vertPos	RelativeVerticalPosition	Spécifie d’où la distance par rapport à l’image est mesurée.
top	Double	Distance en points de l’origine au côté supérieur de l’image.
width	Double	Largeur de l’image en points. Cette valeur peut être négative ou nulle pour une échelle de 100 %.
height	Double	Hauteur de l’image en points. Cette valeur peut être négative ou nulle pour une échelle de 100 %.
wrapType	WrapType	Spécifie comment envelopper le texte autour de l’image.

Return_Value

Le nœud d’image qui vient d’être inséré.

Remarques

Vous pouvez modifier la taille de l’image, l’emplacement, la méthode de positionnement et d’autres paramètres à l’aide de Shape objet renvoyé par cette méthode.

Exemples

Montre comment insérer une image.

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

// Il existe deux manières d'utiliser un générateur de documents pour rechercher une image, puis l'insérer sous forme de forme flottante.
// 1 - À partir d'un fichier du système de fichiers local :
builder.InsertImage(ImageDir + "Transparent background logo.png", RelativeHorizontalPosition.Margin, 100,
    RelativeVerticalPosition.Margin, 0, 200, 200, WrapType.Square);

// 2 - À partir d'une URL :
builder.InsertImage(ImageUrl, RelativeHorizontalPosition.Margin, 100,
    RelativeVerticalPosition.Margin, 250, 200, 200, WrapType.Square);

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

Montre comment insérer une image du système de fichiers local dans un document tout en préservant ses dimensions.

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

// La méthode InsertImage crée une forme flottante avec l'image transmise dans ses données d'image.
// Nous pouvons spécifier les dimensions de la forme en les transmettant à cette méthode.
Shape imageShape = builder.InsertImage(ImageDir + "Logo.jpg", RelativeHorizontalPosition.Margin, 0,
    RelativeVerticalPosition.Margin, 0, -1, -1, WrapType.Square);

// Le passage de valeurs négatives comme dimensions prévues définira automatiquement
// les dimensions de la forme en fonction des dimensions de son image.
Assert.AreEqual(300.0d, imageShape.Width);
Assert.AreEqual(300.0d, imageShape.Height);

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

Montre comment insérer une image du système de fichiers local dans un document.

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

// Vous trouverez ci-dessous trois manières d'insérer une image à partir d'un nom de fichier système local.
// 1 - Forme en ligne avec une taille par défaut basée sur les dimensions d'origine de l'image :
builder.InsertImage(ImageDir + "Logo.jpg");

builder.InsertBreak(BreakType.PageBreak);

// 2 - Forme en ligne avec dimensions personnalisées :
builder.InsertImage(ImageDir + "Transparent background logo.png", ConvertUtil.PixelToPoint(250),
    ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Forme flottante aux dimensions personnalisées :
builder.InsertImage(ImageDir + "Windows MetaFile.wmf", RelativeHorizontalPosition.Margin, 100, 
    RelativeVerticalPosition.Margin, 100, 200, 100, WrapType.Square);

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

Voir également

• class Shape
• enum RelativeHorizontalPosition
• enum RelativeVerticalPosition
• enum WrapType
• class DocumentBuilder
• espace de noms Aspose.Words
• Assemblée Aspose.Words

---

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

Insère une image à partir d’un flux à la position et à la taille spécifiées.

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

Paramètre	Taper	La description
stream	Stream	Le flux qui contient l’image.
horzPos	RelativeHorizontalPosition	Spécifie l’endroit à partir duquel la distance par rapport à l’image est mesurée.
left	Double	Distance en points de l’origine au côté gauche de l’image.
vertPos	RelativeVerticalPosition	Spécifie d’où la distance par rapport à l’image est mesurée.
top	Double	Distance en points de l’origine au côté supérieur de l’image.
width	Double	Largeur de l’image en points. Cette valeur peut être négative ou nulle pour une échelle de 100 %.
height	Double	Hauteur de l’image en points. Cette valeur peut être négative ou nulle pour une échelle de 100 %.
wrapType	WrapType	Spécifie comment envelopper le texte autour de l’image.

Return_Value

Le nœud d’image qui vient d’être inséré.

Remarques

Vous pouvez modifier la taille de l’image, l’emplacement, la méthode de positionnement et d’autres paramètres à l’aide de Shape objet renvoyé par cette méthode.

Exemples

Montre comment insérer une image d’un flux dans un document.

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

using (Stream stream = File.OpenRead(ImageDir + "Logo.jpg"))
{
    // Vous trouverez ci-dessous trois manières d’insérer une image à partir d’un flux.
    // 1 - Forme en ligne avec une taille par défaut basée sur les dimensions d'origine de l'image :
    builder.InsertImage(stream);

    builder.InsertBreak(BreakType.PageBreak);

    // 2 - Forme en ligne avec dimensions personnalisées :
    builder.InsertImage(stream, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

    builder.InsertBreak(BreakType.PageBreak);

    // 3 - Forme flottante aux dimensions personnalisées :
    builder.InsertImage(stream, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
        100, 200, 100, WrapType.Square);
}

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

Voir également

• class Shape
• enum RelativeHorizontalPosition
• enum RelativeVerticalPosition
• enum WrapType
• class DocumentBuilder
• espace de noms Aspose.Words
• Assemblée Aspose.Words

---

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

Insère une image à partir d’un tableau d’octets à la position et à la taille spécifiées.

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

Paramètre	Taper	La description
imageBytes	Byte[]	Le tableau d’octets qui contient l’image.
horzPos	RelativeHorizontalPosition	Spécifie l’endroit à partir duquel la distance par rapport à l’image est mesurée.
left	Double	Distance en points de l’origine au côté gauche de l’image.
vertPos	RelativeVerticalPosition	Spécifie d’où la distance par rapport à l’image est mesurée.
top	Double	Distance en points de l’origine au côté supérieur de l’image.
width	Double	Largeur de l’image en points. Cette valeur peut être négative ou nulle pour une échelle de 100 %.
height	Double	Hauteur de l’image en points. Cette valeur peut être négative ou nulle pour une échelle de 100 %.
wrapType	WrapType	Spécifie comment envelopper le texte autour de l’image.

Return_Value

Le nœud d’image qui vient d’être inséré.

Remarques

Vous pouvez modifier la taille de l’image, l’emplacement, la méthode de positionnement et d’autres paramètres à l’aide de Shape objet renvoyé par cette méthode.

Exemples

Montre comment insérer une image à partir d’un tableau d’octets dans un document.

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

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

// Vous trouverez ci-dessous trois manières d’insérer une image à partir d’un tableau d’octets.
// 1 - Forme en ligne avec une taille par défaut basée sur les dimensions d'origine de l'image :
builder.InsertImage(imageByteArray);

builder.InsertBreak(BreakType.PageBreak);

// 2 - Forme en ligne avec dimensions personnalisées :
builder.InsertImage(imageByteArray, ConvertUtil.PixelToPoint(250), ConvertUtil.PixelToPoint(144));

builder.InsertBreak(BreakType.PageBreak);

// 3 - Forme flottante aux dimensions personnalisées :
builder.InsertImage(imageByteArray, RelativeHorizontalPosition.Margin, 100, RelativeVerticalPosition.Margin,
100, 200, 100, WrapType.Square);

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

Voir également

• class Shape
• enum RelativeHorizontalPosition
• enum RelativeVerticalPosition
• enum WrapType
• class DocumentBuilder
• espace de noms Aspose.Words
• Assemblée Aspose.Words