FMX.Controls.TControl.HitTest

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property HitTest: Boolean read FHitTest write SetHitTest default True;

C++

__property bool HitTest = {read=FHitTest, write=SetHitTest, default=1};

Propriétés

Type Visibilité  Source Unité  Parent
property public
FMX.Controls.pas
FMX.Controls.hpp
FMX.Controls TControl


Description

Active le contrôle pour capturer les événements de souris.

  • Si vous définissez HitTest sur True, le contrôle capture tous les événements de souris. L'exemple ci-dessous illustre l'utilisation de HitTest pour un événement OnClick.
  • Si vous définissez HitTest sur False, les événements de souris passeront par ce contrôle, afin qu'un contrôle disposé derrière ce contrôle reçoive les événements de la souris à la place de celui-ci.
Remarque : HitTest active tous les événements associés à la souris, ce qui inclut également l'affichage de Hints et des événements associés à Hint.

Pour la plupart des contrôles, HitTest est défini sur True par défaut. Toutefois, ce n'est pas le cas pour tous les contrôles. Par exemple, pour TLabel et TPathLabel, HitTest est défini sur False par défaut, ces deux contrôles ne capturent pas les événements associés à la souris à moins que vous définissiez HitTest sur True.

Exemple de HitTest

1. Placez un composant TPanel sur une fiche.

2. Placez un composant TPathLabel à l'intérieur d'un panneau.

3. Implémentez l'événement OnClick pour TPanel et TPathLabel :

procedure TForm1.Panel1Click(Sender: TObject);
begin
  ShowMessage('OnClick event fired for TPanel');
end;
procedure TForm1.PathLabel1Click(Sender: TObject);
begin
  ShowMessage('OnClick event fired for TPathLabel');
end;

4. Définissez la propriété HitTest de TPathLabel sur False (le paramètre par défaut). Exécutez l'application et cliquez sur le libellé. L'événement OnClick est déclenché pour le panneau (et non pour le libellé).

5. Définissez la propriété HitTest de TPathLabel sur True. Exécutez l'application et cliquez sur le libellé. L'événement OnClick est déclenché pour TPathLabel.

Voir aussi