The constructor for the Fl_Table. This creates an empty table with no rows or columns, with headers and row/column resize behavior disabled.

The destructor for the Fl_Table. Destroys the table and its associated widgets.

int Fl_Table::child_start()
int Fl_Table::child_end()

When using the Fl_Table as a container for fltk widgets, these methods return the start/end index of the Fl_Table::children() array, so as to access the child fltk widgets.

Using these values is necessary to ensure the caller doesn't accidentally access the Fl_Table's internal widgets (such as the scroll bars).

Typically used in loops, eg:

        for ( int x = child_start(); x < child_end(); x++ )
	{
	    Fl_Widget *w = children(x);
	    [..]
	}
    

void Fl_Table::clear()

Clears the table to zero rows, zero columns. Same as rows(0); cols(0);

Subclass should override this method to handle drawing the cells. This method will be called whenever the table is redrawn, once per cell.

Only cells that are completely (or partially) visible will be told to draw.

context will be one of the following:

Fl_Table::CONTEXT_STARTPAGE	When table, or parts of the table, are about to be redrawn. Use to initialize static data, such as font selections. r/c will be zero, x/y/w/h will be the dimensions of the table's entire data area. (Useful for locking a database before accessing)
Fl_Table::CONTEXT_ENDPAGE	When table has completed being redrawn. r/c will be zero, x/y/w/h dimensions of table's data area. (Useful for unlocking a database after accessing)
Fl_Table::CONTEXT_ROW_HEADER	Whenever a row header cell needs to be drawn.
Fl_Table::CONTEXT_COL_HEADER	Whenever a column header cell needs to be drawn.
Fl_Table::CONTEXT_CELL	Whenever a data cell in the table needs to be drawn.
Fl_Table::CONTEXT_RC_RESIZE	Whenever table or row/column is resized or scrolled. (Useful for fltk containers that need to resize or move the child fltk widgets.)

row and col will be set to the row and column number the user clicked on. In the case of row headers, col will be 0. In the case of column headers, row will be 0.

x/y/w/h will be the position and dimensions of where the cell should be drawn.

In the case of custom widgets, a minimal draw_cell() override might look like the following. With custom widgets it is up to the caller to handle drawing everything within the dimensions of the cell, including handling the selection color. Note all clipping must be handled as well; this allows drawing outside the dimensions of the cell if so desired for 'custom effects'.

    void MyTable::draw_cell(TableContext context, int R=0, int C=0, int X=0, int Y=0, int W=0, int H=0)
    {
	static char s[40];
	sprintf(s, "%d/%d", R, C);		// text for each cell
	switch ( context )
	{
	    case CONTEXT_STARTPAGE:
		fl_font(FL_HELVETICA, 16);
		return;

	    case CONTEXT_ROW_HEADER:
	    case CONTEXT_COL_HEADER:
		fl_push_clip(X, Y, W, H);
		{
		    fl_draw_box(FL_THIN_UP_BOX, X, Y, W, H, color());
		    fl_color(FL_BLACK);
		    fl_draw(s, X, Y, W, H, FL_ALIGN_CENTER);
		}
		fl_pop_clip();
		return;

	    case CONTEXT_CELL:
		fl_push_clip(X, Y, W, H);
		{
		    // BG COLOR
		    fl_color( row_selected(R) ? selection_color() : FL_WHITE);
		    fl_rectf(X, Y, W, H);

		    // TEXT
		    fl_color(FL_BLACK);
		    fl_draw(s, X, Y, W, H, FL_ALIGN_CENTER);

		    // BORDER
		    fl_color(FL_LIGHT2); 
		    fl_rect(X, Y, W, H);
		}
		fl_pop_clip();
		return;

	    default:
	        return;
	}
	//NOTREACHED
    }
    

The first form sets the number of columns in the table, and the table is redrawn.

The second form returns the number of columns in the table.

The first form enables/disables column headers; 1=enabled, 0=disabled. If changed, the table is redrawn.

The second form returns if column headers are enabled or not; 1=enabled, 0=disabled.

The first form sets the column header color and the table is redrawn.

The second form returns the current column header color.

The first form sets the column header height to n and causes the screen to redraw.

The second form returns the current column header height (in pixels).

The first form sets the current column minimum resize value. This is used to prevent the user from interactively resizing any column to be smaller than 'pixels'. Must be a value >=1.

The second form returns the current column minimum resize value.

The first form sets the column scroll position to column 'col', and causes the screen to redraw.

The second form returns the current column scroll position as a column number.

The first form sets the width of the specified column in pixels, and the table is redrawn.

The second form returns the current width of the specified column in pixels and causes the screen to redraw.

Convenience method to set the width of all columns to the same value, in pixels. The screen is redrawn.

Changes the size of the Fl_Table, causing it to redraw.

The first form sets the number of rows in the table, and the table is redrawn.

The second form returns the number of rows in the table.

The first form enables/disables showing the row headers; 1=enabled, 0=disabled. If changed, the table is redrawn.

The second form returns the value of this flag.

The first form sets the row header color and causes the screen to redraw.

The second form returns the current row header color.

The first form sets the row header width to n and causes the screen to redraw.

The second form returns the current row header width (in pixels).

The first form sets the current row minimum resize value. This is used to prevent the user from interactively resizing any row to be smaller than 'pixels'. Must be a value >=1.

The second form returns the current row minimum resize value.

The first form sets the row scroll position to 'row', and causes the screen to redraw.

The second form returns the current row scroll position as a row number.

The first form sets the height of the specified row in pixels, and the table is redrawn.

The second form returns the current height of the specified row as a value in pixels.

Convenience method to set the height of all rows to the same value, in pixels. The screen is redrawn.

void Fl_Table::table_box(Fl_Boxtype type)
Fl_Boxtype Fl_Table::table_box()

The first form sets the kind of box drawn around the data table, the default being FL_NO_BOX. Changing this value will cause the table to redraw.

The second form returns the current box type used for the data table.

The first form sets which row should be at the top of the table, scrolling as necessary, and the table is redrawn. If the table cannot be scrolled that far, it is scrolled as far as possible.

The second form returns the current top row shown in the table. This row may be partially obscured.

The first form sets when the parent's Fl_Table::callback() is called. These are the only values currently supported:

The second form returns the current value of when().

• FL_WHEN_RELEASED - when a button is clicked on the table or headings, the callback is called when the button is released. The mouse must be on the same row/column when the button is clicked and released, or the callback will not be generated.