B4A Library [Class] Flexible Table

This thread will be used by Erel, Melamoud and myself to discuss / post new releases of the Table class.

The table class is a flexible UI component that enable scrollable table like UI, with sortable columns, multiselect rows etc

the table is very efficient, maintaining labels only for visible rows

old thread with details : http://www.b4x.com/forum/additional...view-supports-tables-any-size.html#post110901

The class depend on following libraries:
- StringUtils (standard)
- SQL (standard)
- JavaObject (standard)
- B4XCollections (standard)
- ScrollView2D (additional)

List of major features.
1. scrollable table UI
2. sortable columns
3. select a row, cell or multi select rows
4. callback for selection / click a cell / row
5. callback for long click action
6. read / write to CSV file

Current version --> 3.35 Custom View
Current version --> 1.44 Class

Other complementary routines:

Load data with the Remote Database Connector.


EDIT: LucaMs has written a routine to fill a table with a Remote Database Connector query result see post 182.
The routine hasn't been added into the Class for the reasons explained in post 183.
A sample program can be found HERE.

Code:
B4X:
'load data from a RDC Request
'Result = DBResult object got from a RDC request
'AutomaticWidths  True > set the column widths automaticaly
'Written by LucasMs
Public Sub LoadRDCResult(Result As DBResult, AutomaticWidths As Boolean)
    cAutomaticWidths = AutomaticWidths
    NumberOfColumns = Result.Columns.Size
    innerClearAll(NumberOfColumns)

    Dim Headers(NumberOfColumns) As String
    Dim ColumnWidths(NumberOfColumns) As Int
    Dim HeaderWidths(NumberOfColumns) As Int
    Dim DataWidths(NumberOfColumns) As Int
    Dim col, row As Int
    Dim str As String
    For col = 0 To NumberOfColumns - 1
        Headers(col) = Result.Columns.GetKeyAt(col)
        If AutomaticWidths = False Then
            ColumnWidths(col) = 130dip
            HeaderWidths(col) = 130dip
            DataWidths(col) = 130dip
        Else
            HeaderWidths(col) = cvs.MeasureStringWidth(Headers(col), Typeface.DEFAULT, cTextSize) + 8dip + cLineWidth
            DataWidths(col) = 0

            Dim FieldValue As Object
            For row = 0 To Result.Rows.Size - 1
                Dim Record() As Object = Result.Rows.Get(row)
                FieldValue = Record(col)
                If GetType(FieldValue) = "java.lang.String" Then
                    DataWidths(col) = Max(DataWidths(col), cvs.MeasureStringWidth(str, Typeface.DEFAULT, cTextSize) + 8dip + cLineWidth)
                End If
            Next
            ColumnWidths(col) = Max(HeaderWidths(col), DataWidths(col))
        End If
    Next
    SetHeader(Headers)
    SetColumnsWidths(ColumnWidths)

    For Each Record() As Object In Result.Rows
        Dim R(NumberOfColumns) As String
        Dim FieldV As String
        For col = 0 To NumberOfColumns - 1
            FieldV = Record(col)
            R(col) = FieldV
        Next
        AddRow(R)
    Next
End Sub

This is another routine updated by cimperia in post #392 using a Map for the columns and a List for the rows.
B4X:
'load data from a RDC Request
'A RDC request returns a DBResult object, therefore this method
'could be called as is:
'LoadRDCResult(DBResult.Columns, DBResult.Rows, True)
'AutomaticWidths  True > set the column widths automaticaly
'Written by LucasMs
Public Sub LoadRDCResult(Columns As Map, Rows As List, AutomaticWidths As Boolean)
  cAutomaticWidths = AutomaticWidths
  NumberOfColumns = Columns.Size
  innerClearAll(NumberOfColumns)

  Dim Headers(NumberOfColumns) As String
  Dim ColumnWidths(NumberOfColumns) As Int
  Dim HeaderWidths(NumberOfColumns) As Int
  Dim DataWidths(NumberOfColumns) As Int
  Dim col, row As Int
  Dim str As String
  For col = 0 To NumberOfColumns - 1
    Headers(col) = Columns.GetKeyAt(col)
    If AutomaticWidths = False Then
      ColumnWidths(col) = 130dip
      HeaderWidths(col) = 130dip
      DataWidths(col) = 130dip
    Else
      HeaderWidths(col) = cvs.MeasureStringWidth(Headers(col), Typeface.DEFAULT, cTextSize) + 8dip + cLineWidth
      DataWidths(col) = 0

      Dim FieldValue As Object
      For row = 0 To Rows.Size - 1
        Dim Record() As Object = Rows.Get(row)
        FieldValue = Record(col)
       If GetType(FieldValue) = "java.lang.String" Then
         DataWidths(col) = Max(DataWidths(col), cvs.MeasureStringWidth(str, Typeface.DEFAULT, cTextSize) + 8dip + cLineWidth)
       End If
      Next
      ColumnWidths(col) = Max(HeaderWidths(col), DataWidths(col))
    End If
  Next
  SetHeader(Headers)
  SetColumnsWidths(ColumnWidths)

  For Each Record() As Object In Rows
    Dim R(NumberOfColumns) As String
    Dim FieldV As String
    For col = 0 To NumberOfColumns - 1
      FieldV = Record(col)
      R(col) = FieldV
    Next
    AddRow(R)
  Next
End Sub


Load data from a MSMariaDB database.

Another routine for loading data from a MSMariaDB database can be found in post#727.
Thanks to @Magma.

Updates:
EDIT: 2024.04.21 Version 3.35
Replaced the original sorting functions by new ones kindly provided by forum member RB Smissaert.
Amended first scroll scrolling back to 0
Amended Header with transparent color

EDIT: 2024.01.13 Version 3.33
Changed possible values for DataType
TEXT and NUMBER become T, R and I
Amended problem with column colors
Amended problems with SetHeaderColors and SetHeaderTextColors

Version 3.32
Amended Header and HeaderFirst problem in SaveCSVFromTable
Moved If (lblStatusline... from AddRow to ShowRow

Version 3.31
Added SingleLine property for the Designer
Added StatusLineHeight as a property
Added FastScrollLabelMaxChars as a property

EDIT: 2021.06.28 Version 3.30
Added a check for none numeric values for numeric sorting.

EDIT: 2021.06.28 Version 3.29
Amended problem with column colors
Version 3.28
Added NumberOfColumns in the code
Added TopRowIndex method
Version 3.27
Amended MultiSelect EDIT: 2020.09.02 Version 3.26
Amended problem with sort with remove accents
Amended problem with SetRowColorN
Added SetCellAlignmentColN method
Added SetHeaderAlignmentColN method

EDIT: 2020.08.05 Version 3.24
Amended problem with JumpToRowAndSelect not being selected.
Amended error when setting RowHeight before the table initialized

EDIT: 2020.06.19 Version 3.22
Amended error in the insertRowAt routine.

EDIT: 2020.05.25 Version 3.21
Amended bug with TextSize in fixed columns

EDIT: 2020.05.16 Version 3.20
Added fast scroll feature
Version 3.19
Improved automatic width calculation and hidden columns
Version 3.18
Added a check in RemoveRowColorN to ensure that Row is not out of bounds
Added ShowRow event
Amended automatic width calculations
Amended hidden column width problem

EDIT: 2020.04.21 Version 3.17
Amended HeaderHight problem with fixed columns

EDIT: 2020.04.21 Version 3.16
Amended two errors.

EDIT: 2020.04.14 Version 3.14
Added the methods below
- LoadSQLiteDB4(SQLite As SQL, Query As String, AutomaticWidths As Boolean)
loads SQLite data with data type checking
- LoadSQLiteDB5(SQLite As SQL, Query As String, Values() As String, AutomaticWidths As Boolean).
loads SQLite data with data type checking , similar to LoadSQLiteDB4 but for parametrized queries.
- GetColumnDataTypes As String(), returns an Array with the data type for each column.
- GetColumnDataType(Column As Int) As String, returns the data type of the fiven column.
Added the InnerTotalWidth property, read only.
Added multiple first fiexed columns
Added line colors

EDIT: 2020.03.10 Version 3.10
Amended bug reported HERE

EDIT: 2020.03.06 Version 3.09
Amended bug reported HERE.

EDIT: 2020.02.29 Version 3.08
Amended SetHeaderTypefaces method problem reprted HERE.
Added HeaderTypeface property.

EDIT: 2020.01.08 Version 3.07
Amended bug ShowStatisLine = False property bug.
Added MultiSelect property to Designer properties.
You need to open and close the Designer when you use the new version the first time to make the MultiSelect property active.

EDIT: 2019.12.28 Version 3.06
Amened some bugs

EDIT: 2019.12.25 Version 3.05
Added FirstColumnFixed property which allows to fix the first column.
Attention: You need to open and close the Designer to make the new property active.

EDIT: 2019.11.15 Version 3.04
- Added SelectedRowTextColor and SlectedCellTextColor properties
- Added ZeroSelections property, True > when a selected row is pressed it will be unselected False > it remains selected.

EDIT: 2019.11.12 Version 3.03
- Changed JumpToRowAndSelect(Row As Int, Col As Int) to JumpToRowAndSelect(Col As Int, Row As Int)
- Changed LoadSQLiteDB2 signature. Replaced the possible values from "T", "I", "R" to "TEXT", "NUMBER" for coherence with SetColumnDataTypes.
- Added internal sorting bitmaps, avoids loading the image files into the Files folder.
- Added two new properties: SortBitmapWidth and SortBitmapColor.
- Added SetCustomSortingBitmaps method, which allows to use custom bitmaps instead of the internal ones.
Attention: You need to open and close the Designer to make the new properties active.
Attention: You need to invert the parameters in JumpToRowAndSelect.

EDIT: 2019.07.04 Version 3.02
Amended error reported in post #887

EDIT: 2019.06.26 Version 3.01
Amended SingleLine property setting in the code

EDIT: 2019.04.05 Version 3.00
Amended SetColumnColors and SetTextColors
Removed Reflection library dependency

EDIT: 2018.04.11 Version 2.29
Version 2.27
set the two variables sortedCol and sortingDir to Public instaed of Private
added RemoveAccent routine for sorting with accented characters
Version 2.28
Added SetHeaderTypeFaces
Added SortRemoveAccents property
Version 2.29
Added SaveTableToCSV2 with a user defined separator character

EDIT: 2018.04.11 Version 2.26
added LoadSQLiteDB3 method using SQLExec2 instead of SQLExec
The query can include question marks which will be replaced with the values in the array.

EDIT: 2018.03.27 Version 2.25
amended minor errors
added UpdateCell method

EDIT: 2017.11.19 Version 2.22
improved JumpToRowAndSelect scrolls horizontally to the selected column
improved setHeaderHeight
added padding for status bar Label

EDIT: 2017.06.27 Version 2.19
Replaced DoEvents by Sleep(0)
Asked HERE

EDIT: 2017.06.27 Version 2.19
Replaced DoEvents by Sleep(0)
Asked HERE

EDIT: 2017.05.16 Version 2.18
Amended error reported HERE.

EDIT: 2017.03.09 Version 2.17
Amended error reported HERE.

EDIT: 2017.03.09 Version 2.15
Amended error reported here, Event signatures
#Event: CellClick(col As Int, row As Int)
#Event: CellLongClick(col As Int, row As Int)

EDIT: 2016.12.05 Version 2.14
Added NumberOfColumns and NumberOfRows as Public variables.
Amended error reported here.

EDIT: 2016.12.05 Version 2.13
Amended error reported here.
Added NumberOfColumns as a property for the Designer.

EDIT: 2016.07.30 Version 2.10
Amended error with TextAlignment and HeaderTextAlignment reported in post #606

EDIT: 2016.03.15 Version 2.00
Added CustomView support.
This version can be compiled into a library.
Changes between the previous versions and version 2.00
For a Table added in the Designer, this is new
No need to initialize nor add it onto a parent view
'For a Table added in the Designer, this is new
'No need to initialize nor add it onto a parent view

For a Table added in the code:
The Initialize routine has been splittend into two routines.
New:
Initialize (CallBack As Object, EventName As String)
InitializeTable (vNumberOfColumns As Int, cellAlignement As Int, showStatusL As Boolean)

'Example:
Table1.Initialize(Me, "Table1")
Table1.InitializeTable(5, Gravity.CENTER_HORIZONTAL, True)


Old:
Initialize(CallBack As Object, EventName As String, vNumberOfColumns As Int, cellAlignement As Int, showStatusL As Boolean)
Example:
Table1.Initialize(Me, "Table1", 5, Gravity.CENTER_HORIZONTAL, True)

EDIT: 2015.04.29 Version 1.43
As the modifications in LoadSQLiteDB don't work in all cases I went back.
LoadSQLiteDB as in version 1.40
Added LoadSQLiteDB2 where the column data types must be given.

EDIT: 2015.04.26 Version 1.42
Changed he LoadSQLiteDB routine, version 1.41 didn't work as expected.
The final solution was suggested by cimperia HERE.

EDIT: 2015.04.16 Version 1.41
Changed the LoadSQLiteDB routine according to the error reported in the SQL issue thread
and the SQLite Cursor GetString versus GetDouble thread.
The problem appears with numbers bigger than 999999.
I left version 1.40 in case of problems.
I tested it with a few databases, but I am not sure if it works in all cases.

EDIT: 2015.03.05
Amended bugs reported in posts #383 and #386
Added SetAutomaticWidths routine

EDIT: 2015.02.19
Amended the problem alignment reported in post # 378

EDIT: 2015.02.13
Amended the problem of rows not shown reported in post # 371

EDIT: 2015.01.09
Added header aligments

EDIT: 2014.08.14
Added HeaderHeight property
Amended RowColor problem reported in post #260

EDIT: 2014.08.10
Added SortColumn property asked in post #266
Added UseColumnColors ColumnColors and HeaderColors propeties

EDIT: 2014.05.10 Added RowHeight as a property

Screenshot:

1589638570453.png
 

Attachments

  • TableV1_44.zip
    44.8 KB · Views: 2,214
  • 1589638550715.png
    1589638550715.png
    31.8 KB · Views: 1,639
  • TestFastScroll.zip
    50.6 KB · Views: 1,486
  • TableV3_35.zip
    110 KB · Views: 306
  • Table.bas
    152.2 KB · Views: 221
Last edited:
It went much faster than expected, here is the first version of Table.SaveToJson:
SaveToJson:
'Save data to a JSON String
'Returns as String, that can be parsed as a JSON
Public Sub SaveToJson() As String
   
    Dim Json As JSONGenerator
    Dim JsonMapList As List
    Dim JsonMap As Map
    Dim rowcntr As Int
    Dim colcntr As Int
    Dim RowSet(mNumberOfColumns) As String

    JsonMapList.Initialize
    For rowcntr=0 To Data.Size-1
        JsonMap.Initialize
        RowSet = Data.Get(rowcntr)
        For colcntr=0 To mNumberOfColumns-1
            JsonMap.Put(HeaderNames.Get(colcntr),RowSet(colcntr))
        Next
        JsonMapList.Add(JsonMap)
    Next
    Json.Initialize2(JsonMapList)
    Return Json.ToString
End Sub
 

Attachments

  • screenshot2.PNG
    screenshot2.PNG
    67.1 KB · Views: 345
  • screenshot3.PNG
    screenshot3.PNG
    42.2 KB · Views: 336

klaus

Expert
Licensed User
Longtime User
Thank you.
I will add your routines in the first post.
I don't want to add them into the Class because it needs an additional library and I don't want to oblige each user of the table to add the JSON library.
The same as I did for the Load data with the Remote Database Connector routine.
 
Hello Klaus,
I think, in the actual version it is not possible, to fill the table only with headers, in order to show a user, that there is no data yet. Can you pls help me.
This is what I tried:
Sub SetHeadersOnly:
'Set the headers and empties a Table
'Headers = Array of the Headers
'ColWidths = Array of Column Widths
'AutomaticWidths  True > set the column widths automaticaly
'In Class Table
Public Sub SetHeadersOnly(Headers() As String, ColWidths() As Int, AutomaticWidths As Boolean)
    cAutomaticWidths = AutomaticWidths
    mNumberOfColumns = Headers.Length
    If Headers.Length <> ColWidths.Length Then
        Return
    End If
    innerClearAll(mNumberOfColumns, True)
    SetHeader(Headers)
    SetColumnsWidths(ColumnWidths)
End Sub


'Call the routine Outside of Table
    Dim HeaderNames() As String = (Array As String("ArtikelNr", "Bezeichnung", "Bezeichnung2", "Bezeichnung3", "SachNr"))
    Dim ColumnWidths() As Int = ( Array As Int(150dip, 300dip, 300dip, 300dip,300dip))
    Table1.SetHeadersOnly(HeaderNames, ColumnWidths, False)

In line 1411 of Table I got this Java exception.
How can I initialize the table for more than 3 Columns?
 

Attachments

  • screenshot1.PNG
    screenshot1.PNG
    175.3 KB · Views: 290

Diceman

Active Member
Licensed User
No, it works only with B4A.
Erel has written the B4XTable cross-platform b4xlib, which is a 'standard' library.

Klaus,

Is there a technical reason why Flexible Table won't work in B4J or B4i? Apart from not being tested on those platforms.

TIA
 

klaus

Expert
Licensed User
Longtime User
Is there a technical reason why Flexible Table won't work in B4J or B4i?
Yes, because there is no bidirectional view in B4A.
And for me, a Table view MUST have a bidirectional object.
In B4A you have Scrollview only vertical and HorizontalScrollView only horizontal.
In B4J and B4i the ScollViews are bidiractional.
The Flexible Table uses the ScrollView2D library, written by Informatix, to have bidirectional scrolling,valid only in B4A.
I once asked Erel, if ScrollView2D could become a B4XView, but with no success.
Without this no chance.
Even though it would be a big change.
 
Last edited:

vecino

Well-Known Member
Licensed User
Longtime User
I wish "Flexible table" would work in B4J, it is a very functional grid.
It's not that "B4Xtable" is bad, but at the moment I think it lacks many options that are necessary in the day to day work to solve all the requests that customers ask.
Of course, the ideal would be a grid associated with a dataset, like the Delphi DBGrid, for example.
 

Diceman

Active Member
Licensed User
Yes, because there is no bidirectional view in B4A.
And for me, a Table view MUST have a bidirectional object.
In B4A you have Scrollview only vertical and HorizontalScrollView only horizontal.
In B4J and B4i the ScollViews are bidiractional.
The Flexible Table uses the ScrollView2D library, written by Infromatix, to have bidirectional scrolling,valid only in B4A.
I once asked Erel, if ScrollView2D could become a B4XView, but with no success.
Without this no chance.
Even though it would be a big change.

Thanks for the explanation. :)
I've been playing with FlexibleTable and have made quite a few code changes to it to suit a custom purpose. It is nice and fast and having source code makes it, excuse the pun, flexible. Not being able to run it in B4J and B4i is a kick in the pants. I'm not sure why there isn't a bidirectional scrollview in B4A.

B4XTable does not have source code so I can't get it to do what I'd like it to do.
I may end up writing my own Table component from scratch just to have the source code so I can tweak it. :mad:

Thanks again for your efforts in creating FlexibleTable.
 

AnandGupta

Expert
Licensed User
Longtime User
B4XTable does not have source code so I can't get it to do what I'd like it to do.
It has.

It is a .b4xlib library which is basically a zip file.
Rename, Unzip, Change, Zip, Rename-back
Simple.

Regards,

Anand
 

Diceman

Active Member
Licensed User
I wish "Flexible table" would work in B4J, it is a very functional grid.
It's not that "B4Xtable" is bad, but at the moment I think it lacks many options that are necessary in the day to day work to solve all the requests that customers ask.
Of course, the ideal would be a grid associated with a dataset, like the Delphi DBGrid, for example.

I have been mulling this over for the past couple of years. It would not be limited to just B4XTable, but all views could be linked to a TDatasource like class that would retrieve, save, sort and filter rows from a table automatically. The TDatasource would of course be linked to a TQuery class. It would make working with datasets soooo much easier instead of having to do it manually through code. Working with B4X and updating views with data from an SQL table is like working with Delphi and displaying the results in a TStringGrid which is like working with stone age tools. It drives me bananas. o_O
 

Diceman

Active Member
Licensed User
It has.

It is a .b4xlib library which is basically a zip file.
Rename, Unzip, Change, Zip, Rename-back
Simple.

Regards,

Anand

But it is Java code, and I need to write it in B4X code.
 

Diceman

Active Member
Licensed User
Yes, because there is no bidirectional view in B4A.
And for me, a Table view MUST have a bidirectional object.
In B4A you have Scrollview only vertical and HorizontalScrollView only horizontal.
In B4J and B4i the ScollViews are bidiractional.
The Flexible Table uses the ScrollView2D library, written by Informatix, to have bidirectional scrolling,valid only in B4A.
I once asked Erel, if ScrollView2D could become a B4XView, but with no success.
Without this no chance.
Even though it would be a big change.

This reminded me of a problem I had a couple of years ago when I was creating a view that needed to scroll in 2 directions. Although it wasn't a grid like your FlexibleTable, it did have column titles and a scrollview underneath it. Like you, I needed to make the scrollview scroll horizontally as well as vertically. I came up with a solution that worked for me.

I put the column titles on a HorizontalScrollView (HSV) and the data on a ScrollView (SV) underneath it. The titles don't scroll vertically so there is no need to put them in the SV at all. These are 2 separate views and neither are parents of the other. The title widths and positions match up with the data columns in the ScrollView. To scroll horizontally the user simply scrolls the titles left or right and the data columns will scroll with it. This is achieved using the HSV ScrollChanged event to reposition the SV.Left to match that of the HSV.Position. (I may have put the SV on a panel and change the panel's left position instead of the SV Left position-not sure). There was about a 1/4 second lag for the SV to catch up with the HSV position but it wasn't that noticeable. The main thing was the user can scroll both horizontally and vertically and it looks like a single view is doing it.

This worked quite well. There is a minor inconvenience of using the titles to scroll left and right, but the user soon gets used to it. It should be compatible with B4A, B4i, B4J.
I thought this might help. ;)
 

Kanne

Member
Licensed User
Longtime User
sorry, but I can't follow the discussion:
at B4A we can scroll in 2 directions via ScrollView2D which is also possible in B4J and B4i without extensions.
So in all modules it is possible to scroll 2D - Erel does not use 2D scrolling in his B4X table example and instead calculates the show row according to the activity height
(and uses pages to go down in data). This may be usefull for showing / filtering big tables, but I think it should also be possible (as in flexible table) to show tables with 2D-scrolling.
So it's 'only' a lot of work to write a class for all platforms using either the internal 2D functionality or an addon ...
 

klaus

Expert
Licensed User
Longtime User
@Dieceman
In the Table class, the headers are on a separate Panel which is moved according to the horizontal position of the ScrollView2D.
In B4A it is possible to add a HorizontalScrollview onto the internal Panel of a Scrollview, or vice and versa, and this woks.
But it needs to get used to it because you can either scroll horizontally or vertically but not in both direction at the same time.
The OS detects the scrolling at beginning and selects the predominat direction.
And it needs a specific event handling, one for each Scrollview. But, anyway, for me, this would be a workaround and not a solution.

@Kanne
So it's 'only' a lot of work to write a class for all platforms using either the internal 2D functionality or an addon ...
That's it.

I don't want to port the B4A Flexible Table to B4i nor to B4J with a different handling of the scrolling.
And, as already mentioned, even with a 'standard' 2D scrollview for B4X it would be a very big change.
 
Hello @klaus,

I'm afraid that I found a bug in the sub insertRowAt.
In my App I call the sub

Table1.insertRowAt(1, Array As String("1", "2", "3", "4", "5", "6", "7", "8"))
It does not matter whether inserting at 1 or another existing row.

Where table1 has 13 rows (0...12)

in the following sub ShowRow is called with row# 13 (that does not exist) and subsequently causing JAVA crash

Here are my screeshots:

Can you help me out?
 

Attachments

  • screenshot1.png
    screenshot1.png
    44.3 KB · Views: 283
  • screenshot2.png
    screenshot2.png
    36.7 KB · Views: 283
  • screenshot3.png
    screenshot3.png
    7.8 KB · Views: 272
  • screenshot4.png
    screenshot4.png
    107.7 KB · Views: 278
Top