Difference between revisions of "ATTabs"

From Free Pascal wiki
Jump to navigationJump to search
(Category moved to template (for all languages))
(history link)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{ATTabs}}
 
{{ATTabs}}
  
= About =
+
== 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.
Line 11: Line 11:
 
Author: Alexey Torgashin
 
Author: Alexey Torgashin
  
= Help =
+
== History ==
  
GitHub page has help files, which describe most of events/properties. It also shows sample code how to create tabs at runtime. https://github.com/Alexey-T/ATTabs/tree/master/wiki
+
GitHub repo has the [https://github.com/Alexey-T/ATFlatControls/blob/master/history.txt history.txt file] which lists all major changes.
  
= How to use it like TPageControl=
+
== 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.
 
Make some new panel, which will be like TPageControl. Place ATTabs on it, make Align=alTop.
Line 26: Line 31:
 
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.
 
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.
  
<syntaxhighlight>
+
<syntaxhighlight lang="Pascal">
 
   var
 
   var
 
     d: TATTabData;
 
     d: TATTabData;
Line 36: Line 41:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
= License =
+
== License ==
  
 
License: MPL 2.0. Also you can use it under LGPL.
 
License: MPL 2.0. Also you can use it under LGPL.
  
= Download =
+
== Download ==
 
 
Latest version is always at https://github.com/Alexey-T/ATTabs
 
You can install it into IDE, or not do it (just copy file attabs.pas to your project).
 
 
 
= Requirements =
 
 
 
Lazarus: 1.6+.
 
  
Tested on: Windows, Linux GTK2/QT, macOS (10.8).
+
ATTabs is merged into ATFlatControls repo: https://github.com/Alexey-T/ATFlatControls/ .
 +
Some wiki documentation is in the "wiki" subfolder of that repo.

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.