ImageSize

ImageSize class

Contient des informations sur la taille et la résolution de l’image.

Pour en savoir plus, visitez leTravailler avec des images article de documentation.

public class ImageSize

Constructeurs

NomLa description
ImageSize(int, int)Initialise la largeur et la hauteur aux valeurs données en pixels. Initialise la résolution à 96 ppp.
ImageSize(int, int, double, double)Initialise la largeur, la hauteur et la résolution aux valeurs données.

Propriétés

NomLa description
HeightPixels { get; }Obtient la hauteur de l’image en pixels.
HeightPoints { get; }Récupère la hauteur de l’image en points. 1 point correspond à 1/72 pouce.
HorizontalResolution { get; }Obtient la résolution horizontale en DPI.
VerticalResolution { get; }Obtient la résolution verticale en DPI.
WidthPixels { get; }Obtient la largeur de l’image en pixels.
WidthPoints { get; }Obtient la largeur de l’image en points. 1 point correspond à 1/72 pouce.

Exemples

Montre comment redimensionner une forme avec une image.

// Lorsque nous insérons une image à l'aide de la méthode « InsertImage », le générateur met à l'échelle la forme qui affiche l'image de sorte que,
// lorsque nous visualisons le document en utilisant un zoom à 100 % dans Microsoft Word, la forme affiche l'image dans sa taille réelle.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertImage(ImageDir + "Logo.jpg");

// Une image 400x400 créera un objet ImageData avec une taille d'image de 300x300pt.
ImageSize imageSize = shape.ImageData.ImageSize;

Assert.AreEqual(300.0d, imageSize.WidthPoints);
Assert.AreEqual(300.0d, imageSize.HeightPoints);

// Si les dimensions d'une forme correspondent aux dimensions des données de l'image,
// alors la forme affiche l'image dans sa taille d'origine.
Assert.AreEqual(300.0d, shape.Width);
Assert.AreEqual(300.0d, shape.Height);

 // Réduisez la taille globale de la forme de 50 %.
shape.Width *= 0.5;

 // Les facteurs d'échelle s'appliquent à la fois à la largeur et à la hauteur pour préserver les proportions de la forme.
Assert.AreEqual(150.0d, shape.Width);
Assert.AreEqual(150.0d, shape.Height);

// Lorsque nous redimensionnons la forme, la taille des données de l'image reste la même.
Assert.AreEqual(300.0d, imageSize.WidthPoints);
Assert.AreEqual(300.0d, imageSize.HeightPoints);

// Nous pouvons référencer les dimensions des données d'image pour appliquer une mise à l'échelle basée sur la taille de l'image.
shape.Width = imageSize.WidthPoints * 1.1;

Assert.AreEqual(330.0d, shape.Width);
Assert.AreEqual(330.0d, shape.Height);

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

Voir également

ImageData Class ImageType Enum