Image Clase

Definición

Representa un control que muestra una imagen. El origen de la imagen se especifica haciendo referencia a un archivo de imagen con varios formatos admitidos. El origen de la imagen también se puede establecer con una secuencia. Consulte Comentarios para obtener la lista de formatos de origen de imágenes admitidos.

public ref class Image sealed : FrameworkElement
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Image final : FrameworkElement
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class Image final : FrameworkElement
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Image : FrameworkElement
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Image : FrameworkElement
Public NotInheritable Class Image
Inherits FrameworkElement
<Image .../>
Herencia
Object Platform::Object IInspectable DependencyObject UIElement FrameworkElement Image
Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

Sugerencia

Para obtener más información, instrucciones de diseño y ejemplos de código, consulte Imagen.

La aplicación WinUI 2 Gallery incluye ejemplos interactivos de la mayoría de los controles, características y funcionalidades de WinUI 2. Obtenga la aplicación en Microsoft Store u obtenga el código fuente en GitHub.

Comentarios

Formatos de archivos de imagen

Una imagen puede mostrar estos formatos de archivo de imagen:

  • Formato JPEG (Joint Photographic Experts Group)
  • Formato PNG (Portable Network Graphics)
  • Mapa de bits (BMP)
  • Formato de intercambio de gráficos (GIF)
  • Tagged Image File Format (TIFF)
  • JPEG XR
  • iconos (ICO)
  • Scalable Vector Graphics (SVG)

Nota

Solo los archivos de icono admitidos en Windows. No se admite en Windows Phone 8.1

A partir de Windows 10, versión 1607, el elemento Image admite imágenes animadas de formato de intercambio de gráficos (GIF). Al usar bitmapImage como origen de la imagen, puede acceder a BitmapImage API para controlar la reproducción de la imagen animada de formato de intercambio de gráficos (GIF). Para más información, consulta los comentarios de la página de la clase BitmapImage.

Nota

La compatibilidad con el formato de intercambio de gráficos animados (GIF) está disponible cuando la aplicación se compila para Windows 10, versión 1607 y se ejecuta en la versión 1607 (o posterior). Cuando la aplicación se compila o se ejecuta en versiones anteriores, se muestra el primer fotograma del formato de intercambio de gráficos (GIF), pero no se anima.

A partir de Windows 10, versión 1703, el elemento Image admite imágenes estáticas de gráficos vectoriales escalables (SVG) a través de SvgImageSource. SvgImageSource admite el modo estático seguro de la especificación SVG y no admite animaciones ni interacciones. Direct2D proporciona la compatibilidad subyacente con la representación SVG y para obtener más información sobre la compatibilidad específica de atributos y elementos SVG, consulta Compatibilidad con SVG. Para obtener más información sobre cómo insertar un SVG en la aplicación, visite la página de la clase SvgImageSource .

Nota

La compatibilidad con gráficos vectoriales escalables (SVG) está disponible cuando la aplicación se compila para Windows 10, versión 1703 y se ejecuta en la versión 1703 (o posterior). Cuando la aplicación se compila o se ejecuta en versiones anteriores, no se mostrará la imagen SVG.

Configuración de Image.Source

Para establecer el archivo de origen de la imagen que muestra una imagen, establece su propiedad Source , ya sea en XAML o en código. Este es un ejemplo sencillo de establecer Source en XAML:

<Image Width="200" Source="Images/myimage.png"/>

Este uso se establece en Source by Uniform Resource Identifier (URI), que es un acceso directo habilitado por XAML. Tenga en cuenta que el identificador uniforme de recursos (URI) aquí parece ser un identificador uniforme de recursos relativo (URI); admitir el identificador uniforme de recursos (URI) parcial es otro acceso directo XAML. La raíz de este identificador uniforme de recursos (URI) es la carpeta base de un proyecto de aplicación. Normalmente, esta es la misma ubicación desde la que se carga el archivo XAML que contiene la etiqueta Image. En este ejemplo, el archivo de origen de la imagen se encuentra en una subcarpeta Images dentro de la estructura de archivos de la aplicación.

Establecer la propiedad Source es inherentemente una acción asincrónica. Dado que es una propiedad, no hay una sintaxis que se puede esperar, pero para la mayoría de los escenarios no es necesario interactuar con los aspectos asincrónicos de la carga de imágenes. El marco esperará a que se devuelva el origen de la imagen y iniciará un ciclo de diseño cuando el archivo de origen de la imagen esté disponible y descodificado.

Establecer el origen en un valor de identificador uniforme de recursos (URI) que no se puede resolver en un archivo de origen de imagen válido no produce una excepción. En su lugar, desencadena un evento ImageFailed . Puede escribir un controlador ImageFailed y adjuntarlo al objeto Image y, posiblemente, usar errorMessage en los datos de eventos para determinar la naturaleza del error. Un error en la descodificación también puede desencadenar ImageFailed. Si desea comprobar que un archivo de origen de imagen se cargó correctamente, puede controlar el evento ImageOpened en el elemento Image.

Normalmente, usas archivos de origen de imágenes que hayas incluido como parte del paquete de descarga de la aplicación. En el caso de los archivos grandes, puede haber un retraso muy pequeño mientras se descodifica el archivo de origen de la imagen, si es la primera vez que se usa el origen. Para obtener más información sobre los recursos de la aplicación y cómo empaquetar archivos de origen de imágenes en un paquete de aplicación, consulta Definición de recursos de la aplicación.

También puede usar archivos de origen de imagen que no forman parte de la aplicación, por ejemplo imágenes de servidores externos. Estas imágenes se descargan mediante una solicitud HTTP interna y, a continuación, se descodifican. Si el archivo de origen de la imagen es un archivo grande o si hay problemas de conexión, puede haber un retraso antes de que se pueda mostrar una imagen externa en un elemento Image.

Configuración de Image.Source mediante código

Si crea un objeto Image mediante código, llame al constructor predeterminado y establezca la propiedad Image.Source . Establecer la propiedad Image.Source requiere una instancia de la clase BitmapImage , que también debe construir. Si el origen de la imagen es un archivo al que hace referencia el identificador uniforme de recursos (URI), use el constructor BitmapImage que toma un parámetro de identificador uniforme de recursos (URI). Al hacer referencia al contenido local, debe incluir el esquema ms-appx: en el identificador uniforme absoluto de recursos (URI) que se usa como parámetro del constructor BitmapImage . En el código, no obtienes los métodos abreviados de procesamiento para combinar partes relativas del identificador uniforme de recursos (URI) y el esquema ms-appx: que se produce automáticamente si especificas Source como un atributo XAML. En su lugar, debe construir explícitamente un identificador uniforme de recursos (URI) absoluto con el esquema adecuado. Normalmente, usas el esquema ms-appx: para un archivo de imagen empaquetado como parte de la aplicación.

Sugerencia

Si usa C# o Microsoft Visual Basic, puede obtener la propiedad BaseUri de image y pasarla como parámetro baseUri para constructores System.Uri que combinan una ubicación base de identificador uniforme de recursos (URI) y una ruta de acceso relativa dentro de esa ubicación.

Este es un ejemplo de configuración de Image.Source en C#. En este ejemplo, el objeto Image se creó en XAML, pero no tiene un origen ni ningún otro valor de propiedad; en su lugar, estos valores se proporcionan en tiempo de ejecución cuando la imagen se carga desde XAML.

void Image_Loaded(object sender, RoutedEventArgs e)
{
    Image img = sender as Image; 
    BitmapImage bitmapImage = new BitmapImage();
    img.Width = bitmapImage.DecodePixelWidth = 80; //natural px width of image source
    // don't need to set Height, system maintains aspect ratio, and calculates the other
    // dimension, so long as one dimension measurement is provided
    bitmapImage.UriSource = new Uri(img.BaseUri,"Assets/StoreLogo.png");
    img.Source = bitmapImage;
}

Uso de un origen de secuencia para un origen de imagen

Si el origen de la imagen es una secuencia, debe escribir código que establezca la instancia de Image para usar la secuencia. Esto no se puede hacer solo en XAML. Construya la imagen que se va a usar o haga referencia a una instancia de image existente (que podría haberse definido en el marcado XAML, pero sin un origen). A continuación, use el método async SetSourceAsync de BitmapImage para definir la información de imagen de una secuencia, pasando la secuencia para usarla como parámetro streamSource . El uso de una secuencia para un origen de imagen es bastante común. Por ejemplo, si la aplicación permite a un usuario elegir un archivo de imagen mediante un control FileOpenPicker , el objeto que obtiene que representa el archivo elegido por el usuario se puede abrir como una secuencia, pero no proporciona una referencia de identificador uniforme de recursos (URI) al archivo.

En este ejemplo, el código ya es await porque está esperando que el usuario elija un archivo y solo se ejecute después de eso. La secuencia que se va a usar procede de StorageFile.OpenAsync después de que se devuelva una instancia de StorageFile de las acciones del selector asincrónico.

FileOpenPicker open = new FileOpenPicker(); 
// Open a stream for the selected file 
StorageFile file = await open.PickSingleFileAsync(); 
// Ensure a file was selected 
if (file != null) 
{ 
    using (IRandomAccessStream fileStream = await file.OpenAsync(Windows.Storage.FileAccessMode.Read)) 
    { 
        // Set the image source to the selected bitmap 
         BitmapImage bitmapImage = new BitmapImage(); 
         bitmapImage.DecodePixelWidth = 600; //match the target Image.Width, not shown
         await bitmapImage.SetSourceAsync(fileStream); 
         Scenario2Image.Source = bitmapImage; 
    } 
}

Sugerencia

Si usa C# o Microsoft Visual Basic, los flujos pueden usar el tipo System.IO.Stream con el que puede estar familiarizado con la experiencia de programación anterior de Microsoft .NET. Puede llamar al método de extensión AsStream como método de instancia en cualquier objeto de tipo IRandomAccessStream que haya obtenido de una API de Windows Runtime. En el ejemplo anterior se usaba IRandomAccessStream para pasar parámetros y no era necesario usar AsStream. Pero si alguna vez necesita manipular la secuencia, AsStream está allí como una utilidad para convertir a System.IO.Stream si lo necesita.

Consulta el ejemplo de imágenes XAML para obtener más código de ejemplo.

Archivos de imagen y rendimiento

Los archivos de imagen grandes pueden afectar al rendimiento porque se cargan en la memoria. Si estás haciendo referencia a un archivo de imagen en el que sabes que el archivo de origen es una imagen grande y de alta resolución, pero la aplicación lo muestra en una región de la interfaz de usuario que es menor que el tamaño natural de la imagen, debes establecer la propiedad DecodePixelWidth o DecodePixelHeight. Las propiedades DecodePixel* permiten pasar información directamente al códec específico del formato y el códec puede usar esta información para descodificar de forma más eficaz y a una superficie de memoria más pequeña. Establece DecodePixelWidth en el mismo ancho de píxel del área que quieres que la aplicación se muestre realmente. En otras palabras, DecodePixelWidth para el origen BitmapImage debe ser el mismo valor que el Width o ActualWidth del control Image que muestra ese origen.

Puede establecer DecodePixelWidth o establecer DecodePixelHeight. Si establece una de estas dos propiedades, el sistema calcula la propiedad coincidente para mantener la relación de aspecto correcta. También puede establecer ambas propiedades, pero normalmente debe usar valores que mantengan esa relación de aspecto. Si desea cambiar las relaciones de aspecto, hay mejores formas de hacerlo, por ejemplo, usar TranslateTransform como RenderTransform.

Para establecer DecodePixelWidth (o DecodePixelHeight) en XAML, debes usar una sintaxis XAML ligeramente más detallada que incluya un elemento BitmapImage explícito como un valor de elemento de propiedad, como este:

<Image>
  <Image.Source>
    <BitmapImage DecodePixelWidth="200" UriSource="images/myimage.png"/>
  </Image.Source>
</Image>

DecodePixelWidth (o DecodePixelHeight) son propiedades de BitmapImage, por lo que necesitas un elemento de objeto XAML BitmapImage explícito para establecer las propiedades DecodePixel* como atributos en XAML.

Si va a crear una instancia de Image en el código, probablemente ya esté creando una instancia de BitmapImage como un valor para proporcionar para la propiedad Source , por lo que simplemente establezca DecodePixelWidth (o DecodePixelHeight) en la instancia de BitmapImage antes de establecer la propiedad UriSource . La propiedad DecodePixelType también afecta al modo en que las operaciones de descodificación interpretan los valores de píxeles.

Para evitar que las imágenes se descodifiquen más de una vez, asigne la propiedad de origen de imagen del identificador uniforme de recursos (URI) en lugar de usar secuencias de memoria siempre que pueda. El marco XAML puede asociar el mismo identificador uniforme de recursos (URI) en varios lugares con una imagen descodificada, pero no puede hacer lo mismo para varias secuencias de memoria aunque contengan los mismos datos.

Puede quitar los archivos de imagen de la caché de imágenes estableciendo todos los valores image.Source asociados en null.

Para obtener más información sobre la clase Image y el rendimiento, consulta Optimizar animaciones y medios.

Codificación y descodificación de archivos de imagen

La API del componente de creación de imágenes (WIC) proporciona la compatibilidad con el códec subyacente para los archivos de imagen. Para obtener más información sobre formatos de imagen específicos como se documenta para los códecs, consulta Códecs WIC nativos.

La API para Image, BitmapImage y BitmapSource no incluye ningún método dedicado para codificar y descodificar formatos multimedia. Todas las operaciones de descodificación están integradas como acciones que se producen cuando se establece o restablece el origen. Esto facilita el uso de las clases para construir la interfaz de usuario, ya que tienen un conjunto predeterminado de formatos de archivo de origen admitidos y comportamiento de descodificación. Las clases como BitmapImage exponen algunas de las opciones de descodificación y la lógica como parte de los datos de eventos para los eventos ImageOpened o ImageFailed . Si necesita descodificación avanzada de archivos de imagen o codificación de imágenes, debe usar la API del espacio de nombres Windows.Graphics.Imaging . Es posible que necesites estas API si el escenario de la aplicación implica conversiones de formato de archivo de imagen o la manipulación de una imagen en la que el usuario puede guardar el resultado como un archivo. La API de codificación también es compatible con el componente Componente de creación de imágenes de Windows (WIC) de Windows.

Ancho y alto de la imagen

La clase Image hereda las propiedades Width y Height de FrameworkElement, y estas propiedades pueden controlar el tamaño que representará el control Image cuando se muestre en la interfaz de usuario. Si no establece un valor width o height, el ancho y el alto se determinan por el tamaño natural del origen de la imagen. Por ejemplo, si carga una imagen de mapa de bits de 300 píxeles de alto y 400 píxeles de ancho, como se registra en su formato de archivo de origen, estas medidas se usan para el ancho y el alto cuando el control Image calcula su tamaño natural. Puede comprobar ActualHeight y ActualWidth en tiempo de ejecución después de que la imagen se represente para obtener la información de medición. O bien, puede controlar las propiedades de archivo ImageOpened y check image, como PixelHeight y PixelWidth inmediatamente antes de que se represente la imagen.

Si establece solo una de las propiedades Width o Height , pero no ambas, el sistema puede usar esa dimensión como guía y calcular la otra, conservando la relación de aspecto. Si no está seguro de las dimensiones del archivo de origen, elija la dimensión más importante para controlar en el escenario de diseño y permita que el sistema calcule la otra dimensión y, a continuación, el comportamiento de diseño del contenedor normalmente adaptará el diseño para ajustarse.

Si no establece Width o Height y deja la imagen como tamaño natural, la propiedad Stretch de la imagen puede controlar cómo rellenará el archivo de origen de la imagen para rellenar el espacio que especifique como Width y Height. El valor predeterminado de Stretch es Uniform, que conserva la relación de aspecto cuando se ajusta a la imagen en un contenedor de diseño. Si las dimensiones del contenedor no tienen la misma relación de aspecto, habrá espacio vacío que todavía forma parte de Image, pero no muestra ningún píxel de imagen, al menos mientras se usa el valor Uniforme para Stretch. UniformToFill para Stretch no dejará espacio vacío, pero podría recortar la imagen si las dimensiones son diferentes. Relleno para Stretch no dejará espacio vacío, pero podría cambiar la relación de aspecto. Puede experimentar con estos valores para ver lo mejor para la presentación de imágenes en el escenario de diseño. Además, tenga en cuenta que determinados contenedores de diseño pueden cambiar el tamaño de una imagen que no tenga ningún ancho y alto específicos para rellenar todo el espacio de diseño, en cuyo caso puede elegir establecer tamaños específicos en la imagen o en el contenedor para él.

NineGrid

El uso de la técnica NineGrid es otra opción para cambiar el tamaño de las imágenes que tienen un tamaño natural diferente al área de visualización, si la imagen tiene regiones que no se deben escalar uniformemente. Por ejemplo, puede usar una imagen de fondo que tenga un borde inherente que solo debe extenderse en una dimensión y esquinas que no se deben estirar en absoluto, pero el centro de imágenes puede ajustarse a los requisitos de diseño en ambas dimensiones. Para obtener más información, consulta NineGrid.

Calificación y localización de recursos para image

Archivos de origen de imagen y escalado

Debes crear los orígenes de imágenes en varios tamaños recomendados, para asegurarte de que tu aplicación tenga un aspecto excelente cuando Windows 8 lo escala. Al especificar un origen para una imagen, puede usar una convención de nomenclatura para los recursos que usarán el recurso correcto para los factores de escalado específicos del dispositivo. Esto viene determinado por la aplicación automáticamente en tiempo de ejecución. Para obtener información específica sobre las convenciones de nomenclatura que se usarán y más información, consulte Inicio rápido: Uso de recursos de archivo o imagen.

Para obtener más información sobre cómo diseñar imágenes correctamente para el escalado, consulte Directrices de experiencia de usuario para el diseño y el escalado.

Uso de recursos sin calificar

Los recursos no calificados son una técnica que puede usar donde la referencia de recursos básica hace referencia a un recurso predeterminado y el proceso de administración de recursos puede encontrar automáticamente el recurso localizado equivalente. Puede usar el control automático para acceder a recursos no calificados con calificadores de escala y referencia cultural actuales, o puede usar ResourceManager y ResourceMap con calificadores para la referencia cultural y la escala para obtener los recursos directamente. Para obtener más información, consulta Sistema de administración de recursos.

FlowDirection for Image

Si establece FlowDirection como RightToLeft para una imagen, el contenido visual de una imagen se voltea horizontalmente. Sin embargo, un elemento Image no hereda el valor FlowDirection de ningún elemento primario. Normalmente, solo se quiere un comportamiento de volteo de imágenes que sean relevantes para el diseño, pero no necesariamente para los elementos que tienen texto incrustado u otros componentes que no tendría sentido voltear para un público de derecha a izquierda. Para obtener el comportamiento de volteo de imágenes, debe establecer el elemento FlowDirection en el elemento Image específicamente en RightToLeft o establecer la propiedad FlowDirection en el código subyacente. Considere la posibilidad de identificar el elemento Image mediante la directiva x:Uid y especificar los valores de FlowDirection como un recurso de Windows Runtime, de modo que los expertos en localización puedan cambiar este valor más adelante sin cambiar el código XAML o .

La clase Image y la accesibilidad

La clase Image no es una clase de control verdadera en que no es una clase descendiente de Control. No se puede llamar al foco a un elemento Image ni colocar un elemento Image en una secuencia de tabulaciones. Para obtener más información sobre los aspectos de accesibilidad del uso de imágenes y el elemento Image en la interfaz de usuario, consulta Información de accesibilidad básica.

Comportamiento de Windows 8

Para Windows 8, los recursos pueden usar un patrón de calificador de recursos para cargar distintos recursos en función del escalado específico del dispositivo. Sin embargo, los recursos no se vuelven a cargar automáticamente si el factor de escalado cambia mientras se ejecuta la aplicación. En este caso, las aplicaciones tendrían que encargarse de volver a cargar los recursos, controlando el evento DpiChanged (o el evento LogicalDpiChanged en desuso) y usando la API de ResourceManager para volver a cargar manualmente el recurso adecuado para el nuevo factor de escalado. A partir de Windows 8.1, cualquier recurso que se recuperó originalmente para la aplicación se vuelve a evaluar automáticamente si el factor de escalado cambia mientras se ejecuta la aplicación. Además, cuando ese recurso es el origen de la imagen de un objeto Image, se desencadena uno de los eventos de carga de origen (ImageOpened o ImageFailed) como resultado de la acción del sistema de solicitar el nuevo recurso y, a continuación, aplicarlo a la imagen. El escenario en el que puede producirse un cambio de escala en tiempo de ejecución es si el usuario mueve la aplicación a un monitor diferente cuando hay más de uno disponible.

Si migras el código de la aplicación de Windows 8 a Windows 8.1 quizás quieras tener en cuenta este cambio de comportamiento, ya que da como resultado eventos ImageOpened o ImageFailed que se producen en tiempo de ejecución cuando se controla el cambio de escala, incluso en casos en los que el origen se establece en XAML. Además, si tenía código que controló PppChanged/LogicalDpiChanged y restablece los recursos, debe examinar si ese código sigue siendo necesario dada la nueva Windows 8.1 comportamiento de recarga automática.

Las aplicaciones compiladas para Windows 8 que se ejecuten en Windows 8.1 siguen usando el comportamiento de Windows 8.

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
1607 14393 GetAlphaMask

Constructores

Image()

Inicializa una nueva instancia de la clase Image .

Propiedades

AccessKey

Obtiene o establece la clave de acceso (mnemonic) para este elemento.

(Heredado de UIElement)
AccessKeyScopeOwner

Obtiene o establece un elemento de origen que proporciona el ámbito de la clave de acceso para este elemento, aunque no esté en el árbol visual del elemento de origen.

(Heredado de UIElement)
ActualHeight

Obtiene el alto representado de frameworkElement. Vea la sección Comentarios.

(Heredado de FrameworkElement)
ActualOffset

Obtiene la posición de este UIElement, en relación con su elemento primario, calculado durante el paso de organización del proceso de diseño.

(Heredado de UIElement)
ActualSize

Obtiene el tamaño que este UIElement calcula durante el paso de organización del proceso de diseño.

(Heredado de UIElement)
ActualTheme

Obtiene el tema de la interfaz de usuario que usa actualmente el elemento , que podría ser diferente del RequestedTheme.

(Heredado de FrameworkElement)
ActualWidth

Obtiene el ancho representado de un FrameworkElement. Vea la sección Comentarios.

(Heredado de FrameworkElement)
AllowDrop

Obtiene o establece un valor que determina si este UIElement puede ser un destino de colocación con fines de operaciones de arrastrar y colocar.

(Heredado de UIElement)
AllowFocusOnInteraction

Obtiene o establece un valor que indica si el elemento obtiene automáticamente el foco cuando el usuario interactúa con él.

(Heredado de FrameworkElement)
AllowFocusWhenDisabled

Obtiene o establece si un control deshabilitado puede recibir el foco.

(Heredado de FrameworkElement)
BaseUri

Obtiene un identificador uniforme de recursos (URI) que representa el identificador uniforme de recursos (URI) base para un objeto construido con XAML en tiempo de carga XAML. Esta propiedad es útil para la resolución del identificador uniforme de recursos (URI) en tiempo de ejecución.

(Heredado de FrameworkElement)
CacheMode

Obtiene o establece un valor que indica que el contenido representado debe almacenarse en caché como un mapa de bits compuesto siempre que sea posible.

(Heredado de UIElement)
CanBeScrollAnchor

Obtiene o establece un valor que indica si UIElement puede ser un candidato para el delimitador de desplazamiento.

(Heredado de UIElement)
CanDrag

Obtiene o establece un valor que indica si el elemento se puede arrastrar como datos en una operación de arrastrar y colocar.

(Heredado de UIElement)
CenterPoint

Obtiene o establece el punto central del elemento, que es el punto sobre el que se produce la rotación o el escalado. Afecta a la posición de representación del elemento.

(Heredado de UIElement)
Clip

Obtiene o establece el objeto RectangleGeometry usado para definir el esquema del contenido de un UIElement.

(Heredado de UIElement)
CompositeMode

Obtiene o establece una propiedad que declara modos alternativos de composición y combinación para el elemento en su diseño y ventana primarios. Esto es relevante para los elementos implicados en una interfaz de usuario xaml/Microsoft DirectX mixta.

(Heredado de UIElement)
ContextFlyout

Obtiene o establece el control flotante asociado a este elemento.

(Heredado de UIElement)
DataContext

Obtiene o establece el contexto de datos de un FrameworkElement. Un uso común de un contexto de datos es cuando un FrameworkElement usa la extensión de marcado {Binding} y participa en el enlace de datos.

(Heredado de FrameworkElement)
DesiredSize

Obtiene el tamaño que este UIElement calcula durante el paso de medida del proceso de diseño.

(Heredado de UIElement)
Dispatcher

Obtiene el CoreDispatcher al que está asociado este objeto. CoreDispatcher representa una instalación que puede tener acceso a DependencyObject en el subproceso de interfaz de usuario incluso si un subproceso que no es de interfaz de usuario inicia el código.

(Heredado de DependencyObject)
ExitDisplayModeOnAccessKeyInvoked

Obtiene o establece un valor que especifica si se descarta la presentación de la clave de acceso cuando se invoca una clave de acceso.

(Heredado de UIElement)
FlowDirection

Obtiene o establece la dirección en la que el texto y otros elementos de la interfaz de usuario fluyen dentro de cualquier elemento primario que controla su diseño. Esta propiedad se puede establecer en LeftToRight o RightToLeft. Al establecer FlowDirection en RightToLeft en cualquier elemento, se establece la alineación a la derecha, el orden de lectura a derecha a izquierda y el diseño del control que se va a fluir de derecha a izquierda.

(Heredado de FrameworkElement)
FocusVisualMargin

Obtiene o establece el margen exterior del objeto visual de foco para frameworkElement.

(Heredado de FrameworkElement)
FocusVisualPrimaryBrush

Obtiene o establece el pincel utilizado para dibujar el borde exterior de un HighVisibility objeto visual o Reveal de foco para un FrameworkElement.

(Heredado de FrameworkElement)
FocusVisualPrimaryThickness

Obtiene o establece el grosor del borde exterior de un HighVisibility objeto visual o Reveal de foco para un Objeto FrameworkElement.

(Heredado de FrameworkElement)
FocusVisualSecondaryBrush

Obtiene o establece el pincel usado para dibujar el borde interno de un HighVisibility objeto visual o Reveal de foco para un FrameworkElement.

(Heredado de FrameworkElement)
FocusVisualSecondaryThickness

Obtiene o establece el grosor del borde interno de un HighVisibility objeto visual de foco o Reveal para frameworkElement.

(Heredado de FrameworkElement)
Height

Obtiene o establece el alto sugerido de un FrameworkElement.

(Heredado de FrameworkElement)
HighContrastAdjustment

Obtiene o establece un valor que indica si el marco ajusta automáticamente las propiedades visuales del elemento cuando se habilitan los temas de contraste alto.

(Heredado de UIElement)
HorizontalAlignment

Obtiene o establece las características de alineación horizontal que se aplican a un FrameworkElement cuando se compone en un elemento primario de diseño, como un panel o un control de elementos.

(Heredado de FrameworkElement)
IsAccessKeyScope

Obtiene o establece un valor que indica si un elemento define su propio ámbito de clave de acceso.

(Heredado de UIElement)
IsDoubleTapEnabled

Obtiene o establece un valor que determina si el evento DoubleTapped puede originarse en ese elemento.

(Heredado de UIElement)
IsHitTestVisible

Obtiene o establece si el área contenida de este UIElement puede devolver valores true para las pruebas de posicionamiento.

(Heredado de UIElement)
IsHoldingEnabled

Obtiene o establece un valor que determina si el evento Holding puede originarse en ese elemento.

(Heredado de UIElement)
IsLoaded

Obtiene un valor que indica si el elemento se ha agregado al árbol de elementos y está listo para la interacción.

(Heredado de FrameworkElement)
IsRightTapEnabled

Obtiene o establece un valor que determina si el evento RightTapped puede originarse en ese elemento.

(Heredado de UIElement)
IsTapEnabled

Obtiene o establece un valor que determina si el evento Tapped puede originarse en ese elemento.

(Heredado de UIElement)
KeyboardAcceleratorPlacementMode

Obtiene o establece un valor que indica si la información sobre herramientas de control muestra la combinación de teclas para su acelerador de teclado asociado.

(Heredado de UIElement)
KeyboardAcceleratorPlacementTarget

Obtiene o establece un valor que indica la información sobre herramientas de control que muestra la combinación de teclas del acelerador.

(Heredado de UIElement)
KeyboardAccelerators

Obtiene la colección de combinaciones de teclas que invocan una acción mediante el teclado.

Normalmente, los aceleradores se asignan a botones o elementos de menú.

Ejemplo de un menú que muestra los aceleradores de teclado para varios elementos de menú
Ejemplo de un menú que muestra los aceleradores de teclado para varios elementos de menú

(Heredado de UIElement)
KeyTipHorizontalOffset

Obtiene o establece un valor que indica la distancia izquierda o derecha que se coloca la sugerencia de clave en relación con uiElement.

(Heredado de UIElement)
KeyTipPlacementMode

Obtiene o establece un valor que indica dónde se coloca la sugerencia de clave de acceso en relación con el límite de UIElement.

(Heredado de UIElement)
KeyTipTarget

Obtiene o establece un valor que indica el elemento de destino de la clave de acceso Sugerencia de clave.

(Heredado de UIElement)
KeyTipVerticalOffset

Obtiene o establece un valor que indica la distancia hacia arriba o hacia abajo que se coloca la sugerencia de clave en relación con el elemento de la interfaz de usuario.

(Heredado de UIElement)
Language

Obtiene o establece la información del lenguaje de localización o globalización que se aplica a un FrameworkElement y también a todos los elementos secundarios de FrameworkElement actuales en la representación del objeto y en la interfaz de usuario.

(Heredado de FrameworkElement)
Lights

Obtiene la colección de objetos XamlLight adjuntos a este elemento.

(Heredado de UIElement)
ManipulationMode

Obtiene o establece el valor ManipulationModes usado para el comportamiento de UIElement y la interacción con gestos. Establecer este valor permite controlar los eventos de manipulación de este elemento en el código de la aplicación.

(Heredado de UIElement)
Margin

Obtiene o establece el margen externo de un FrameworkElement.

(Heredado de FrameworkElement)
MaxHeight

Obtiene o establece la restricción de alto máxima de un FrameworkElement.

(Heredado de FrameworkElement)
MaxWidth

Obtiene o establece la restricción de ancho máximo de un FrameworkElement.

(Heredado de FrameworkElement)
MinHeight

Obtiene o establece la restricción de altura mínima de un FrameworkElement.

(Heredado de FrameworkElement)
MinWidth

Obtiene o establece la restricción de ancho mínimo de un FrameworkElement.

(Heredado de FrameworkElement)
Name

Obtiene o establece el nombre de identificación del objeto. Cuando un procesador XAML crea el árbol de objetos a partir del marcado XAML, el código en tiempo de ejecución puede hacer referencia al objeto declarado por XAML por este nombre.

(Heredado de FrameworkElement)
NineGrid

Obtiene o establece un valor para una metáfora de nueve cuadrículas que controla cómo se puede cambiar el tamaño de la imagen. La metáfora de nueve cuadrículas te permite estirar bordes y esquinas de una imagen de forma diferente a su centro. Vea Comentarios para obtener más información y una ilustración.

NineGridProperty

Identifica la propiedad de dependencia NineGrid .

Opacity

Obtiene o establece el grado de opacidad del objeto.

(Heredado de UIElement)
OpacityTransition

Obtiene o establece la scalarTransition que anima los cambios en la propiedad Opacity.

(Heredado de UIElement)
Parent

Obtiene el objeto primario de este FrameworkElement en el árbol de objetos.

(Heredado de FrameworkElement)
PlayToSource

Obtiene la información que se transmite si se usa la imagen para un escenario de reproducción a.

PlayToSourceProperty

Identifica la propiedad de dependencia PlayToSource .

PointerCaptures

Obtiene el conjunto de todos los punteros capturados, representados como valores de puntero .

(Heredado de UIElement)
Projection

Obtiene o establece la proyección de perspectiva (efecto 3D) que se va a aplicar al representar este elemento.

(Heredado de UIElement)
RenderSize

Obtiene el tamaño de representación final de un UIElement. No se recomienda usar, vea Comentarios.

(Heredado de UIElement)
RenderTransform

Obtiene o establece información de transformación que afecta a la posición de representación de un UIElement.

(Heredado de UIElement)
RenderTransformOrigin

Obtiene o establece el punto de origen de cualquier posible transformación de representación declarada por RenderTransform, en relación con los límites de UIElement.

(Heredado de UIElement)
RequestedTheme

Obtiene o establece el tema de la interfaz de usuario que usa UIElement (y sus elementos secundarios) para la determinación de recursos. El tema de la interfaz de usuario que especifique con RequestedTheme puede invalidar el objeto RequestedTheme de nivel de aplicación.

(Heredado de FrameworkElement)
Resources

Obtiene el diccionario de recursos definido localmente. En XAML, puedes establecer elementos de recursos como elementos de objeto secundarios de un frameworkElement.Resources elemento de propiedad a través de la sintaxis de colección implícita xaml.

(Heredado de FrameworkElement)
Rotation

Obtiene o establece el ángulo de rotación en sentido de las agujas del reloj, en grados. Gira en relación con RotationAxis y CenterPoint. Afecta a la posición de representación del elemento.

(Heredado de UIElement)
RotationAxis

Obtiene o establece el eje para girar el elemento alrededor.

(Heredado de UIElement)
RotationTransition

Obtiene o establece la scalarTransition que anima los cambios en la propiedad Rotation.

(Heredado de UIElement)
Scale

Obtiene o establece la escala del elemento. Escala en relación con el CenterPoint del elemento. Afecta a la posición de representación del elemento.

(Heredado de UIElement)
ScaleTransition

Obtiene o establece el objeto Vector3Transition que anima los cambios en la propiedad Scale.

(Heredado de UIElement)
Shadow

Obtiene o establece el efecto de sombra convertido por el elemento .

(Heredado de UIElement)
Source

Obtiene o establece el origen de la imagen.

SourceProperty

Identifica la propiedad de dependencia Source .

Stretch

Obtiene o establece un valor que describe cómo se debe estirar una imagen para rellenar el rectángulo de destino.

StretchProperty

Identifica la propiedad de dependencia Stretch .

Style

Obtiene o establece un estilo de instancia que se aplica a este objeto durante el diseño y la representación.

(Heredado de FrameworkElement)
TabFocusNavigation

Obtiene o establece un valor que modifica el funcionamiento de tabulación y TabIndex para este control.

(Heredado de UIElement)
Tag

Obtiene o establece un valor de objeto arbitrario que se puede usar para almacenar información personalizada sobre este objeto.

(Heredado de FrameworkElement)
Transform3D

Obtiene o establece el efecto de transformación 3D que se aplicará al representar este elemento.

(Heredado de UIElement)
TransformMatrix

Obtiene o establece la matriz de transformación que se va a aplicar al elemento .

(Heredado de UIElement)
Transitions

Obtiene o establece la colección de elementos de estilo Transition que se aplican a un UIElement.

(Heredado de UIElement)
Translation

Obtiene o establece la posición de representación x, y y z del elemento.

(Heredado de UIElement)
TranslationTransition

Obtiene o establece el objeto Vector3Transition que anima los cambios en la propiedad Translation.

(Heredado de UIElement)
Triggers

Obtiene la colección de desencadenadores para las animaciones definidas para un FrameworkElement. No se suele utilizar. Vea la sección Comentarios.

(Heredado de FrameworkElement)
UIContext

Obtiene el identificador de contexto del elemento.

(Heredado de UIElement)
UseLayoutRounding

Obtiene o establece un valor que determina si la representación del objeto y su subárbol visual deben usar el comportamiento de redondeo que alinea la representación en píxeles enteros.

(Heredado de UIElement)
VerticalAlignment

Obtiene o establece las características de alineación vertical que se aplican a un FrameworkElement cuando se compone en un objeto primario, como un panel o un control de elementos.

(Heredado de FrameworkElement)
Visibility

Obtiene o establece la visibilidad de un UIElement. Un UIElement que no está visible no se representa y no comunica su tamaño deseado al diseño.

(Heredado de UIElement)
Width

Obtiene o establece el ancho de un FrameworkElement.

(Heredado de FrameworkElement)
XamlRoot

Obtiene o establece el objeto en el XamlRoot que se está viendo este elemento.

(Heredado de UIElement)
XYFocusDownNavigationStrategy

Obtiene o establece un valor que especifica la estrategia utilizada para determinar el elemento de destino de una navegación hacia abajo.

(Heredado de UIElement)
XYFocusKeyboardNavigation

Obtiene o establece un valor que habilita o deshabilita la navegación mediante las flechas direccionales del teclado.

(Heredado de UIElement)
XYFocusLeftNavigationStrategy

Obtiene o establece un valor que especifica la estrategia utilizada para determinar el elemento de destino de un panel de navegación izquierdo.

(Heredado de UIElement)
XYFocusRightNavigationStrategy

Obtiene o establece un valor que especifica la estrategia utilizada para determinar el elemento de destino de una navegación correcta.

(Heredado de UIElement)
XYFocusUpNavigationStrategy

Obtiene o establece un valor que especifica la estrategia utilizada para determinar el elemento de destino de una navegación ascendente.

(Heredado de UIElement)

Métodos

AddHandler(RoutedEvent, Object, Boolean)

Agrega un controlador de eventos enrutados para un evento enrutado especificado. Para ello, agrega el controlador a la colección de controladores en el elemento actual. Especifique handledEventsToo como true para que se invoque el controlador proporcionado incluso si el evento se controla en otro lugar.

(Heredado de UIElement)
Arrange(Rect)

Coloca los objetos secundarios y determina un tamaño para un UIElement. Los objetos primarios que implementan el diseño personalizado para sus elementos secundarios deben llamar a este método desde sus implementaciones de invalidación de diseño para formar una actualización de diseño recursiva.

(Heredado de UIElement)
ArrangeOverride(Size)

Proporciona el comportamiento del paso "Organizar" del diseño. Las clases pueden invalidar este método para definir su propio comportamiento de paso "Organizar".

(Heredado de FrameworkElement)
CancelDirectManipulations()

Cancela el procesamiento continuo de manipulación directa (movimiento panorámico o zoom definido por el sistema) en cualquier elemento primario ScrollViewer que contenga el UIElement actual.

(Heredado de UIElement)
CapturePointer(Pointer)

Establece la captura de puntero en un uiElement. Una vez capturado, solo el elemento que tiene captura activará eventos relacionados con el puntero.

(Heredado de UIElement)
ClearValue(DependencyProperty)

Borra el valor local de una propiedad de dependencia.

(Heredado de DependencyObject)
FindName(String)

Recupera un objeto que tiene el nombre de identificador especificado.

(Heredado de FrameworkElement)
FindSubElementsForTouchTargeting(Point, Rect)

Habilita una subclase UIElement para exponer elementos secundarios que ayudan a resolver el destino táctil.

(Heredado de UIElement)
GetAlphaMask()

Devuelve una máscara que representa el canal alfa de una imagen como compositionBrush.

GetAnimationBaseValue(DependencyProperty)

Devuelve cualquier valor base establecido para una propiedad de dependencia, que se aplicaría en los casos en los que una animación no está activa.

(Heredado de DependencyObject)
GetAsCastingSource()

Devuelve la imagen como castingSource.

GetBindingExpression(DependencyProperty)

Devuelve bindingExpression que representa el enlace en la propiedad especificada.

(Heredado de FrameworkElement)
GetChildrenInTabFocusOrder()

Permite que una subclase UIElement exponga los elementos secundarios que participan en el foco tab.

(Heredado de UIElement)
GetValue(DependencyProperty)

Devuelve el valor efectivo actual de una propiedad de dependencia de dependencyObject.

(Heredado de DependencyObject)
GoToElementStateCore(String, Boolean)

Cuando se implementa en una clase derivada, habilita la construcción por estado de un árbol visual para una plantilla de control en el código, en lugar de cargar XAML para todos los estados en el inicio del control.

(Heredado de FrameworkElement)
InvalidateArrange()

Invalida el estado de organización (diseño) de un UIElement. Después de la invalidación, UIElement tendrá actualizado su diseño, que se producirá de forma asincrónica.

(Heredado de UIElement)
InvalidateMeasure()

Invalida el estado de medición (diseño) de un UIElement.

(Heredado de UIElement)
InvalidateViewport()

Invalida el estado de la ventanilla de un UIElement que se usa para calcular la ventanilla efectiva.

(Heredado de FrameworkElement)
Measure(Size)

Novedades desiredSize de un uiElement. Normalmente, los objetos que implementan el diseño personalizado para sus elementos secundarios de diseño llaman a este método desde sus propias implementaciones measureOverride para formar una actualización de diseño recursiva.

(Heredado de UIElement)
MeasureOverride(Size)

Proporciona el comportamiento del paso "Measure" del ciclo de diseño. Las clases pueden invalidar este método para definir su propio comportamiento de paso "Measure".

(Heredado de FrameworkElement)
OnApplyTemplate()

Se invoca cada vez que el código de aplicación o los procesos internos (como un paso de diseño de regeneración) llaman a ApplyTemplate. En términos más sencillos, esto significa que se llama al método justo antes de que se muestre un elemento de interfaz de usuario en la aplicación. Invalide este método para influir en la lógica de plantilla posterior predeterminada de una clase.

(Heredado de FrameworkElement)
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)

Se llama antes de que se produzca el evento BringIntoViewRequested .

(Heredado de UIElement)
OnCreateAutomationPeer()

Cuando se implementa en una clase derivada, devuelve implementaciones de AutomationPeer específicas de clase para la infraestructura de Automatización de la interfaz de usuario de Microsoft.

(Heredado de UIElement)
OnDisconnectVisualChildren()

Invalide este método para implementar cómo debe comportarse el diseño y la lógica cuando los elementos se quitan de una propiedad secundaria o contenido específico de clase.

(Heredado de UIElement)
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)

Se llama cuando se procesa un método abreviado de teclado (o acelerador) en la aplicación. Invalide este método para controlar cómo responde la aplicación cuando se invoca un acelerador de teclado.

(Heredado de UIElement)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

Se llama justo antes de que se procese un método abreviado de teclado (o acelerador) en la aplicación. Se invoca cada vez que el código de aplicación o los procesos internos llaman a ProcessKeyboardAccelerators. Invalide este método para influir en el control predeterminado del acelerador.

(Heredado de UIElement)
PopulatePropertyInfo(String, AnimationPropertyInfo)

Define una propiedad que se puede animar.

(Heredado de UIElement)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)

Cuando se invalida en una clase derivada, define una propiedad que se puede animar.

(Heredado de UIElement)
ReadLocalValue(DependencyProperty)

Devuelve el valor local de una propiedad de dependencia, si se establece un valor local.

(Heredado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Registra una función de notificación para escuchar los cambios en una dependencyProperty específica en esta instancia de DependencyObject .

(Heredado de DependencyObject)
ReleasePointerCapture(Pointer)

Libera capturas de puntero para la captura de un puntero específico de este UIElement.

(Heredado de UIElement)
ReleasePointerCaptures()

Libera todas las capturas de puntero que mantiene este elemento.

(Heredado de UIElement)
RemoveHandler(RoutedEvent, Object)

Quita el controlador de eventos enrutado especificado de este UIElement. Normalmente, AddHandler agregó el controlador en cuestión.

(Heredado de UIElement)
SetBinding(DependencyProperty, BindingBase)

Adjunta un enlace a frameworkElement mediante el objeto de enlace proporcionado.

(Heredado de FrameworkElement)
SetValue(DependencyProperty, Object)

Establece el valor local de una propiedad de dependencia en dependencyObject.

(Heredado de DependencyObject)
StartAnimation(ICompositionAnimationBase)

Comienza la animación especificada en el elemento .

(Heredado de UIElement)
StartBringIntoView()

Inicia una solicitud al marco XAML para que el elemento se vea dentro de las regiones desplazables que contiene.

(Heredado de UIElement)
StartBringIntoView(BringIntoViewOptions)

Inicia una solicitud al marco XAML para que el elemento se vea mediante las opciones especificadas.

(Heredado de UIElement)
StartDragAsync(PointerPoint)

Inicia una operación de arrastrar y colocar.

(Heredado de UIElement)
StopAnimation(ICompositionAnimationBase)

Detiene la animación especificada en el elemento .

(Heredado de UIElement)
TransformToVisual(UIElement)

Devuelve un objeto de transformación que se puede usar para transformar las coordenadas de UIElement en el objeto especificado.

(Heredado de UIElement)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)

Intenta invocar un método abreviado de teclado (o acelerador) buscando en todo el árbol visual del UIElement para el acceso directo.

(Heredado de UIElement)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Cancela una notificación de cambio registrada anteriormente llamando a RegisterPropertyChangedCallback.

(Heredado de DependencyObject)
UpdateLayout()

Garantiza que todas las posiciones de los objetos secundarios de un UIElement se actualicen correctamente para el diseño.

(Heredado de UIElement)

Eventos

AccessKeyDisplayDismissed

Se produce cuando ya no se deben mostrar las claves de acceso.

(Heredado de UIElement)
AccessKeyDisplayRequested

Se produce cuando el usuario solicita que se muestren las claves de acceso.

(Heredado de UIElement)
AccessKeyInvoked

Se produce cuando un usuario completa una secuencia de claves de acceso.

(Heredado de UIElement)
ActualThemeChanged

Se produce cuando el valor de la propiedad ActualTheme ha cambiado.

(Heredado de FrameworkElement)
BringIntoViewRequested

Se produce cuando se llama a StartBringIntoView en este elemento o en uno de sus descendientes.

(Heredado de UIElement)
CharacterReceived

Se produce cuando la cola de entrada recibe un carácter compuesto único.

(Heredado de UIElement)
ContextCanceled

Se produce cuando un gesto de entrada de contexto continúa en un gesto de manipulación para notificar al elemento que no se debe abrir el control flotante de contexto.

(Heredado de UIElement)
ContextRequested

Se produce cuando el usuario ha completado un gesto de entrada de contexto, como un clic con el botón derecho.

(Heredado de UIElement)
DataContextChanged

Se produce cuando cambia el valor de la propiedad FrameworkElement.DataContext .

(Heredado de FrameworkElement)
DoubleTapped

Se produce cuando se produce una interacción doubleTap no controlada en el área de prueba de posicionamiento de este elemento.

(Heredado de UIElement)
DragEnter

Se produce cuando el sistema de entrada notifica un evento de arrastre subyacente con este elemento como destino.

(Heredado de UIElement)
DragLeave

Se produce cuando el sistema de entrada informa de un evento de arrastre subyacente con este elemento como origen.

(Heredado de UIElement)
DragOver

Se produce cuando el sistema de entrada informa de un evento de arrastre subyacente con este elemento como destino potencial para colocar.

(Heredado de UIElement)
DragStarting

Se produce cuando se inicia una operación de arrastre.

(Heredado de UIElement)
Drop

Se produce cuando el sistema de entrada notifica un evento de colocación subyacente con este elemento como el destino de la colocación.

(Heredado de UIElement)
DropCompleted

Se produce cuando finaliza una operación de arrastrar y colocar con este elemento a medida que finaliza el origen.

(Heredado de UIElement)
EffectiveViewportChanged

Se produce cuando cambia la ventanilla efectiva de FrameworkElement.

(Heredado de FrameworkElement)
GettingFocus

Se produce antes de que un UIElement reciba el foco. Este evento se genera de forma sincrónica para asegurarse de que el foco no se mueve mientras el evento se propaga.

(Heredado de UIElement)
GotFocus

Se produce cuando un UIElement recibe el foco. Este evento se genera de forma asincrónica, por lo que el foco puede moverse de nuevo antes de que se complete la propagación.

(Heredado de UIElement)
Holding

Se produce cuando se produce una interacción de suspensión no controlada sobre el área de prueba de posicionamiento de este elemento.

(Heredado de UIElement)
ImageFailed

Se produce cuando se produce un error asociado a la recuperación o formato de la imagen.

ImageOpened

Se produce cuando el origen de la imagen se descarga y descodifica sin errores. Puede usar este evento para determinar el tamaño natural del origen de la imagen.

KeyDown

Se produce cuando se presiona una tecla de teclado mientras uiElement tiene el foco.

(Heredado de UIElement)
KeyUp

Se produce cuando se suelta una tecla de teclado mientras uiElement tiene el foco.

(Heredado de UIElement)
LayoutUpdated

Se produce cuando cambia el diseño del árbol visual, debido a que las propiedades relevantes para el diseño cambian el valor o alguna otra acción que actualiza el diseño.

(Heredado de FrameworkElement)
Loaded

Se produce cuando se ha construido y agregado un FrameworkElement al árbol de objetos y está listo para la interacción.

(Heredado de FrameworkElement)
Loading

Se produce cuando un FrameworkElement comienza a cargarse.

(Heredado de FrameworkElement)
LosingFocus

Se produce antes de que un UIElement pierda el foco. Este evento se genera de forma sincrónica para asegurarse de que el foco no se mueve mientras el evento se propaga.

(Heredado de UIElement)
LostFocus

Se produce cuando un UIElement pierde el foco. Este evento se genera de forma asincrónica, por lo que el foco puede moverse de nuevo antes de que se complete la propagación.

(Heredado de UIElement)
ManipulationCompleted

Se produce cuando se completa una manipulación en UIElement .

(Heredado de UIElement)
ManipulationDelta

Se produce cuando el dispositivo de entrada cambia de posición durante una manipulación.

(Heredado de UIElement)
ManipulationInertiaStarting

Ocurre cuando el dispositivo de entrada pierde contacto con el objeto UIElement durante una manipulación y el inicio de la inercia.

(Heredado de UIElement)
ManipulationStarted

Se produce cuando un dispositivo de entrada inicia una manipulación en UIElement.

(Heredado de UIElement)
ManipulationStarting

Se produce cuando se crea por primera vez el procesador de manipulación.

(Heredado de UIElement)
NoFocusCandidateFound

Se produce cuando un usuario intenta mover el foco (mediante tabulación o flechas direccionales), pero el foco no se mueve porque no se encuentra ningún candidato de enfoque en la dirección del movimiento.

(Heredado de UIElement)
PointerCanceled

Se produce cuando un puntero que hizo contacto pierde de forma anormal el contacto.

(Heredado de UIElement)
PointerCaptureLost

Se produce cuando la captura de puntero previamente mantenida por este elemento se mueve a otro elemento o a otro lugar.

(Heredado de UIElement)
PointerEntered

Se produce cuando un puntero entra en el área de prueba de posicionamiento de este elemento.

(Heredado de UIElement)
PointerExited

Se produce cuando un puntero deja el área de prueba de posicionamiento de este elemento.

(Heredado de UIElement)
PointerMoved

Se produce cuando un puntero se mueve mientras el puntero permanece dentro del área de prueba de posicionamiento de este elemento.

(Heredado de UIElement)
PointerPressed

Se produce cuando el dispositivo de puntero inicia una acción Press dentro de este elemento.

(Heredado de UIElement)
PointerReleased

Se produce cuando se libera el dispositivo de puntero que inició previamente una acción Press , mientras se encuentra dentro de este elemento. Tenga en cuenta que no se garantiza que el final de una acción Press active un evento PointerReleased; otros eventos pueden desencadenarse en su lugar. Para obtener más información, consulta Comentarios.

(Heredado de UIElement)
PointerWheelChanged

Se produce cuando cambia el valor delta de una rueda de puntero.

(Heredado de UIElement)
PreviewKeyDown

Se produce cuando se presiona una tecla de teclado mientras uiElement tiene el foco.

(Heredado de UIElement)
PreviewKeyUp

Se produce cuando se suelta una tecla de teclado mientras uiElement tiene el foco.

(Heredado de UIElement)
ProcessKeyboardAccelerators

Se produce cuando se presiona un método abreviado de teclado (o acelerador ).

(Heredado de UIElement)
RightTapped

Se produce cuando se produce un estímulo de entrada de pulsación derecha mientras el puntero está sobre el elemento.

(Heredado de UIElement)
SizeChanged

Se produce cuando la propiedad ActualHeight o ActualWidth cambia el valor en un FrameworkElement.

(Heredado de FrameworkElement)
Tapped

Se produce cuando se produce una interacción de tap no controlada en el área de prueba de posicionamiento de este elemento.

(Heredado de UIElement)
Unloaded

Se produce cuando este objeto ya no está conectado al árbol de objetos principal.

(Heredado de FrameworkElement)

Se aplica a

Consulte también