UIElement.IsMouseDirectlyOver UIElement.IsMouseDirectlyOver UIElement.IsMouseDirectlyOver UIElement.IsMouseDirectlyOver Property

Definición

Obtiene un valor que indica si la posición del puntero del mouse corresponde a los resultados de las pruebas de posicionamiento, que tienen en cuenta la composición del elemento.Gets a value that indicates whether the position of the mouse pointer corresponds to hit test results, which take element compositing into account. Es una propiedad de dependencia.This is a dependency property.

public:
 property bool IsMouseDirectlyOver { bool get(); };
public bool IsMouseDirectlyOver { get; }
member this.IsMouseDirectlyOver : bool
Public ReadOnly Property IsMouseDirectlyOver As Boolean

Valor de propiedad

true si el puntero del mouse está sobre el mismo resultado del elemento que una prueba de posicionamiento; de lo contrario, false.true if the mouse pointer is over the same element result as a hit test; otherwise, false. De manera predeterminada, es false.The default is false.

Implementaciones

Comentarios

A diferencia de IsMouseOver, esta propiedad solo es true si el puntero del mouse está sobre el elemento literal - como lo es para una prueba de posicionamiento.Unlike IsMouseOver, this property is only true if the mouse pointer is over the literal element - as it is for a hit test. Si el puntero del mouse está sobre un elemento secundario, en concreto sobre los elementos que forman parte de un elemento de la plantilla más profunda y la composición, esta propiedad será false.If the mouse pointer is instead over a child element, in particular over elements that are part of an element's deeper template and compositing, this property will be false. A menos que sepa cómo un control está compuesto (por ejemplo, utiliza esta propiedad en una plantilla de control personalizado para un control que defina), esta propiedad podría devolver resultados inesperados.Unless you know how a control is composited (for example, you use this property in a custom control template for a control that you define), this property might return unexpected results. Para la mayoría de los escenarios donde no se esté creando controles, utilizar IsMouseOver en su lugar.For most scenarios where you are not authoring controls, use IsMouseOver instead.

Si este elemento captura el mouse, y esta propiedad es true en tiempo de captura, esta propiedad continuará devolviendo true hasta que se pierde la captura del mouse y el puntero no es a través de sus límites.If the mouse is captured by this element, and this property is true at time of capture, this property will continue to return true until mouse capture is lost and the pointer is not over its bounds.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field IsMouseDirectlyOverProperty
Establecen las propiedades de metadatos en trueMetadata properties set to true NoneNone

Se aplica a

Consulte también: