MouseEventArgs.Delta Propriedade

Definição

Obtém uma contagem com sinal do número de detentores que a roda do mouse girou, multiplicado pela constante WHEEL_DELTA.Gets a signed count of the number of detents the mouse wheel has rotated, multiplied by the WHEEL_DELTA constant. Um detentor é um ponto da roda do mouse.A detent is one notch of the mouse wheel.

public:
 property int Delta { int get(); };
public int Delta { get; }
member this.Delta : int
Public ReadOnly Property Delta As Integer

Valor da propriedade

Uma contagem com sinal do número de detentores que a roda do mouse girou, multiplicado pela constante WHEEL_DELTA.A signed count of the number of detents the mouse wheel has rotated, multiplied by the WHEEL_DELTA constant.

Exemplos

O exemplo de código a seguir demonstra o uso desse membro.The following code example demonstrates the use of this member. No exemplo, um manipulador de eventos relata a ocorrência do Control.MouseClick evento.In the example, an event handler reports on the occurrence of the Control.MouseClick event. Este relatório ajuda você a aprender quando o evento ocorre e pode ajudá-lo na depuração.This report helps you learn when the event occurs and can assist you in debugging. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir MessageBox.Show Console.WriteLine ou anexar a mensagem a uma multilinha TextBox.To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Para executar o código de exemplo, Cole-o em um projeto que contém uma instância de um tipo que Controlherda de, como Button um ComboBoxou.To run the example code, paste it into a project that contains an instance of a type that inherits from Control, such as a Button or ComboBox. Em seguida, nomeie Control1 a instância e verifique se o manipulador de eventos está Control.MouseClick associado ao evento.Then name the instance Control1 and ensure that the event handler is associated with the Control.MouseClick event.

private void Control1_MouseClick(Object sender, MouseEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Button", e.Button );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Clicks", e.Clicks );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "X", e.X );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Y", e.Y );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Delta", e.Delta );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Location", e.Location );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "MouseClick Event" );
}
Private Sub Control1_MouseClick(sender as Object, e as MouseEventArgs) _ 
     Handles Control1.MouseClick

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Button", e.Button)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Clicks", e.Clicks)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "X", e.X)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Y", e.Y)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Delta", e.Delta)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Location", e.Location)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"MouseClick Event")

End Sub

Comentários

A roda do mouse combina os recursos de uma roda e um botão do mouse.The mouse wheel combines the features of a wheel and a mouse button. A roda tem entalhes discretos e uniformemente espaçados.The wheel has discrete, evenly spaced notches. Quando você gira a roda, uma mensagem de roda é enviada à medida que cada entalhe é encontrado.When you rotate the wheel, a wheel message is sent as each notch is encountered. Um entalhe de roda, uma retenções, é definido pela constante do Windows WHEEL_DELTA, que é 120.One wheel notch, a detent, is defined by the windows constant WHEEL_DELTA, which is 120. Um valor positivo indica que a roda foi girada para frente (longe do usuário); um valor negativo indica que a roda foi girada para trás (em direção ao usuário).A positive value indicates that the wheel was rotated forward (away from the user); a negative value indicates that the wheel was rotated backward (toward the user).

Atualmente, um valor de 120 é o padrão para uma deintenções.Currently, a value of 120 is the standard for one detent. Se os mouses de resolução mais alta forem introduzidos, a definição de WHEEL_DELTA poderá se tornar menor.If higher resolution mice are introduced, the definition of WHEEL_DELTA might become smaller. A maioria dos aplicativos deve verificar um valor positivo ou negativo em vez de um total agregado.Most applications should check for a positive or negative value rather than an aggregate total.

Aplica-se a

Veja também