FMX.Controls.TControl.HitTest
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.