Image (Clase)
TOC
Collapse the table of content
Expand the table of content

Image (Clase)

Actualización: noviembre 2007

Representa un control que muestra una imagen.

Espacio de nombres:  System.Windows.Controls
Ensamblado:  PresentationFramework (en PresentationFramework.dll)
XMLNS para XAML: http://schemas.microsoft.com/winfx/xaml/presentation

[LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable)]
public class Image : FrameworkElement, IUriContext
/** @attribute LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable) */
public class Image extends FrameworkElement implements IUriContext
public class Image extends FrameworkElement implements IUriContext

La clase Image permite cargar los siguientes tipos de imagen: .bmp, .gif, .ico, .jpg, .png, .wdp y .tiff.

Cuando se muestra una imagen con varios marcos, sólo se muestra el primer marco. El control Image no admite animaciones de imágenes con varios marcos.

Hasta que se cargue el contenido de la imagen, las propiedades ActualWidth y ActualHeight del control se comportan como si fueran cero, dado que el contenido de la imagen se utiliza para determinar el tamaño final y la ubicación del control.

En controles de tamaño fijo, se pueden definir las propiedades Width y Height. Sin embargo, para conservar la relación de aspecto del elemento multimedia, establezca la propiedad Width o Height, pero no ambas.

En este ejemplo se muestra cómo incluir imágenes en una aplicación utilizando el elemento Image.

En el ejemplo siguiente se muestra cómo representar una imagen de 200 píxeles de ancho. En este ejemplo Lenguaje de marcado de aplicaciones extensible (XAML), se utilizan la sintaxis de atributo y la sintaxis de etiquetas de propiedad para definir la imagen. Para obtener más información sobre la sintaxis de atributo y la sintaxis de propiedad, consulte Información general sobre las propiedades de dependencia. BitmapImage se utiliza para definir los datos de origen de la imagen y se define explícitamente para el ejemplo de sintaxis de etiquetas de propiedad. Además, la propiedad DecodePixelWidth de BitmapImage se establece en el mismo ancho que la propiedad Width de Image. Esto se hace para asegurarse de utilizar la mínima cantidad de memoria para representar la imagen.

ms610982.alert_note(es-es,VS.90).gifNota:

En general, si desea especificar el tamaño de una imagen representada, especifique sólo Width o Height pero no ambas. Si sólo especifica una, se conserva la relación de aspecto de la imagen. De lo contrario, la imagen puede sufrir una expansión o distorsión inesperadas. Para controlar el comportamiento de expansión de la imagen, utilice las propiedades Stretch y StretchDirection.

ms610982.alert_note(es-es,VS.90).gifNota:

Cuando especifique el tamaño de una imagen con Width o Height, también debe establecer DecodePixelWidth o DecodePixelHeight en el mismo tamaño correspondiente.

La propiedad Stretch determina cómo se expande el origen de la imagen para rellenar el elemento de imagen. Para obtener más información, vea la enumeración Stretch.

<!-- Simple image rendering. However, rendering an image this way may not
     result in the best use of application memory. See markup below which
     creates the same end result but using less memory. -->
<Image Width="200" 
Source="C:\Documents and Settings\All Users\Documents\My Pictures\Sample Pictures\Water Lilies.jpg"/>

<Image Width="200">
  <Image.Source>
    <!-- To save significant application memory, set the DecodePixelWidth or  
     DecodePixelHeight of the BitmapImage value of the image source to the desired 
     height and width of the rendered image. If you don't do this, the application will 
     cache the image as though it were rendered as its normal size rather then just 
     the size that is displayed. -->
    <!-- Note: In order to preserve aspect ratio, only set either DecodePixelWidth
         or DecodePixelHeight but not both. -->
    <BitmapImage DecodePixelWidth="200"  
     UriSource="C:\Documents and Settings\All Users\Documents\My Pictures\Sample Pictures\Water Lilies.jpg" />
  </Image.Source>
</Image>


En el ejemplo siguiente se muestra cómo representar una imagen de 200 píxeles de ancho mediante código.

ms610982.alert_note(es-es,VS.90).gifNota:

El establecimiento de las propiedades BitmapImage se debe hacer dentro de un bloque de BeginInit y EndInit.

// Create Image Element
Image myImage = new Image();
myImage.Width = 200;

// Create source
BitmapImage myBitmapImage = new BitmapImage();

// BitmapImage.UriSource must be in a BeginInit/EndInit block
myBitmapImage.BeginInit();
myBitmapImage.UriSource = new Uri(@"C:\Documents and Settings\All Users\Documents\My Pictures\Sample Pictures\Water Lilies.jpg");

// To save significant application memory, set the DecodePixelWidth or  
// DecodePixelHeight of the BitmapImage value of the image source to the desired 
// height or width of the rendered image. If you don't do this, the application will 
// cache the image as though it were rendered as its normal size rather then just 
// the size that is displayed.
// Note: In order to preserve aspect ratio, set DecodePixelWidth
// or DecodePixelHeight but not both.
myBitmapImage.DecodePixelWidth = 200;
myBitmapImage.EndInit();
//set image source
myImage.Source = myBitmapImage;


Más código

Cómo: Recortar una imagenEn este ejemplo se muestra cómo recortar una imagen mediante CroppedBitmap.
Cómo: Girar una imagenEn este ejemplo se muestra cómo girar una imagen 90 grados utilizando una propiedad Rotation de BitmapImage.
Cómo: Convertir una imagen en escala de grisesEn este ejemplo se muestra cómo convertir una imagen en escala de grises utilizando FormatConvertedBitmap.
Cómo: Usar un dibujo como el origen de una imagenEn este ejemplo se muestra cómo utilizar un objeto Drawing como la propiedad Source de un control Image. Para mostrar Drawing con un control Image, utilice DrawingImage como propiedad Source del control Image y establezca la propiedad DrawingImage.Drawing del objeto DrawingImage en el dibujo que desea mostrar.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2016 Microsoft