FrameworkElement Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona una clase de elemento base para Windows Runtime objetos de interfaz de usuario. FrameworkElement define la API común que admite la interacción de la interfaz de usuario y el sistema de diseño automático. FrameworkElement también define la API relacionada con el enlace de datos, la definición y el examen del árbol de objetos y el seguimiento de la duración del objeto.
public ref class FrameworkElement : UIElement/// [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 FrameworkElement : UIElement[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 class FrameworkElement : UIElementPublic Class FrameworkElement
Inherits UIElement- Herencia
- Derivado
- 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)
|
Comentarios
FrameworkElement es un elemento base: es una clase de la que muchas otras clases Windows Runtime heredan para admitir el modelo de elementos de la interfaz de usuario XAML. Cientos de otras clases de Windows Runtime heredan propiedades, métodos y eventos que Define FrameworkElement.
Muchas clases de interfaz de usuario XAML comunes se derivan de FrameworkElement, ya sea directamente o a través de clases base intermedias como Panel o Control. Normalmente, no se derivan clases directamente de FrameworkElement, ya que ciertos servicios esperados para una clase que está pensada para una representación de interfaz de usuario (como la compatibilidad con plantillas) no se implementan completamente allí. Las clases base más usadas para las clases personalizadas derivadas son:
- Controles específicos que no están sellados (por ejemplo, TextBox).
- Clases base de control (Control, ContentControl, UserControl).
- Elementos de navegación (Page, Frame).
- Clases de panel (panel de clase base o implementaciones no selladas específicas, como Grid).
FrameworkElement API y características
FrameworkElement extiende UIElement, que es otro elemento base, y agrega compatibilidad con varias áreas de características de Windows Runtime.
Layout
El sistema de diseño reconoce todos los objetos que derivan de FrameworkElement para que sean elementos que puedan participar en el diseño y deben tener un área de presentación en la interfaz de usuario de la aplicación. El sistema de diseño lee varias propiedades definidas en el nivel FrameworkElement, como MinWidth. La mayoría de los elementos de la interfaz de usuario usan el ancho y el alto definidos por FrameworkElement para su información básica de ajuste de tamaño. FrameworkElement proporciona métodos extensibles para el comportamiento de diseño especializado que los paneles y controles con contenido pueden invalidar en sus implementaciones de clase. Para obtener más información, consulta Definir diseños con XAML.
API destacada de FrameworkElement que admite el diseño: Height, Width, ActualHeight, ActualWidth, Margin, MeasureOverride, ArrangeOverride, HorizontalAlignment, VerticalAlignment, LayoutUpdated.
Eventos de duración de objetos
A menudo quiere saber cuándo se carga por primera vez un objeto (se define como cuando un objeto se adjunta a un árbol de objetos que se conecta al objeto visual raíz). FrameworkElement define eventos relacionados con la duración del objeto que proporcionan enlaces útiles para las operaciones de código subyacente. Por ejemplo, necesitas información de duración de objetos para agregar objetos secundarios a una colección o establecer propiedades en objetos secundarios justo antes de usarlos, con la garantía de que ya se han creado instancias de los objetos necesarios en el árbol de objetos a partir del marcado XAML. Para obtener más información, consulta Introducción a eventos y eventos enrutados.
API destacada de FrameworkElement que admite eventos de duración de objetos: Loaded, SizeChanged, Unloaded, OnApplyTemplate.
Enlace de datos
FrameworkElement implementa la capacidad de establecer un valor para un contexto de datos potencialmente heredado para un enlace de datos. FrameworkElement también tiene API para establecer el enlace de datos en el código en lugar de en XAML. Para obtener más información, consulta el tema Enlace de datos en profundidad.
API destacada de FrameworkElement que admite el enlace de datos: DataContext, DataContextChanged, SetBinding, GetBindingExpression.
Integración del lenguaje XAML y del modelo de programación
Normalmente, la estructura de elementos de la aplicación es similar al marcado XAML que definió para crear la interfaz de usuario, pero a veces esa estructura cambia después de analizar el XAML. FrameworkElement define la propiedad Name y la API relacionada, que son útiles para buscar elementos y relaciones de elementos en tiempo de ejecución. Para obtener más información, consulta Ámbitos de nombres XAML.
API destacada de FrameworkElement que admite xaml y modelo de programación: Name, FindName, Parent, BaseUri, OnApplyTemplate.
Globalización
La clase FrameworkElement define la propiedad Language y la propiedad FlowDirection . Para obtener más información, consulta Globalización de la aplicación.
Compatibilidad con temas y estilos
La clase FrameworkElement define la propiedad Style y la propiedad RequestedTheme . Además, la propiedad Resources se usa para definir los diccionarios de recursos XAML de nivel de página que normalmente definen estilos y plantillas, así como otros recursos compartidos. Para obtener más información, consulta Controles de estilo y Referencias a recursos ResourceDictionary y XAML.
Propiedades de dependencia frameworkElement
Muchas de las propiedades de lectura y escritura de la clase de elemento base FrameworkElement son propiedades de dependencia. Las propiedades de dependencia admiten algunas de las características básicas del modelo de programación para una aplicación para UWP con C++, C# o Visual Basic, como estilos y plantillas, enlace de datos, referencias de recursos XAML y lógica modificada por propiedades. Para obtener más información sobre las propiedades de dependencia y las características que admiten, consulte Información general sobre las propiedades de dependencia.
Clases derivadas de FrameworkElement
FrameworkElement es la clase primaria para varias clases derivadas inmediatamente que distinguen varias clasificaciones amplias de elementos de la interfaz de usuario. Estas son algunas de las clases derivadas importantes:
- Control: el control tiene muchas clases de control derivadas, básicamente todos los controles XAML que usas para una interfaz de usuario de Windows Runtime se derivan de Control.
- Presentadores: un moderador es una clase que imparte una apariencia visual, normalmente contribuyendo a algún escenario de control, pero el propio moderador no suele ser interactivo. Por ejemplo: Border, ContentPresenter (primario de ScrollContentPresenter y otros), ItemsPresenter, Viewbox.
- Elementos multimedia y web: Image, WebView, MediaElement, CaptureElement. Estos contenidos para mostrar y tienen algún nivel de interactividad que se produce dentro de su contenido, pero realmente no son controles.
- Elementos de presentación de texto: TextBlock, RichTextBlock, RichTextBlockOverflow, glifos. (Los elementos text como Run e Hyperlink, que a menudo declaran el contenido de un elemento de presentación de texto, no se derivan de FrameworkElement).
- La clase base Panel : Panel es la clase primaria de los paneles comunes, como Grid, StackPanel , etc.
- La clase base Shape : Shape es la clase primaria de Path, Rectangle , etc.
- La clase base IconElement : clase primaria para FontIcon, SymbolIcon , etc.
- Elementos de interfaz de usuario varios: Popup, TickBar, Viewbox.
Historial de versiones
| Versión de Windows | Versión del SDK | Valor agregado |
|---|---|---|
| 1607 | 14393 | AllowFocusOnInteraction |
| 1607 | 14393 | AllowFocusWhenDisabled |
| 1607 | 14393 | FocusVisualMargin |
| 1607 | 14393 | FocusVisualPrimaryBrush |
| 1607 | 14393 | FocusVisualPrimaryThickness |
| 1607 | 14393 | FocusVisualSecondaryBrush |
| 1607 | 14393 | FocusVisualSecondaryThickness |
| 1703 | 15063 | DeferTree |
| 1709 | 16299 | ActualTheme |
| 1709 | 16299 | ActualThemeChanged |
| 1809 | 17763 | EffectiveViewportChanged |
| 1809 | 17763 | InvalidateViewport |
| 1809 | 17763 | Isloaded |
Constructores
| FrameworkElement() |
Proporciona el comportamiento de inicialización de clases base para las clases derivadas de FrameworkElement. |
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. |
| ActualHeightProperty |
Identifica la propiedad de dependencia ActualHeight . Vea la sección Comentarios. |
| 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. |
| ActualThemeProperty |
Identifica la propiedad de dependencia ActualTheme. |
| ActualWidth |
Obtiene el ancho representado de un FrameworkElement. Vea la sección Comentarios. |
| ActualWidthProperty |
Identifica la propiedad de dependencia ActualWidth . Vea la sección Comentarios. |
| 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. |
| AllowFocusOnInteractionProperty |
Identifica la propiedad de dependencia AllowFocusOnInteraction . |
| AllowFocusWhenDisabled |
Obtiene o establece si un control deshabilitado puede recibir el foco. |
| AllowFocusWhenDisabledProperty |
Identifica la propiedad de dependencia AllowFocusWhenDisabled . |
| 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. |
| 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. |
| DataContextProperty |
Identifica la propiedad de dependencia DataContext . |
| 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. |
| FlowDirectionProperty |
Identifica la propiedad de dependencia FlowDirection . |
| FocusVisualMargin |
Obtiene o establece el margen exterior del objeto visual de foco para frameworkElement. |
| FocusVisualMarginProperty |
Identifica la propiedad de dependencia FocusVisualMargin . |
| FocusVisualPrimaryBrush |
Obtiene o establece el pincel utilizado para dibujar el borde exterior de un |
| FocusVisualPrimaryBrushProperty |
Identifica la propiedad de dependencia FocusVisualPrimaryBrush . |
| FocusVisualPrimaryThickness |
Obtiene o establece el grosor del borde exterior de un |
| FocusVisualPrimaryThicknessProperty |
Identifica la propiedad de dependencia FocusVisualPrimaryThickness . |
| FocusVisualSecondaryBrush |
Obtiene o establece el pincel usado para dibujar el borde interno de un |
| FocusVisualSecondaryBrushProperty |
Identifica la propiedad de dependencia FocusVisualSecondaryBrush . |
| FocusVisualSecondaryThickness |
Obtiene o establece el grosor del borde interno de un |
| FocusVisualSecondaryThicknessProperty |
Identifica la propiedad de dependencia FocusVisualSecondaryThickness . |
| Height |
Obtiene o establece el alto sugerido de un FrameworkElement. |
| HeightProperty |
Identifica la propiedad de dependencia Height . |
| 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. |
| HorizontalAlignmentProperty |
Identifica la propiedad de dependencia HorizontalAlignment . |
| 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 desde 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. |
| 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 del 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 de aceleración. (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ú.
|
| 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 sugerencia de clave de acceso. (Heredado de UIElement) |
| KeyTipVerticalOffset |
Obtiene o establece un valor que indica hasta dónde se coloca la sugerencia de teclas 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. |
| LanguageProperty |
Identifica la propiedad de dependencia Language . |
| 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 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. |
| MarginProperty |
Identifica la propiedad de dependencia Margin . |
| MaxHeight |
Obtiene o establece la restricción de alto máxima de un FrameworkElement. |
| MaxHeightProperty |
Identifica la propiedad de dependencia MaxHeight . |
| MaxWidth |
Obtiene o establece la restricción de ancho máximo de un FrameworkElement. |
| MaxWidthProperty |
Identifica la propiedad de dependencia MaxWidth . |
| MinHeight |
Obtiene o establece la restricción de altura mínima de un FrameworkElement. |
| MinHeightProperty |
Identifica la propiedad de dependencia MinHeight . |
| MinWidth |
Obtiene o establece la restricción de ancho mínimo de un FrameworkElement. |
| MinWidthProperty |
Identifica la propiedad de dependencia MinWidth . |
| 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. |
| NameProperty |
Identifica la propiedad de dependencia Name . |
| Opacity |
Obtiene o establece el grado de opacidad del objeto. (Heredado de UIElement) |
| OpacityTransition |
Obtiene o establece scalarTransition que anima los cambios realizados en la propiedad Opacity. (Heredado de UIElement) |
| Parent |
Obtiene el objeto primario de este FrameworkElement en el árbol de objetos. |
| 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 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. |
| RequestedThemeProperty |
Identifica la propiedad de dependencia RequestedTheme . |
| Resources |
Obtiene el diccionario de recursos definido localmente. En XAML, puedes establecer elementos de recursos como elementos de objeto secundarios de un |
| 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 que se va a girar el elemento. (Heredado de UIElement) |
| RotationTransition |
Obtiene o establece scalarTransition que anima los cambios a 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 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) |
| Style |
Obtiene o establece un estilo de instancia que se aplica a este objeto durante el diseño y la representación. |
| StyleProperty |
Identifica la propiedad de dependencia Style . |
| 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. |
| TagProperty |
Identifica la propiedad de dependencia Tag . |
| Transform3D |
Obtiene o establece el efecto de transformación 3D que se va a 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 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. |
| 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. |
| VerticalAlignmentProperty |
Identifica la propiedad de dependencia VerticalAlignment . |
| 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. |
| WidthProperty |
Identifica la propiedad de dependencia Width . |
| XamlRoot |
Obtiene o establece el en el |
| 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 derecha. (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". |
| 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) |
| DeferTree(DependencyObject) |
Quita el elemento especificado del árbol visual XAML de forma que se pueda aplazar más adelante. |
| FindName(String) |
Recupera un objeto que tiene el nombre de identificador especificado. |
| FindSubElementsForTouchTargeting(Point, Rect) |
Habilita una subclase UIElement para exponer elementos secundarios que ayudan a resolver el destino táctil. (Heredado de UIElement) |
| 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) |
| GetBindingExpression(DependencyProperty) |
Devuelve bindingExpression que representa el enlace en la propiedad especificada. |
| 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. |
| 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. |
| 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". |
| 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. |
| 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 se quitan elementos 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 del acelerador predeterminado. (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 las 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. |
| 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 al objeto especificado. (Heredado de UIElement) |
| TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) |
Intenta invocar un método abreviado de teclado (o acelerador) buscando en todo el árbol visual de UIElement 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. |
| 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 . |
| 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. |
| 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) |
| KeyDown |
Se produce cuando se presiona una tecla de teclado mientras uiElement tiene el foco. (Heredado de UIElement) |
| KeyUp |
Se produce cuando se libera 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. |
| Loaded |
Se produce cuando se ha construido y agregado un FrameworkElement al árbol de objetos y está listo para la interacción. |
| Loading |
Se produce cuando un FrameworkElement comienza a cargarse. |
| LosingFocus |
Se produce antes de que un UIElement pierda el foco. Este evento se genera sincrónicamente 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 el propagamiento. (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 (a través de flechas de tabulación o direccional), 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 anómala 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 sale del á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 del 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 libera 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. |
| 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. |
Se aplica a
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de