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 BitmapFrame

 

Publicado: octubre de 2016

Representa los datos devueltos por un decodificador y aceptados por los codificadores de imagen.

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.Media.Imaging.BitmapFrame

public abstract class BitmapFrame : BitmapSource, IUriContext

NombreDescripción
System_CAPS_protmethodBitmapFrame()

Inicializa una nueva instancia de la clase BitmapFrame.

NombreDescripción
System_CAPS_pubpropertyBaseUri

Cuando se invalida en una clase derivada, obtiene o establece un valor que representa la base de Uri del contexto actual.

System_CAPS_pubpropertyCanFreeze

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

System_CAPS_pubpropertyColorContexts

Cuando se invalida en una clase derivada, obtiene una colección de ColorContext objetos que están asociados a esta BitmapFrame.

System_CAPS_pubpropertyDecoder

Cuando se invalida en una clase derivada, obtiene el decodificador asociado con esta instancia de BitmapFrame.

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. (Heredado de BitmapSource).

System_CAPS_pubpropertyDpiY

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

System_CAPS_pubpropertyFormat

Obtiene el nativo PixelFormat de los datos de mapa de bits.(Heredado de BitmapSource).

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). (Heredado de BitmapSource).

System_CAPS_pubpropertyIsDownloading

Obtiene un valor que indica si la BitmapSource contenido está descargando actualmente.(Heredado de BitmapSource).

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.(Heredado de BitmapSource).

System_CAPS_pubpropertyPalette

Obtiene la paleta de colores del mapa de bits, si se especifica uno.(Heredado de BitmapSource).

System_CAPS_pubpropertyPixelHeight

Obtiene el alto del mapa de bits en píxeles.(Heredado de BitmapSource).

System_CAPS_pubpropertyPixelWidth

Obtiene el ancho del mapa de bits en píxeles.(Heredado de BitmapSource).

System_CAPS_pubpropertyThumbnail

Si se reemplaza en una clase derivada, obtiene la imagen en miniatura asociada a esta clase BitmapFrame.

System_CAPS_pubpropertyWidth

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

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.(Heredado de BitmapSource).

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.(Heredado de BitmapSource).

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.(Heredado de BitmapSource).

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.(Heredado de BitmapSource).

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.(Heredado de BitmapSource).

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.(Heredado de BitmapSource).

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.(Heredado de BitmapSource).

System_CAPS_pubmethodCopyPixels(Int32Rect, IntPtr, Int32, Int32)

Copia los datos de píxel del mapa de bits dentro del rectángulo especificado (Heredado de BitmapSource).

System_CAPS_pubmethodSystem_CAPS_staticCreate(BitmapSource)

Crea un nuevo BitmapFrame desde una determinada BitmapSource.

System_CAPS_pubmethodSystem_CAPS_staticCreate(BitmapSource, BitmapSource)

Crea un nuevo BitmapFrame desde una determinada BitmapSource con la vista en miniatura especificada.

System_CAPS_pubmethodSystem_CAPS_staticCreate(BitmapSource, BitmapSource, BitmapMetadata, ReadOnlyCollection<ColorContext>)

Crea un nuevo BitmapFrame desde un BitmapSource determinado con la miniatura especificada, BitmapMetadata y ColorContext.

System_CAPS_pubmethodSystem_CAPS_staticCreate(Stream)

Crea un nuevo BitmapFrame desde una determinada Stream.

System_CAPS_pubmethodSystem_CAPS_staticCreate(Stream, BitmapCreateOptions, BitmapCacheOption)

Crea un nuevo BitmapFrame desde una determinada Stream con el parámetro BitmapCreateOptions y BitmapCacheOption.

System_CAPS_pubmethodSystem_CAPS_staticCreate(Uri)

Crea un nuevo BitmapFrame desde una determinada Uri.

System_CAPS_pubmethodSystem_CAPS_staticCreate(Uri, BitmapCreateOptions, BitmapCacheOption)

Crea un BitmapFrame de un determinado Uri con el parámetro BitmapCreateOptions y BitmapCacheOption.

System_CAPS_pubmethodSystem_CAPS_staticCreate(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Crea un BitmapFrame de un determinado Uri con el parámetro BitmapCreateOptions, BitmapCacheOption, y RequestCachePolicy.

System_CAPS_pubmethodSystem_CAPS_staticCreate(Uri, RequestCachePolicy)

Crea un BitmapFrame de un determinado Uri con el parámetro RequestCachePolicy.

System_CAPS_pubmethodCreateInPlaceBitmapMetadataWriter()

Si se reemplaza en una clase derivada, crea una instancia de InPlaceBitmapMetadataWriter, que puede usarse para asociar metadatos a una clase BitmapFrame.

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.(Heredado de BitmapSource).

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.(Heredado de BitmapSource).

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.(Heredado de BitmapSource).

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 que realiza la 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.(Heredado de BitmapSource).

System_CAPS_pubeventDownloadCompleted

Se produce cuando se ha descargado completamente el contenido de mapa de bits.(Heredado de BitmapSource).

System_CAPS_pubeventDownloadFailed

Se produce cuando no se puede descargar el contenido de mapa de bits.(Heredado de BitmapSource).

System_CAPS_pubeventDownloadProgress

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

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).

BitmapFrame Proporciona funcionalidad adicional no definida por BitmapSource proporcionando acceso a la Thumbnail asociado a un marco determinado de una imagen. BitmapFrame también admite la escritura de información de metadatos utilizando la Metadata propiedad o CreateInPlaceBitmapMetadataWriter método.

Cualquier BitmapFrame devuelto desde un descodificador siempre está inmovilizado. Si necesita una copia modificable, primero debe crear una copia de la BitmapFrame utilizando la Clone (método).

Sólo Tagged Image File Format (TIFF) y Formato de intercambio de gráficos (GIF) admiten varios marcos.

En el ejemplo de código siguiente se muestra cómo crear un nuevo BitmapSource mediante el uso de un BitmapFrame.

int width = 128;
int height = width;
int stride = width/8;
byte[] pixels = new byte[height*stride];

// Try creating a new image with a custom palette.
List<System.Windows.Media.Color> colors = new List<System.Windows.Media.Color>();
colors.Add(System.Windows.Media.Colors.Red);
colors.Add(System.Windows.Media.Colors.Blue);
colors.Add(System.Windows.Media.Colors.Green);
BitmapPalette myPalette = new BitmapPalette(colors);

// Creates a new empty image with the pre-defined palette

BitmapSource image = BitmapSource.Create(
    width,
    height,
    96,
    96,
    PixelFormats.Indexed1,
    myPalette, 
    pixels, 
    stride);

FileStream stream = new FileStream("empty.tif", FileMode.Create);
TiffBitmapEncoder encoder = new TiffBitmapEncoder();
TextBlock myTextBlock = new TextBlock();
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString();
encoder.Frames.Add(BitmapFrame.Create(image));
MessageBox.Show(myPalette.Colors.Count.ToString());
encoder.Save(stream);

En el ejemplo de código siguiente se muestra cómo utilizar el BitmapFrame objeto para abrir un Formato PNG (Portable Network Graphics) gráfico y escribir metadatos utilizando la CreateInPlaceBitmapMetadataWriter (método).

Stream pngStream = new System.IO.FileStream("smiley.png", FileMode.Open, FileAccess.ReadWrite, FileShare.ReadWrite);
PngBitmapDecoder pngDecoder = new PngBitmapDecoder(pngStream, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapFrame pngFrame = pngDecoder.Frames[0];
InPlaceBitmapMetadataWriter pngInplace = pngFrame.CreateInPlaceBitmapMetadataWriter();
if (pngInplace.TrySave() == true)
{ pngInplace.SetQuery("/Text/Description", "Have a nice day."); }
pngStream.Close();

.NET Framework
Disponible desde 3.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: