FMX.TabControl.TTabControl.GotoVisibleTab

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function GotoVisibleTab(Index: Integer; ATransition: TTabTransition = TTabTransition.Slide;  const ADirection: TTabTransitionDirection = TTabTransitionDirection.Normal): Boolean;

C++

bool __fastcall GotoVisibleTab(int Index, TTabTransition ATransition = (TTabTransition)(0x1), const TTabTransitionDirection ADirection = (TTabTransitionDirection)(0x0));

Propriétés

Type Visibilité  Source Unité  Parent
function public
FMX.TabControl.pas
FMX.TabControl.hpp
FMX.TabControl TTabControl


Description

Définit l'onglet ayant la focalisation en utilisant la transition spécifiée. L'animation de la transition de basculement dépend des positions respectives de l'onglet ayant actuellement la focalisation et l'onglet spécifié.

GotoVisibleTab bascule l'onglet actif sur l'onglet spécifié par le paramètre Index si possible (l'onglet avec l'index spécifié existe et est visible). GotoVisibleTab bascule l'onglet actif en utilisant la transition de basculement spécifiée par les paramètres ATransition et ADirection et en prenant en compte les positions respectives de l'onglet en cours et de l'onglet spécifié par Index.

ATransition spécifie le type de transition utilisé pour basculer l'onglet. Lorsque ATransition = Slide, le contrôle onglet utilise l'animation visuelle pour l'action de basculement. C'est-à-dire que le déplacement de contenu dans les onglets basculés est animé. La valeur par défaut de ATransition est Slide.

ADirection spécifie la direction dans laquelle le contenu de l'onglet actif en cours est remplacé par le contenu de l'onglet Index spécifié. ADirection est pris en compte uniquement lorsque ATransition = Slide. GotoVisibleTab anime les transitions de basculement d'onglets en prenant en compte la position respective de l'onglet actuellement actif et de l'onglet spécifié par Index :

  • Lorsque ADirection = Normal. Si l'onglet de destination est à gauche de l'onglet actuellement actif (Index inférieur), l'animation de la transition de basculement en avant de gauche à droite des éléments onglets est utilisée. Si l'onglet à afficher est à droite de l'onglet actif (Index supérieur), l'animation de la transition de basculement en arrière de droite à gauche des éléments onglets est utilisée.
  • Quand ADirection = Reversed, les transitions de basculement utilisent les directions d'animations opposées à celles décrites ci-dessus.

La valeur par défaut de ADirection est Normal.

A la différence de SetActiveTabWithTransition, la méthode GotoVisibleTab anime la transition de basculement en fonction des positions respectives de l'onglet ayant actuellement la focalisation et l'onglet Index spécifié.

GotoVisibleTab renvoie True en cas de succès et False sinon.

Voir aussi