Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

MouseWheelEventArgs (Clase)

Proporciona datos para varios eventos que informan de cambios en el valor delta de la rueda del mouse.

Espacio de nombres:  System.Windows.Input
Ensamblado:  PresentationCore (en PresentationCore.dll)

public class MouseWheelEventArgs : MouseEventArgs

El tipo MouseWheelEventArgs expone los siguientes miembros.

  NombreDescripción
Método públicoMouseWheelEventArgsInicializa una nueva instancia de la clase MouseWheelEventArgs.
Arriba

  NombreDescripción
Propiedad públicaDeltaObtiene un valor que indica la medida en que ha cambiado la rueda del mouse.
Propiedad públicaDeviceObtiene el dispositivo de entrada que inició este evento. (Se hereda de InputEventArgs).
Propiedad públicaHandledObtiene o establece un valor que indica el estado presente del control de eventos para un evento enrutado cuando recorre la ruta. (Se hereda de RoutedEventArgs).
Propiedad públicaLeftButtonObtiene el estado actual del botón primario del mouse. (Se hereda de MouseEventArgs).
Propiedad públicaMiddleButtonObtiene el estado actual del botón central del mouse. (Se hereda de MouseEventArgs).
Propiedad públicaMouseDeviceObtiene el dispositivo de mouse asociado a este evento. (Se hereda de MouseEventArgs).
Propiedad públicaOriginalSourceObtiene el origen de notificación original tal como se determina en una mera prueba de aciertos, antes de cualquier posible ajuste de Source por parte de una clase primaria. (Se hereda de RoutedEventArgs).
Propiedad públicaRightButtonObtiene el estado actual del botón secundario del mouse. (Se hereda de MouseEventArgs).
Propiedad públicaRoutedEventObtiene o establece el RoutedEvent asociado a esta instancia de RoutedEventArgs. (Se hereda de RoutedEventArgs).
Propiedad públicaSourceObtiene o establece una referencia al objeto que ha producido el evento. (Se hereda de RoutedEventArgs).
Propiedad públicaStylusDeviceObtiene el dispositivo de lápiz óptico asociado a este evento. (Se hereda de MouseEventArgs).
Propiedad públicaTimestampObtiene la hora a la que se produjo este evento. (Se hereda de InputEventArgs).
Propiedad públicaXButton1Obtiene el estado actual del primer botón de mouse extendido. (Se hereda de MouseEventArgs).
Propiedad públicaXButton2Obtiene el estado del segundo botón de mouse extendido. (Se hereda de MouseEventArgs).
Arriba

  NombreDescripción
Método públicoEquals(Object)Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegidoFinalizePermite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoGetHashCodeActúa como función hash para un tipo concreto. (Se hereda de Object).
Método públicoGetPositionDevuelve la posición del puntero del mouse con respecto al elemento especificado. (Se hereda de MouseEventArgs).
Método públicoGetTypeObtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método protegidoInvokeEventHandlerInvoca los controladores de eventos de forma específica del tipo. De esta forma, se puede aumentar la eficacia del sistema de eventos. (Invalida a MouseEventArgs.InvokeEventHandler(Delegate, Object)).
Método protegidoMemberwiseCloneCrea una copia superficial del objeto Object actual. (Se hereda de Object).
Método protegidoOnSetSourceCuando se invalida en una clase derivada, proporciona un punto de entrada de devolución de llamada de notificación cada vez que cambia el valor de propiedad Source de una instancia. (Se hereda de RoutedEventArgs).
Método públicoToStringDevuelve una cadena que representa el objeto actual. (Se hereda de Object).
Arriba

MouseWheelEventArgs se utiliza con los eventos siguientes:

La propiedad Delta es positiva si la rueda del mouse se mueve hacia arriba o hacia adelante (alejándose del usuario) y es negativa si la rueda del mouse se mueve hacia abajo o hacia atrás (hacia el usuario).

Este evento se provoca incluso para pequeños movimientos de la rueda del mouse. Para algunos casos, se recomienda implementar controladores que limitan los pequeños valores delta de la rueda del mouse comprobando si el valor delta supera un umbral determinado. De lo contrario, podría invocar el controlador cuando el valor delta de la rueda del mouse es tan pequeño que no se actualizan las interfaces de usuario vinculadas al movimiento de la rueda del mouse. La implementación exacta del comportamiento del umbral en un controlador y la configuración del umbral dependen íntegramente de la implementación.

En el ejemplo siguiente se mueve hacia arriba un control TextBox si la propiedad Delta de la rueda del mouse es positiva y se mueve hacia abajo el control TextBox si la propiedad Delta de la rueda del mouse es negativa. El control TextBox está asociado a un control Canvas.


// Moves the TextBox named box when the mouse wheel is rotated.
// The TextBox is on a Canvas named MainCanvas.
private void MouseWheelHandler(object sender, MouseWheelEventArgs e)
{
    // If the mouse wheel delta is positive, move the box up.
    if (e.Delta > 0)
    {
        if (Canvas.GetTop(box) >= 1)
        {
            Canvas.SetTop(box, Canvas.GetTop(box) - 1);
        }
    }

    // If the mouse wheel delta is negative, move the box down.
    if (e.Delta < 0)
    {
        if ((Canvas.GetTop(box) + box.Height) <= (MainCanvas.Height))
        {
            Canvas.SetTop(box, Canvas.GetTop(box) + 1);
        }
    }

}


.NET Framework

Compatible con: 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
Mostrar: