Difference between revisions of "ATTabs"

From Free Pascal wiki
Jump to navigationJump to search
(history link)
 
(27 intermediate revisions by 6 users not shown)
Line 1: Line 1:
= About =
+
{{ATTabs}}
 +
 
 +
== About ==
  
 
''ATTabs'' is a tab-control component for Delphi and Lazarus. It's not replacement for standard tab control, but is alternative one, it has different API. It paints tabs OS-indenendant, using custom drawing on canvas.
 
''ATTabs'' is a tab-control component for Delphi and Lazarus. It's not replacement for standard tab control, but is alternative one, it has different API. It paints tabs OS-indenendant, using custom drawing on canvas.
  
= Screenshot =
+
Screenshot:
  
 
[[File:ATTabs_demo.png]]
 
[[File:ATTabs_demo.png]]
  
= Bug reporting =
+
Author: Alexey Torgashin
 +
 
 +
== History ==
 +
 
 +
GitHub repo has the [https://github.com/Alexey-T/ATFlatControls/blob/master/history.txt history.txt file] which lists all major changes.
  
Please add your wishes and bug reports to [https://github.com/Alexey-T/ATTabs/issues Github issues page].
+
== Requirements ==
  
= Author =
+
* Lazarus: 1.8+.
 +
* Tested on: Windows, Linux GTK2/Qt, macOS.
  
Alexey Torgashin (Russia).
+
== How to use it like TPageControl ==
  
= License =
+
Make some new panel, which will be like TPageControl. Place ATTabs on it, make Align=alTop.
 +
Now you create several Forms or Frames onto this panel (they have Parent:=Panel1; Align:=alClient;).
 +
How to switch these frames on changing tabs?
  
MPL 2.0.
+
* Add tabs OnChange event handler.
 +
* In this event handler: a) hide all frames, b) show frame, which is assigned to current TabIndex.
  
= Download =
+
When you create a new tab, you can set its TabObject property. Set TabObject to a frame. When OnChange is called, get TabIndex, call GetTabData() for this index, and read TabObject for this tab. Show the frame, which is stored in this TabObject, hide all others.
  
Latest version, with demo app, is always at [https://github.com/Alexey-T/ATTabs Github page].
+
<syntaxhighlight lang="Pascal">
 +
  var
 +
    d: TATTabData;
 +
  begin
 +
    d:= t.GetTabData(t.TabIndex);
 +
    if Assigned(d) then
 +
      (d.TabObject as TMyFrame).Show;
 +
  end;
 +
</syntaxhighlight>
  
= System requirements =
+
== License ==
  
- Lazarus: 1.2.0
+
License: MPL 2.0. Also you can use it under LGPL.
- Tested on: Windows 7, Linux (Ubuntu)
 
  
= Installation =
+
== Download ==
  
- Download the zip package
+
ATTabs is merged into ATFlatControls repo: https://github.com/Alexey-T/ATFlatControls/ .
- No installation into Lazarus needed, just unpack file ATTabs.pas to any folder.
+
Some wiki documentation is in the "wiki" subfolder of that repo.
- Component doesn't support Lazarus designer, you need to create object at runtime.
 

Latest revision as of 17:10, 26 March 2021

Deutsch (de) English (en) русский (ru)

About

ATTabs is a tab-control component for Delphi and Lazarus. It's not replacement for standard tab control, but is alternative one, it has different API. It paints tabs OS-indenendant, using custom drawing on canvas.

Screenshot:

ATTabs demo.png

Author: Alexey Torgashin

History

GitHub repo has the history.txt file which lists all major changes.

Requirements

  • Lazarus: 1.8+.
  • Tested on: Windows, Linux GTK2/Qt, macOS.

How to use it like TPageControl

Make some new panel, which will be like TPageControl. Place ATTabs on it, make Align=alTop. Now you create several Forms or Frames onto this panel (they have Parent:=Panel1; Align:=alClient;). How to switch these frames on changing tabs?

  • Add tabs OnChange event handler.
  • In this event handler: a) hide all frames, b) show frame, which is assigned to current TabIndex.

When you create a new tab, you can set its TabObject property. Set TabObject to a frame. When OnChange is called, get TabIndex, call GetTabData() for this index, and read TabObject for this tab. Show the frame, which is stored in this TabObject, hide all others.

  var
    d: TATTabData;
  begin
    d:= t.GetTabData(t.TabIndex);
    if Assigned(d) then
      (d.TabObject as TMyFrame).Show;
  end;

License

License: MPL 2.0. Also you can use it under LGPL.

Download

ATTabs is merged into ATFlatControls repo: https://github.com/Alexey-T/ATFlatControls/ . Some wiki documentation is in the "wiki" subfolder of that repo.