SearchBox Clase

Definición

Representa un control que se puede usar para escribir texto de consulta de búsqueda. (No se recomienda para aplicaciones de Plataforma universal de Windows (UWP). Consulta AutoSuggestBox).

/// [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 SearchBox : Control
[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 SearchBox : Control
Public Class SearchBox
Inherits Control
<SearchBox .../>
Herencia
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

Esta es una definición XAML básica para un SearchBox y una implementación del controlador QuerySubmitted . Llama a Frame.Navigate para cargar una página de resultados de consulta de búsqueda (no se muestra) denominada SearchResultsPage1. La referenciaMeen/ los controladores es la instancia de página contenedora, como es habitual para el código de control de eventos de entrada en página. Puede ver código similar como parte del inicio rápido: Agregar búsqueda a una aplicación.

<SearchBox x:Name="mySearchBox" 
    FocusOnKeyboardInput="True"
    QuerySubmitted="mySearchBox_QuerySubmitted"
    Height="35"/>
private void mySearchBox_QuerySubmitted(SearchBox sender, SearchBoxQuerySubmittedEventArgs args)
{
    this.Frame.Navigate(typeof(SearchResultsPage1), args.QueryText);
}
Private Sub mySearchBox_QuerySubmitted(sender As SearchBox, args As SearchBoxQuerySubmittedEventArgs)
    Me.Frame.Navigate(GetType(SearchResultsPage1), args.QueryText)
End Sub

Comentarios

Use AutoSuggestBox para la búsqueda.

Notas de las versiones anteriores

Windows 10 o posterior

Importante

Aunque SearchBox se implementa en la familia de dispositivos universales, no es totalmente funcional en dispositivos móviles. Usa AutoSuggestBox para tu experiencia de búsqueda universal. Consulta SearchBox en desuso en favor de AutoSuggestBox.

Windows 8.x

Para admitir la interacción del teclado y hacer que la experiencia de búsqueda de la aplicación sea coherente con la pantalla Inicio, establezca la propiedad FocusOnKeyboardInput en true. Para obtener más información, consulta Directrices y lista de comprobación para la búsqueda.

Como mínimo, cada control SearchBox siempre debe tener un controlador QuerySubmitted . Este controlador pasa el texto de consulta del usuario a una página de resultados de búsqueda que el controlador abre. Abra esta página llamando a Frame.Navigate. Para obtener más información sobre cómo escribir un controlador de querySubmitted básico y crear una página de resultados de búsqueda como parte de la aplicación, consulta Permitir que los usuarios busquen información en .

Además de los resultados básicos y la experiencia de búsqueda, un SearchBox también admite sugerencias de búsqueda, estableciendo mediante programación el texto de búsqueda inicial y el historial de búsqueda. La característica de sugerencia de búsqueda es compatible con la API en el espacio de nombres Windows.ApplicationModel.Search . Para obtener código de ejemplo que muestra cómo usar estas características, vea Ejemplo de control SearchBox.

Nota

Una aplicación no puede usar tanto el cuadro de búsqueda como el Panel de búsqueda. El uso del cuadro de búsqueda y el panel de búsqueda de la misma aplicación hace que la aplicación produzca una excepción con este mensaje: "No se puede crear una instancia de tipo 'Windows.UI.Xaml.Controls.SearchBox'"

Constructores

SearchBox()

Inicializa una nueva instancia de la clase SearchBox .

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

Obtiene o establece un pincel que proporciona el fondo del control.

(Heredado de Control)
BackgroundSizing

Obtiene o establece un valor que indica hasta dónde se extiende el fondo en relación con el borde de este elemento.

(Heredado de Control)
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)
BorderBrush

Obtiene o establece un pincel que describe el relleno de borde de un control.

(Heredado de Control)
BorderThickness

Obtiene o establece el grosor del borde de un control.

(Heredado de Control)
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)
CharacterSpacing

Obtiene o establece el espaciado uniforme entre caracteres, en unidades de 1/1000 de em.

(Heredado de Control)
ChooseSuggestionOnEnter

Obtiene o establece un valor que determina si la consulta de búsqueda sugerida se activa cuando el usuario presiona Entrar.

ChooseSuggestionOnEnterProperty

Identifica la propiedad de dependencia ChooseSuggestionOnEnter .

Clip

Obtiene o establece el objeto RectangleGeometry utilizado para definir el esquema del contenido de un uiElement.

(Heredado de UIElement)
CompositeMode

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

(Heredado de UIElement)
ContextFlyout

Obtiene o establece el control flotante asociado a este elemento.

(Heredado de UIElement)
CornerRadius

Obtiene o establece el radio de las esquinas del borde del control.

(Heredado de Control)
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)
DefaultStyleKey

Obtiene o establece la clave que hace referencia al estilo predeterminado para el control. Los autores de controles personalizados usan esta propiedad para cambiar el valor predeterminado del estilo que usa su control.

(Heredado de Control)
DefaultStyleResourceUri

Obtiene o establece la ruta de acceso al archivo de recursos que contiene el estilo predeterminado para el control.

(Heredado de Control)
DesiredSize

Obtiene el tamaño que calcula este UIElement 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)
ElementSoundMode

Obtiene o establece un valor que especifica la preferencia de un control para si se reproducen sonidos.

(Heredado de Control)
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)
FocusOnKeyboardInput

Obtiene o establece un valor que determina si un usuario puede buscar escribiendo en cualquier parte de la aplicación.

FocusOnKeyboardInputProperty

Identifica la propiedad de dependencia FocusOnKeyboardInput .

FocusState

Obtiene un valor que especifica si este control tiene el foco y el modo por el que se obtuvo el foco.

(Heredado de Control)
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)
FontFamily

Obtiene o establece la fuente utilizada para mostrar texto en el control.

(Heredado de Control)
FontSize

Obtiene o establece el tamaño del texto de este control.

(Heredado de Control)
FontStretch

Obtiene o establece el grado al que se condensa o expande la fuente en la pantalla.

(Heredado de Control)
FontStyle

Obtiene o establece el estilo en el que se representa el texto.

(Heredado de Control)
FontWeight

Obtiene o establece el grosor de la fuente especificada.

(Heredado de Control)
Foreground

Obtiene o establece un pincel que describe el color de primer plano.

(Heredado de Control)
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)
HorizontalContentAlignment

Obtiene o establece la alineación horizontal del contenido del control.

(Heredado de Control)
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)
IsEnabled

Obtiene o establece un valor que indica si el usuario puede interactuar con el control.

(Heredado de Control)
IsFocusEngaged

Obtiene o establece un valor que indica si el foco está restringido dentro de los límites del control (para la interacción remota o el panel de juego).

(Heredado de Control)
IsFocusEngagementEnabled

Obtiene o establece un valor que indica si el foco se puede restringir dentro de los límites del control (para la interacción remota o el panel de juego).

(Heredado de Control)
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)
IsTabStop

Obtiene o establece un valor que indica si un control está incluido en la navegación por tabulación.

(Heredado de Control)
IsTapEnabled

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

(Heredado de UIElement)
IsTextScaleFactorEnabled

Obtiene o establece si la ampliación automática del texto, para reflejar la configuración del tamaño del texto del sistema, está habilitada.

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

Ejemplo de un menú que muestra aceleradores de teclado para varios elementos de menú
Ejemplo de un menú que muestra 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 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.

(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 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)
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)
Padding

Establece el espaciado interno dentro de un control.

(Heredado de Control)
Parent

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

(Heredado de FrameworkElement)
PlaceholderText

Obtiene o establece el texto que se muestra en el control hasta que una acción del usuario cambia el valor o alguna otra operación.

PlaceholderTextProperty

Identifica la propiedad de dependencia PlaceholderText .

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

Obtiene o establece el contenido de texto del cuadro de búsqueda.

QueryTextProperty

Identifica la propiedad de dependencia QueryText .

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

Obtiene o establece si un elemento de interfaz de usuario admite el modo de mouse, que emula experiencias de interacción de puntero con dispositivos de entrada que no son de puntero, como un panel de juego o un control remoto.

(Heredado de Control)
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 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)
SearchHistoryContext

Obtiene o establece una cadena que identifica el contexto de la búsqueda y se usa para almacenar el historial de búsqueda del usuario con la aplicación.

SearchHistoryContextProperty

Identifica la propiedad de dependencia SearchHistoryContext .

SearchHistoryEnabled

Obtiene o establece un valor que determina si las sugerencias de búsqueda se realizan a partir del historial de búsqueda.

SearchHistoryEnabledProperty

Identifica la propiedad de dependencia SearchHistoryEnabled .

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.

(Heredado de FrameworkElement)
TabFocusNavigation

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

(Heredado de UIElement)
TabIndex

Obtiene o establece un valor que indica el orden en el que los elementos reciben el foco cuando el usuario navega por la interfaz de usuario de la aplicación mediante la tecla Tab.

(Heredado de Control)
TabNavigation

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

Nota

Para Windows 10 Creators Update (compilación 10.0.15063) y versiones posteriores, la propiedad TabFocusNavigation está disponible en la clase base UIElement para incluir objetos en la secuencia de pestañas que no usan controlTemplate.

(Heredado de Control)
Tag

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

(Heredado de FrameworkElement)
Template

Obtiene o establece una plantilla de control. La plantilla de control define la apariencia visual de un control en la interfaz de usuario y se define en el marcado XAML.

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

(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)
UseSystemFocusVisuals

Obtiene o establece un valor que indica si el control usa objetos visuales de foco dibujados por el sistema o los definidos en la plantilla de control.

(Heredado de Control)
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)
VerticalContentAlignment

Obtiene o establece la alineación vertical del contenido del control.

(Heredado de Control)
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 en el XamlRoot que se está viendo este elemento.

(Heredado de UIElement)
XYFocusDown

Obtiene o establece el objeto que obtiene el foco cuando un usuario presiona el Panel direccional (D-pad) hacia abajo.

(Heredado de Control)
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)
XYFocusLeft

Obtiene o establece el objeto que obtiene el foco cuando un usuario presiona el Panel direccional (D-pad) a la izquierda.

(Heredado de Control)
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)
XYFocusRight

Obtiene o establece el objeto que obtiene el foco cuando un usuario presiona el Panel direccional (D-pad) a la derecha.

(Heredado de Control)
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)
XYFocusUp

Obtiene o establece el objeto que obtiene el foco cuando un usuario presiona el Panel direccional (D-pad) hacia arriba.

(Heredado de Control)
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)
ApplyTemplate()

Carga la plantilla de control pertinente para que se pueda hacer referencia a sus partes.

(Heredado de Control)
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)
Focus(FocusState)

Intenta establecer el foco en el control.

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

(Heredado de FrameworkElement)
GetChildrenInTabFocusOrder()

Permite que una subclase UIElement exponga los elementos secundarios que participan en el foco de tabulación.

(Heredado de UIElement)
GetTemplateChild(String)

Recupera el elemento con nombre en el árbol visual ControlTemplate creado por instancias.

(Heredado de Control)
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)
OnCharacterReceived(CharacterReceivedRoutedEventArgs)

Se llama antes de que se produzca el evento CharacterReceived .

(Heredado de Control)
OnCreateAutomationPeer()

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

(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)
OnDoubleTapped(DoubleTappedRoutedEventArgs)

Se llama antes de que se produzca el evento DoubleTapped .

(Heredado de Control)
OnDragEnter(DragEventArgs)

Se llama antes de que se produzca el evento DragEnter .

(Heredado de Control)
OnDragLeave(DragEventArgs)

Se llama antes de que se produzca el evento DragLeave .

(Heredado de Control)
OnDragOver(DragEventArgs)

Se llama antes de que se produzca el evento DragOver .

(Heredado de Control)
OnDrop(DragEventArgs)

Se llama antes de que se produzca el evento Drop .

(Heredado de Control)
OnGotFocus(RoutedEventArgs)

Se llama antes de que se produzca el evento GotFocus .

(Heredado de Control)
OnHolding(HoldingRoutedEventArgs)

Se llama antes de que se produzca el evento Holding .

(Heredado de Control)
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)
OnKeyDown(KeyRoutedEventArgs)

Se llama antes de que se produzca el evento KeyDown .

(Heredado de Control)
OnKeyUp(KeyRoutedEventArgs)

Se llama antes de que se produzca el evento KeyUp .

(Heredado de Control)
OnLostFocus(RoutedEventArgs)

Se llama antes de que se produzca el evento LostFocus .

(Heredado de Control)
OnManipulationCompleted(ManipulationCompletedRoutedEventArgs)

Se llama antes de que se produzca el evento ManipulationCompleted .

(Heredado de Control)
OnManipulationDelta(ManipulationDeltaRoutedEventArgs)

Se llama antes de que se produzca el evento ManipulationDelta .

(Heredado de Control)
OnManipulationInertiaStarting(ManipulationInertiaStartingRoutedEventArgs)

Se llama antes de que se produzca el evento ManipulationInertiaStarting .

(Heredado de Control)
OnManipulationStarted(ManipulationStartedRoutedEventArgs)

Se llama antes de que se produzca el evento ManipulationStarted .

(Heredado de Control)
OnManipulationStarting(ManipulationStartingRoutedEventArgs)

Se llama antes de que se produzca el evento ManipulationStarting .

(Heredado de Control)
OnPointerCanceled(PointerRoutedEventArgs)

Se llama antes de que se produzca el evento PointerCanceled .

(Heredado de Control)
OnPointerCaptureLost(PointerRoutedEventArgs)

Se llama antes de que se produzca el evento PointerCaptureLost .

(Heredado de Control)
OnPointerEntered(PointerRoutedEventArgs)

Se llama antes de que se produzca el evento PointerEntered .

(Heredado de Control)
OnPointerExited(PointerRoutedEventArgs)

Se llama antes de que se produzca el evento PointerExited .

(Heredado de Control)
OnPointerMoved(PointerRoutedEventArgs)

Se llama antes de que se produzca el evento PointerMoved .

(Heredado de Control)
OnPointerPressed(PointerRoutedEventArgs)

Se llama antes de que se produzca el evento PointerPressed .

(Heredado de Control)
OnPointerReleased(PointerRoutedEventArgs)

Se llama antes de que se produzca el evento PointerReleased .

(Heredado de Control)
OnPointerWheelChanged(PointerRoutedEventArgs)

Se llama antes de que se produzca el evento PointerWheelChanged .

(Heredado de Control)
OnPreviewKeyDown(KeyRoutedEventArgs)

Se llama antes de que se produzca el evento PreviewKeyDown .

(Heredado de Control)
OnPreviewKeyUp(KeyRoutedEventArgs)

Se llama antes de que se produzca el evento PreviewKeyUp .

(Heredado de Control)
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)
OnRightTapped(RightTappedRoutedEventArgs)

Se llama antes de que se produzca el evento RightTapped .

(Heredado de Control)
OnTapped(TappedRoutedEventArgs)

Se llama antes de que se produzca el evento Tapped .

(Heredado de Control)
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)
RemoveFocusEngagement()

Libera el foco de los límites de control de un control que tiene compromiso de foco (para interacción remota o panel de juego).

(Heredado de Control)
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)
SetLocalContentSuggestionSettings(LocalContentSuggestionSettings)

Especifica si las sugerencias basadas en archivos locales se muestran automáticamente en las sugerencias del cuadro de búsqueda y define los criterios que Usa Windows para buscar y filtrar estas sugerencias.

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.

(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 de 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 notifica 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)
FocusDisengaged

Se produce cuando el foco se libera de los límites del control (para la interacción remota o el panel de juego).

(Heredado de Control)
FocusEngaged

Se produce cuando el foco está restringido dentro de los límites del control (para la interacción remota o el panel de juego).

(Heredado de Control)
GettingFocus

Se produce antes de que un UIElement reciba 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)
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 el propagamiento.

(Heredado de UIElement)
Holding

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

(Heredado de UIElement)
IsEnabledChanged

Se produce cuando cambia la propiedad IsEnabled .

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

(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 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)
PrepareForFocusOnKeyboardInput

Se produce cuando la propiedad FocusOnKeyboardInput es true y la aplicación recibe la entrada de teclado textual.

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

Se produce cuando cambia el texto de la consulta.

QuerySubmitted

Se produce cuando el usuario envía una consulta de búsqueda.

ResultSuggestionChosen

Se produce cuando el usuario elige un resultado de búsqueda sugerido.

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

Se produce cuando cambia el texto de la consulta del usuario y la aplicación debe proporcionar nuevas sugerencias para mostrarse en el panel de búsqueda.

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