ImageSize

ImageSize class

Contiene información sobre el tamaño y la resolución de la imagen.

Para obtener más información, visite elTrabajar con imágenes Artículo de documentación.

public class ImageSize

Constructores

NombreDescripción
ImageSize(int, int)Inicializa el ancho y la altura a los valores dados en píxeles. Inicializa la resolución a 96 ppp.
ImageSize(int, int, double, double)Inicializa el ancho, la altura y la resolución a los valores dados.

Propiedades

NombreDescripción
HeightPixels { get; }Obtiene la altura de la imagen en píxeles.
HeightPoints { get; }Obtiene la altura de la imagen en puntos. 1 punto equivale a 1/72 de pulgada.
HorizontalResolution { get; }Obtiene la resolución horizontal en DPI.
VerticalResolution { get; }Obtiene la resolución vertical en DPI.
WidthPixels { get; }Obtiene el ancho de la imagen en píxeles.
WidthPoints { get; }Obtiene el ancho de la imagen en puntos. 1 punto equivale a 1/72 de pulgada.

Ejemplos

Muestra cómo cambiar el tamaño de una forma con una imagen.

// Cuando insertamos una imagen usando el método "InsertImage", el constructor escala la forma que muestra la imagen de modo que,
// cuando vemos el documento usando el zoom del 100% en Microsoft Word, la forma muestra la imagen en su tamaño real.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertImage(ImageDir + "Logo.jpg");

// Una imagen de 400x400 creará un objeto ImageData con un tamaño de imagen de 300x300pt.
ImageSize imageSize = shape.ImageData.ImageSize;

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

// Si las dimensiones de una forma coinciden con las dimensiones de los datos de la imagen,
//Entonces la forma muestra la imagen en su tamaño original.
Assert.AreEqual(300.0d, shape.Width);
Assert.AreEqual(300.0d, shape.Height);

 // Reduce el tamaño general de la forma en un 50%.
shape.Width *= 0.5;

 // Los factores de escala se aplican tanto al ancho como a la altura al mismo tiempo para preservar las proporciones de la forma.
Assert.AreEqual(150.0d, shape.Width);
Assert.AreEqual(150.0d, shape.Height);

// Cuando cambiamos el tamaño de la forma, el tamaño de los datos de la imagen permanece igual.
Assert.AreEqual(300.0d, imageSize.WidthPoints);
Assert.AreEqual(300.0d, imageSize.HeightPoints);

//Podemos referenciar las dimensiones de los datos de la imagen para aplicar una escala en función del tamaño de la imagen.
shape.Width = imageSize.WidthPoints * 1.1;

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

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

Ver también