FMX.TabControl.TTabControl.GotoVisibleTab
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));
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| function | public | FMX.TabControl.pas FMX.TabControl.hpp |
FMX.TabControl | TTabControl |
説明
フォーカスされたタブを、指定された移動方法設定します。 遷移のアニメーションは、現在フォーカスされているタブと指定されたタブの、複数のプロパティによって変わります。
GotoVisibleTab は、アクティブ タブを、Index パラメータで指定されたタブに切り替えます（それが可能な場合 -- Index で指定されたタブが存在し、かつそれが可視の場合）。GotoVisibleTab は、ATransition および ADirection パラメータで指定された切り替え遷移を利用し、現在のアクティブ タブと Index で指定されたタブの相互の位置関係を検討して、アクティブ タブを切り替えます。
ATransition は、タブの切り替えで使用される移動のタイプを指定することができます。 ATransition = Slide の場合、タブ コントロールは、アクションの切り替えのためにビジュアル アニメーションを使用します。つまり、スイッチ タブ内でのコンテンツの移動には、アニメーションが付きます。デフォルトの ATransition は Slide です。
ADirection は、現在のアクティブ タブのコンテンツが、指定された Index のタブのコンテンツと置き換わる際の方向を示します。ADirection は、ATransition = Slide の場合にのみ、検討されます。GotoVisibleTab は、現在のアクティブ タブと Index で指定されたタブの相互の位置を検討して、タブの切り替え遷移をアニメーションします。
ADirection = Normalの場合。遷移先タブが現在のアクティブ タブより左の場合（より小さいIndexの場合）、タブ項目の左から右への切り替え遷移アニメーションが使用されます。表示するタブが、アクティブ タブの右にある場合（より大きいIndexの場合）、逆方向の右から左へのタブ項目の切り替え遷移アニメーションが使用されます。ADirection = Reversedの場合、切り替え遷移は、上記で説明したものとは逆のアニメーション方向を使用します。
デフォルトの ADirection は Normal です。
SetActiveTabWithTransition とは異なり、GotoVisibleTab メソッドは、現在のフォーカスされているタブと指定された Index のタブとの相互の位置によって、切り替え遷移をアニメーションします。
GotoVisibleTab は、正常に終了した場合に True を、そうでなければ False を返します。