MouseEventArgs.Delta Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém uma contagem assinada do número de detenções que a roda do rato rodou, multiplicada pela constante WHEEL_DELTA. Um detent é um entalhe da roda do rato.
public:
property int Delta { int get(); };public int Delta { get; }member this.Delta : intPublic ReadOnly Property Delta As IntegerValor de Propriedade
Uma contagem assinada do número de travas que a roda do rato rodou rodou, multiplicada pela constante WHEEL_DELTA.
Exemplos
O seguinte exemplo de código demonstra a utilização deste elemento. No exemplo, um gestor de eventos reporta a ocorrência do Control.MouseClick evento. Este relatório ajuda-o a saber quando ocorre o evento e pode ajudá-lo na depuração. Para reportar múltiplos eventos ou eventos que ocorrem frequentemente, considere substituir MessageBox.Show ou Console.WriteLine anexar a mensagem a uma multilinha TextBox.
Para executar o código de exemplo, cole-o num projeto que contenha uma instância de um tipo que herda de Control, como um Button ou ComboBox. Depois, nomeie a instância Control1 e assegure que o gestor de eventos está associado ao Control.MouseClick evento.
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
Observações
A roda do rato combina as funcionalidades de uma roda e um botão de rato. A roda tem entalhes discretos e espaçados uniformemente. Quando roda a roda, é enviada uma mensagem de roda à medida que cada entalhe é encontrada. Um entalhe de roda, um detent, é definido pela constante das janelas WHEEL_DELTA, que é 120. Um valor positivo indica que a roda foi rodada para a frente (afastada do utilizador); um valor negativo indica que a roda foi rodada para trás (em direção ao utilizador).
Atualmente, o valor de 120 é o padrão para um depósito. Se forem introduzidos ratos de maior resolução, a definição de WHEEL_DELTA pode tornar-se menor. A maioria das candidaturas deve verificar um valor positivo ou negativo em vez de um total agregado.
