Vcl.Controls.TControl.DoMouseWheel

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function DoMouseWheel(Shift: TShiftState; WheelDelta: Integer;  MousePos: TPoint): Boolean; dynamic;

C++

DYNAMIC bool __fastcall DoMouseWheel(System::Classes::TShiftState Shift, int WheelDelta, const System::Types::TPoint &MousePos);

Propriétés

Type Visibilité  Source Unité  Parent
function protected
Vcl.Controls.pas
Vcl.Controls.hpp
Vcl.Controls TControl

Description

Traite le déplacement de la molette de la souris.

DoMouseWheel est appelée automatiquement quand l'utilisateur tourne la molette de la souris.

Le paramètre Shift indique l'état actuel des touches Maj, Alt et Ctrl.

Le paramètre WheelDelta indique la distance parcourue par la molette. WheelDelta est positive si la souris a été tournée vers le haut, négative si elle a été tournée vers le bas.

Le paramètre MousePos indique la position actuelle du pointeur de la souris.

DoMouseWheel renvoie true si un gestionnaire d'événement a été trouvé et indique qu'il a géré l'événement.

Telle qu'implémentée dans TControl , DoMouseWheel commence par essayer d'appeler le gestionnaire d'événement OnMouseWheel. Si cette routine existe et gère correctement l'événement, DoMouseWheel renvoie true. Sinon, DoMouseWheel appelle DoMouseWheelUp ou DoMouseWheelDown à plusieurs reprises, selon la direction dans laquelle l'utilisateur a tourné la molette de la souris. Ensuite, ces routines appellent le gestionnaire d'événement OnMouseWheelUp ou OnMouseWheelDown.

Avant le premier appel à DoMouseWheelDown ou DoMouseWheelUp, DoMouseWheel ajoute WheelDelta à la propriété WheelAccumulator. Après chaque appel, DoMouseWheel ajuste WheelAccumulator vers zéro ; chaque ajustement est réalisé par une constante interne qui définit le déplacement significatif minimum de la molette. Quand la valeur absolue de WheelAccumulator est inférieure à la valeur de cette constante, DoMouseWheel se termine, en renvoyant la valeur renvoyée par l'appel final à DoMouseWheelDown ou DoMouseWheelUp.

Voir aussi