Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase BitmapSource

 

Publicado: septiembre de 2016

Representa un solo conjunto constante de píxeles con un tamaño y resolución determinados.

Espacio de nombres:   System.Windows.Media.Imaging
Ensamblado:  PresentationCore (en PresentationCore.dll)

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Freezable
        System.Windows.Media.Animation.Animatable
          System.Windows.Media.ImageSource
            System.Windows.Media.Imaging.BitmapSource
              System.Windows.Interop.InteropBitmap
              System.Windows.Media.Imaging.BitmapFrame
              System.Windows.Media.Imaging.BitmapImage
              System.Windows.Media.Imaging.CachedBitmap
              System.Windows.Media.Imaging.ColorConvertedBitmap
              System.Windows.Media.Imaging.CroppedBitmap
              System.Windows.Media.Imaging.FormatConvertedBitmap
              System.Windows.Media.Imaging.RenderTargetBitmap
              System.Windows.Media.Imaging.TransformedBitmap
              System.Windows.Media.Imaging.WriteableBitmap

[LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable)]
public abstract class BitmapSource : ImageSource

NombreDescripción
System_CAPS_protmethodBitmapSource()

Inicializa una nueva instancia de la clase BitmapSource.

NombreDescripción
System_CAPS_pubpropertyCanFreeze

Obtiene un valor que indica si el objeto se puede convertir en no modificable.(Heredado de Freezable).

System_CAPS_pubpropertyDependencyObjectType

Obtiene el DependencyObjectType que ajusta el CLR tipo de esta instancia. (Heredado de DependencyObject).

System_CAPS_pubpropertyDispatcher

Obtiene el Dispatcher Esto DispatcherObject está asociado.(Heredado de DispatcherObject).

System_CAPS_pubpropertyDpiX

Obtiene la horizontal puntos por pulgada (dpi) de la imagen. 

System_CAPS_pubpropertyDpiY

Obtiene la vertical puntos por pulgada (dpi) de la imagen. 

System_CAPS_pubpropertyFormat

Obtiene el nativo PixelFormat de los datos de mapa de bits.

System_CAPS_pubpropertyHasAnimatedProperties

Obtiene un valor que indica si uno o más AnimationClock objetos está asociada con cualquiera de las propiedades de dependencia de este objeto.(Heredado de Animatable).

System_CAPS_pubpropertyHeight

Obtiene el alto del mapa de bits de origen en unidades independientes de dispositivo (1/96 de pulgada por unidad). (Invalida ImageSource.Height).

System_CAPS_pubpropertyIsDownloading

Obtiene un valor que indica si la BitmapSource contenido está descargando actualmente.

System_CAPS_pubpropertyIsFrozen

Obtiene un valor que indica si el objeto se puede modificar actualmente.(Heredado de Freezable).

System_CAPS_pubpropertyIsSealed

Obtiene un valor que indica si esta instancia está actualmente sellada (sólo lectura).(Heredado de DependencyObject).

System_CAPS_pubpropertyMetadata

Obtiene los metadatos que están asociados a esta imagen de mapa de bits.(Invalida ImageSource.Metadata).

System_CAPS_pubpropertyPalette

Obtiene la paleta de colores del mapa de bits, si se especifica uno.

System_CAPS_pubpropertyPixelHeight

Obtiene el alto del mapa de bits en píxeles.

System_CAPS_pubpropertyPixelWidth

Obtiene el ancho del mapa de bits en píxeles.

System_CAPS_pubpropertyWidth

Obtiene el ancho del mapa de bits en unidades independientes de dispositivo (1/96 de pulgada por unidad). (Invalida ImageSource.Width).

NombreDescripción
System_CAPS_pubmethodApplyAnimationClock(DependencyProperty, AnimationClock)

Se aplica AnimationClock al valor de DependencyProperty especificado. Si la propiedad ya está animada, se usa el comportamiento de entrega SnapshotAndReplace.(Heredado de Animatable).

System_CAPS_pubmethodApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Se aplica AnimationClock al valor de DependencyProperty especificado. Si la propiedad ya está animada, especificado HandoffBehavior se utiliza.(Heredado de Animatable).

System_CAPS_pubmethodBeginAnimation(DependencyProperty, AnimationTimeline)

Aplica una animación a la DependencyProperty especificada. La animación se inicia al representar el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el comportamiento de entrega SnapshotAndReplace.(Heredado de Animatable).

System_CAPS_pubmethodBeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Aplica una animación a la DependencyProperty especificada. La animación se inicia al representar el siguiente fotograma. Si la propiedad especificada ya está animada, especificado HandoffBehavior se utiliza.(Heredado de Animatable).

System_CAPS_pubmethodCheckAccess()

Determina si el subproceso de llamada tiene acceso a este DispatcherObject.(Heredado de DispatcherObject).

System_CAPS_protmethodCheckIfSiteOfOrigin()

Comprueba si el contenido de origen del mapa de bits es de un sitio de origen conocido. Este método se utiliza para asegurarse de que las operaciones de copia son seguras.

System_CAPS_pubmethodClearValue(DependencyProperty)

Borra el valor local de una propiedad. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty.(Heredado de DependencyObject).

System_CAPS_pubmethodClearValue(DependencyPropertyKey)

Borra el valor local de una propiedad de sólo lectura. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey.(Heredado de DependencyObject).

System_CAPS_pubmethodClone()

Crea un clon modificable de este BitmapSource y hace copias en profundidad de los valores de este objeto. Cuando se copian propiedades de dependencia, este método copia las referencias de recursos y enlaces de datos (aunque podrían no resolverse), pero no copia las animaciones ni sus valores actuales.

System_CAPS_protmethodCloneCore(Freezable)

Convierte esta instancia en una copia en profundidad del objeto BitmapSource. Cuando se copian propiedades de dependencia, este método copia las referencias de recursos y enlaces de datos (aunque podrían no resolverse), pero no copia las animaciones ni sus valores actuales.(Invalida Freezable.CloneCore(Freezable)).

System_CAPS_pubmethodCloneCurrentValue()

Crea un clon modificable de este objeto BitmapSource y hace copias en profundidad de sus valores actuales. Las referencias de recursos, los enlaces de datos y las animaciones no se copian, pero sí sus valores actuales.

System_CAPS_protmethodCloneCurrentValueCore(Freezable)

Convierte esta instancia en una copia en profundidad modificable del elemento BitmapSource especificado mediante los valores de propiedad actuales. Las referencias de recursos, los enlaces de datos y las animaciones no se copian, pero sí sus valores actuales.(Invalida Freezable.CloneCurrentValueCore(Freezable)).

System_CAPS_pubmethodCoerceValue(DependencyProperty)

Convierte el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier función CoerceValueCallback especificada en los metadatos de la propiedad de dependencia tal como existe en la clase DependencyObject que llama.(Heredado de DependencyObject).

System_CAPS_pubmethodCopyPixels(Array, Int32, Int32)

Copia los datos de píxeles del mapa de bits en una matriz de píxeles con el intervalo especificado, comenzando en el desplazamiento especificado.

System_CAPS_pubmethodCopyPixels(Int32Rect, Array, Int32, Int32)

Copia los datos de píxel del mapa de bits dentro del rectángulo especificado en una matriz de píxeles que tiene el intervalo especificado, comenzando en el desplazamiento especificado.

System_CAPS_pubmethodCopyPixels(Int32Rect, IntPtr, Int32, Int32)

Copia los datos de píxel del mapa de bits dentro del rectángulo especificado

System_CAPS_pubmethodSystem_CAPS_staticCreate(Int32, Int32, Double, Double, PixelFormat, BitmapPalette, Array, Int32)

Crea un nuevo BitmapSource de una matriz de píxeles.

System_CAPS_pubmethodSystem_CAPS_staticCreate(Int32, Int32, Double, Double, PixelFormat, BitmapPalette, IntPtr, Int32, Int32)

Crea un nuevo BitmapSource de una matriz de píxeles que se almacenan en memoria no administrada.

System_CAPS_protmethodCreateInstance()

Inicializa una nueva instancia de la clase Freezable.(Heredado de Freezable).

System_CAPS_protmethodCreateInstanceCore()

Cuando se implementa en una clase derivada, crea una nueva instancia de la Freezable clase derivada.(Heredado de Freezable).

System_CAPS_pubmethodEquals(Object)

Determina si un proporcionado DependencyObject es equivalente a la actual DependencyObject.(Heredado de DependencyObject).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodFreeze()

Convierte el objeto actual en no modificable y establece su propiedad IsFrozen en true.(Heredado de Freezable).

System_CAPS_protmethodFreezeCore(Boolean)

Crea una instancia de BitmapSource o una clase derivada inmutable.(Invalida Animatable.FreezeCore(Boolean)).

System_CAPS_pubmethodGetAnimationBaseValue(DependencyProperty)

Devuelve el valor no animado de especificado DependencyProperty.(Heredado de Animatable).

System_CAPS_pubmethodGetAsFrozen()

Crea una copia inmovilizada de la Freezable, con los valores de la propiedad base (no animada). Dado que la copia está inmovilizada, cualquier subobjeto inmovilizado se copia por referencia.(Heredado de Freezable).

System_CAPS_protmethodGetAsFrozenCore(Freezable)

Convierte esta instancia en un clon del elemento BitmapSource objeto.(Invalida Freezable.GetAsFrozenCore(Freezable)).

System_CAPS_pubmethodGetCurrentValueAsFrozen()

Crea una copia inmovilizada de la Freezable con valores de propiedad actuales. Dado que la copia está inmovilizada, cualquier subobjeto inmovilizado se copia por referencia.(Heredado de Freezable).

System_CAPS_protmethodGetCurrentValueAsFrozenCore(Freezable)

Convierte esta instancia en un clon inmovilizado del objeto BitmapSource. Las referencias de recursos, los enlaces de datos y las animaciones no se copian, pero sí sus valores actuales.(Invalida Freezable.GetCurrentValueAsFrozenCore(Freezable)).

System_CAPS_pubmethodGetHashCode()

Obtiene un código hash de este objeto DependencyObject.(Heredado de DependencyObject).

System_CAPS_pubmethodGetLocalValueEnumerator()

Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en este DependencyObject.(Heredado de DependencyObject).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodGetValue(DependencyProperty)

Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject.(Heredado de DependencyObject).

System_CAPS_pubmethodInvalidateProperty(DependencyProperty)

Vuelve a evaluar el valor efectivo de la propiedad de dependencia especificada(Heredado de DependencyObject).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodOnChanged()

Llamado cuando actual Freezable se modifica el objeto.(Heredado de Freezable).

System_CAPS_protmethodOnFreezablePropertyChanged(DependencyObject, DependencyObject)

Garantiza que se establecen los punteros de contexto adecuado para un DependencyObjectType miembro de datos que acaba de configurar.(Heredado de Freezable).

System_CAPS_protmethodOnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Este miembro es compatible con la infraestructura de Windows Presentation Foundation (WPF) y no está diseñado para utilizarse directamente desde el código.(Heredado de Freezable).

System_CAPS_protmethodOnPropertyChanged(DependencyPropertyChangedEventArgs)

Reemplaza la implementación de DependencyObject de OnPropertyChanged para invocar también cualquier controlador Changed en respuesta a una propiedad de dependencia cambiante de tipo Freezable.(Heredado de Freezable).

System_CAPS_pubmethodReadLocalValue(DependencyProperty)

Devuelve el valor local de una propiedad de dependencia, si existe.(Heredado de DependencyObject).

System_CAPS_protmethodReadPreamble()

Garantiza que el Freezable se tiene acceso desde un subproceso válido. Los herederos de Freezable debe llamar a este método al principio de cualquier API que lee miembros de datos que no son propiedades de dependencia.(Heredado de Freezable).

System_CAPS_pubmethodSetCurrentValue(DependencyProperty, Object)

Establece el valor de una propiedad de dependencia sin cambiar el origen de su valor.(Heredado de DependencyObject).

System_CAPS_pubmethodSetValue(DependencyProperty, Object)

Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia.(Heredado de DependencyObject).

System_CAPS_pubmethodSetValue(DependencyPropertyKey, Object)

Establece el valor local de una propiedad de dependencia de solo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia.(Heredado de DependencyObject).

System_CAPS_protmethodShouldSerializeProperty(DependencyProperty)

Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia suministrada.(Heredado de DependencyObject).

System_CAPS_pubmethodToString()

Crea una representación de cadena de este objeto basándose en la referencia cultural actual.(Heredado de ImageSource).

System_CAPS_pubmethodToString(IFormatProvider)

Crea una representación de cadena de este objeto basándose en el IFormatProvider pasado. Si el proveedor es null, el CurrentCulture se utiliza.(Heredado de ImageSource).

System_CAPS_pubmethodVerifyAccess()

Exige que el subproceso de llamada tiene acceso a este DispatcherObject.(Heredado de DispatcherObject).

System_CAPS_protmethodWritePostscript()

Genera el evento Changed para Freezable e invoca su método OnChanged. Las clases que derivan de Freezable deben llamar a este método al final de cualquier API que modifique miembros de clase que no estén almacenados como propiedades de dependencia.(Heredado de Freezable).

System_CAPS_protmethodWritePreamble()

Comprueba que el Freezable no se inmoviliza y que se tiene acceso desde un contexto de subproceso válido. Freezable los herederos deben llamar a este método al principio de cualquier API que escribe en los miembros de datos que no son propiedades de dependencia.(Heredado de Freezable).

NombreDescripción
System_CAPS_pubeventChanged

Se produce cuando el Freezable o se modifica un objeto que contiene.(Heredado de Freezable).

System_CAPS_pubeventDecodeFailed

Se produce cuando la imagen no se puede cargar debido a un encabezado de imagen dañado.

System_CAPS_pubeventDownloadCompleted

Se produce cuando se ha descargado completamente el contenido de mapa de bits.

System_CAPS_pubeventDownloadFailed

Se produce cuando no se puede descargar el contenido de mapa de bits.

System_CAPS_pubeventDownloadProgress

Se produce cuando el progreso de la descarga del contenido de mapa de bits sufre un cambio.

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodIFormattable.ToString(String, IFormatProvider)

Da formato al valor de la instancia actual usando el formato especificado.(Heredado de ImageSource).

BitmapSource es el componente básico de la Windows Presentation Foundation (WPF) canalización de imágenes, que representa conceptualmente un solo conjunto constante de píxeles con un tamaño y resolución determinados. Un BitmapSource podría ser un marco único en un archivo de imagen que proporciona un descodificador, o podría ser el resultado de una transformación que funciona en un BitmapSource propio. BitmapSource no se utiliza para representar una imagen de varios marco o una animación.

Windows Presentation Foundation (WPF) admite de forma nativa la compresión y descompresión de mapa de bits (BMP), Formato de intercambio de gráficos (GIF), Joint Photographics Experts Group (JPEG), Formato PNG (Portable Network Graphics), y Tagged Image File Format (TIFF) imágenes.

Mapa de bits, en escenarios de descodificación BitmapSource usa la detección automática de códecs, según los códecs instalados en el sistema del usuario.

El alto máximo y ancho de una imagen es 2 ^ 16 píxeles de 32 bits por canal * 4 canales. El tamaño máximo de un BitmapSource es 2 ^ 32 bytes (64 gigabytes) y el tamaño de imagen máximo es de cuatro gigapíxeles. El tamaño de imagen mínimo es 1 x 1.

En el ejemplo de código siguiente se muestra cómo crear un BitmapSource y utilizarlo como origen de un Image control.

// Define parameters used to create the BitmapSource.
PixelFormat pf = PixelFormats.Bgr32;
int width = 200;
int height = 200;
int rawStride = (width * pf.BitsPerPixel + 7) / 8;
byte[] rawImage = new byte[rawStride * height];

// Initialize the image with data.
Random value = new Random();
value.NextBytes(rawImage);

// Create a BitmapSource.
BitmapSource bitmap = BitmapSource.Create(width, height,
    96, 96, pf, null,
    rawImage, rawStride);

// Create an image element;
Image myImage = new Image();
myImage.Width = 200;
// Set image source.
myImage.Source = bitmap;

El siguiente ejemplo de código utiliza un BitmapSource clase derivada, BitmapImage, para crear un mapa de bits desde un archivo de imagen y utilizarlo como origen de un Image control.

// Create the image element.
Image simpleImage = new Image();    
simpleImage.Width = 200;
simpleImage.Margin = new Thickness(5);

// Create source.
BitmapImage bi = new BitmapImage();
// BitmapImage.UriSource must be in a BeginInit/EndInit block.
bi.BeginInit();
bi.UriSource = new Uri(@"/sampleImages/cherries_larger.jpg",UriKind.RelativeOrAbsolute);
bi.EndInit();
// Set the image source.
simpleImage.Source = bi;

.NET Framework
Disponible desde 3.0
Silverlight
Disponible desde 3.0
Windows Phone Silverlight
Disponible desde 7.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: