FLTK 1.4.4

Loading...
Searching...
No Matches
Fl_Table_Row Class Reference

A table with row selection capabilities. More...

`#include <Fl_Table_Row.H>`

Inheritance diagram for Fl_Table_Row:

## Public Types
enum | TableRowSelectMode { SELECT_NONE , SELECT_SINGLE , SELECT_MULTI }
Public Types inherited from Fl_Table
enum | TableContext { CONTEXT_NONE = 0 , CONTEXT_STARTPAGE = 0x01 , CONTEXT_ENDPAGE = 0x02 , CONTEXT_ROW_HEADER = 0x04 , CONTEXT_COL_HEADER = 0x08 , CONTEXT_CELL = 0x10 , CONTEXT_TABLE = 0x20 , CONTEXT_RC_RESIZE = 0x40 }
| The context bit flags for Fl_Table related callbacks. More...

## Public Member Functions
void | clear () FL_OVERRIDE
| Clears the table to zero rows (rows(0)), zero columns (cols(0)), and clears any widgets (table->clear()) that were added with begin()/end() or add()/insert()/etc.
| Fl_Table_Row (int X, int Y, int W, int H, const char *l=0)
| The constructor for the Fl_Table_Row.
int | row_selected (int row)
| Checks to see if 'row' is selected.
int | rows ()
void | rows (int val) FL_OVERRIDE
| Sets the number of rows in the table, and the table is redrawn.
void | select_all_rows (int flag=1)
| This convenience function changes the selection state for all rows based on 'flag'.
int | select_row (int row, int flag=1)
| Changes the selection state for `'row'`, depending on the value of `'flag'`.
TableRowSelectMode | type () const
void | type (TableRowSelectMode val)
| Sets the table selection mode.
| ~Fl_Table_Row ()
| The destructor for the Fl_Table_Row.
Public Member Functions inherited from Fl_Table
void | add (Fl_Widget &wgt)
| The specified widget is removed from its current group (if any) and added to the end of Fl_Table's group.
void | add (Fl_Widget *wgt)
| The specified widget is removed from its current group (if any) and added to the end of Fl_Table's group.
Fl_Widget *const * | array ()
| Returns a pointer to the array of children.
void | begin ()
void | callback (Fl_Widget *, void *)
| Callbacks will be called depending on the setting of Fl_Widget::when().
int | callback_col ()
| Returns the current column the event occurred on.
TableContext | callback_context ()
| Returns the current 'table context'.
int | callback_row ()
| Returns the current row the event occurred on.
Fl_Widget * | child (int n) const
| Returns the child widget by an index.
int | children () const
| Returns the number of children in the table.
int | col_header ()
| Returns if column headers are enabled or not.
void | col_header (int flag)
| Enable or disable column headers.
Fl_Color | col_header_color ()
| Gets the color for column headers.
void | col_header_color (Fl_Color val)
| Sets the color for column headers and redraws the table.
int | col_header_height ()
| Gets the column header height.
void | col_header_height (int height)
| Sets the height in pixels for column headers and redraws the table.
int | col_position ()
| Returns the current column scroll position as a column number.
void | col_position (int col)
| Sets the horizontal scroll position so 'col' is at the left, and causes the screen to redraw.
int | col_resize ()
| Returns if column resizing by the user is allowed.
void | col_resize (int flag)
| Allows/disallows column resizing by the user.
int | col_resize_min ()
| Returns the current column minimum resize value.
void | col_resize_min (int val)
| Sets the current column minimum resize value.
int | col_width (int col)
| Returns the current width of the specified column in pixels.
void | col_width (int col, int width)
| Sets the width of the specified column in pixels, and the table is redrawn.
void | col_width_all (int width)
| Convenience method to set the width of all columns to the same value, in pixels.
int | cols ()
| Get the number of columns in the table.
virtual void | cols (int val)
| Set the number of columns in the table and redraw.
void | do_callback (TableContext context, int row, int col)
| Calls the widget callback.
void | end ()
int | find (const Fl_Widget &wgt) const
int | find (const Fl_Widget *wgt) const
| Fl_Table (int X, int Y, int W, int H, const char *l=0)
| The constructor for Fl_Table.
void | get_selection (int &row_top, int &col_left, int &row_bot, int &col_right)
| Gets the region of cells selected (highlighted).
void | init_sizes ()
| Resets the internal array of widget sizes and positions.
void | insert (Fl_Widget &wgt, Fl_Widget *w2)
| The specified widget is removed from its current group (if any) and inserted into Fl_Table's group before widget 'w2'.
void | insert (Fl_Widget &wgt, int n)
| The specified widget is removed from its current group (if any) and inserted into the Fl_Table's group at position 'n'.
int | is_interactive_resize ()
| Returns 1 if someone is interactively resizing a row or column.
int | is_selected (int r, int c)
| See if the cell at row `r` and column `c` is selected.
int | move_cursor (int R, int C)
| Same as move_cursor(R,C,1);.
int | move_cursor (int R, int C, int shiftselect)
| Moves the selection cursor a relative number of rows/columns specifed by R/C.
void | remove (Fl_Widget &wgt)
| The specified widget is removed from Fl_Table's group.
void | resize (int X, int Y, int W, int H) FL_OVERRIDE
| Handle resize events if user resizes parent window.
int | row_header ()
| Returns if row headers are enabled or not.
void | row_header (int flag)
| Enables/disables showing the row headers.
Fl_Color | row_header_color ()
| Returns the current row header color.
void | row_header_color (Fl_Color val)
| Sets the row header color and causes the screen to redraw.
int | row_header_width ()
| Returns the current row header width (in pixels).
void | row_header_width (int width)
| Sets the row header width to n and causes the screen to redraw.
int | row_height (int row)
| Returns the current height of the specified row as a value in pixels.
void | row_height (int row, int height)
| Sets the height of the specified row in pixels, and the table is redrawn.
void | row_height_all (int height)
| Convenience method to set the height of all rows to the same value, in pixels.
int | row_position ()
| Returns the current row scroll position as a row number.
void | row_position (int row)
| Sets the vertical scroll position so 'row' is at the top, and causes the screen to redraw.
int | row_resize ()
| Returns if row resizing by the user is allowed.
void | row_resize (int flag)
| Allows/disallows row resizing by the user.
int | row_resize_min ()
| Returns the current row minimum resize value.
void | row_resize_min (int val)
| Sets the current row minimum resize value.
int | rows ()
| Returns the number of rows in the table.
int | scrollbar_size () const
| Gets the current size of the scrollbars' troughs, in pixels.
void | scrollbar_size (int newSize)
| Sets the pixel size of the scrollbars' troughs to `newSize`, in pixels.
void | set_selection (int row_top, int col_left, int row_bot, int col_right)
| Sets the region of cells to be selected (highlighted).
int | tab_cell_nav () const
| Get state of table's 'Tab' key cell navigation flag.
void | tab_cell_nav (int val)
| Flag to control if Tab navigates table cells or not.
void | table_box (Fl_Boxtype val)
| Sets the kind of box drawn around the data table, the default being FL_NO_BOX.
Fl_Boxtype | table_box (void)
| Returns the current box type used for the data table.
int | top_row ()
| Returns the current top row shown in the table.
void | top_row (int row)
| Sets which row should be at the top of the table, scrolling as necessary, and the table is redrawn.
void | visible_cells (int &r1, int &r2, int &c1, int &c2)
| Returns the range of row and column numbers for all visible and partially visible cells in the table.
void | when (Fl_When flags)
| The Fl_Widget::when() function is used to set a group of flags, determining when the widget callback is called:
| ~Fl_Table ()
| The destructor for Fl_Table.
Public Member Functions inherited from Fl_Group
Fl_Widget *& | _ddfdesign_kludge ()
| This is for forms compatibility only.
void | add (Fl_Widget &)
| The widget is removed from its current group (if any) and then added to the end of this group.
void | add (Fl_Widget *o)
| See void Fl_Group::add(Fl_Widget &w)
void | add_resizable (Fl_Widget &o)
| Adds a widget to the group and makes it the resizable widget.
Fl_Widget *const * | array () const
| Returns a pointer to the array of children.
Fl_Group const * | as_group () const FL_OVERRIDE
Fl_Group * | as_group () FL_OVERRIDE
| Returns an Fl_Group pointer if this widget is an Fl_Group.
void | begin ()
| Sets the current group so you can build the widget tree by just constructing the widgets.
Fl_Widget * | child (int n) const
| Returns the n'th child.
int | children () const
| Returns how many child widgets the group has.
void | clear ()
| Deletes all child widgets from memory recursively.
unsigned int | clip_children ()
| Returns the current clipping mode.
void | clip_children (int c)
| Controls whether the group widget clips the drawing of child widgets to its bounding box.
virtual int | delete_child (int n)
| Removes the widget at `index` from the group and deletes it.
void | end ()
| Exactly the same as current(this->parent()).
int | find (const Fl_Widget &o) const
| See int Fl_Group::find(const Fl_Widget *w) const.
int | find (const Fl_Widget *) const
| Searches the child array for the widget and returns the index.
| Fl_Group (int, int, int, int, const char *=0)
| Creates a new Fl_Group widget using the given position, size, and label string.
void | focus (Fl_Widget *W)
void | forms_end ()
| This is for forms compatibility only.
void | init_sizes ()
| Resets the internal array of widget sizes and positions.
void | insert (Fl_Widget &, int i)
| The widget is removed from its current group (if any) and then inserted into this group.
void | insert (Fl_Widget &o, Fl_Widget *before)
| This does insert(w, find(before)).
void | remove (Fl_Widget &)
| Removes a widget from the group but does not delete it.
void | remove (Fl_Widget *o)
| Removes the widget `o` from the group.
void | remove (int index)
| Removes the widget at `index` from the group but does not delete it.
Fl_Widget * | resizable () const
| Returns the group's resizable widget.
void | resizable (Fl_Widget &o)
| Sets the group's resizable widget.
void | resizable (Fl_Widget *o)
| The resizable widget defines both the resizing box and the resizing behavior of the group and its children.
virtual | ~Fl_Group ()
| The destructor also deletes all the children.
Public Member Functions inherited from Fl_Widget
void | _clear_fullscreen ()
void | _set_fullscreen ()
void | activate ()
| Activates the widget.
unsigned int | active () const
| Returns whether the widget is active.
int | active_r () const
| Returns whether the widget and all of its parents are active.
Fl_Align | align () const
| Gets the label alignment.
void | align (Fl_Align alignment)
| Sets the label alignment.
long | argument () const
| Gets the current user data (long) argument that is passed to the callback function.
void | argument (long v)
| Sets the current user data (long) argument that is passed to the callback function.
virtual class Fl_Gl_Window * | as_gl_window ()
| Returns an Fl_Gl_Window pointer if this widget is an Fl_Gl_Window.
virtual class Fl_Gl_Window const * | as_gl_window () const
virtual Fl_Window * | as_window ()
| Returns an Fl_Window pointer if this widget is an Fl_Window.
virtual Fl_Window const * | as_window () const
void | bind_deimage (Fl_Image *img)
| Sets the image to use as part of the widget label when in the inactive state.
void | bind_deimage (int f)
| Bind the inactive image to the widget, so the widget will delete the image when it is no longer needed.
void | bind_image (Fl_Image *img)
| Sets the image to use as part of the widget label when in the active state.
void | bind_image (int f)
| Bind the image to the widget, so the widget will delete the image when it is no longer needed.
Fl_Boxtype | box () const
| Gets the box type of the widget.
void | box (Fl_Boxtype new_box)
| Sets the box type for the widget.
Fl_Callback_p | callback () const
| Gets the current callback function for the widget.
void | callback (Fl_Callback *cb)
| Sets the current callback function for the widget.
void | callback (Fl_Callback *cb, Fl_Callback_User_Data *p, bool auto_free)
| Sets the current callback function and managed user data for the widget.
void | callback (Fl_Callback *cb, void *p)
| Sets the current callback function and data for the widget.
void | callback (Fl_Callback0 *cb)
| Sets the current callback function for the widget.
void | callback (Fl_Callback1 *cb, long p=0)
| Sets the current callback function for the widget.
unsigned int | changed () const
| Checks if the widget value changed since the last callback.
void | clear_active ()
| Marks the widget as inactive without sending events or changing focus.
void | clear_changed ()
| Marks the value of the widget as unchanged.
void | clear_damage (uchar c=0)
| Clears or sets the damage flags.
void | clear_output ()
| Sets a widget to accept input.
void | clear_visible ()
| Hides the widget.
void | clear_visible_focus ()
| Disables keyboard focus navigation with this widget.
Fl_Color | color () const
| Gets the background color of the widget.
void | color (Fl_Color bg)
| Sets the background color of the widget.
void | color (Fl_Color bg, Fl_Color sel)
| Sets the background and selection color of the widget.
Fl_Color | color2 () const
| For back compatibility only.
void | color2 (unsigned a)
| For back compatibility only.
int | contains (const Fl_Widget *w) const
| Checks if w is a child of this widget.
void | copy_label (const char *new_label)
| Sets the current label.
void | copy_tooltip (const char *text)
| Sets the current tooltip text.
uchar | damage () const
| Returns non-zero if draw() needs to be called.
void | damage (uchar c)
| Sets the damage bits for the widget.
void | damage (uchar c, int x, int y, int w, int h)
| Sets the damage bits for an area inside the widget.
int | damage_resize (int, int, int, int)
| Internal use only.
void | deactivate ()
| Deactivates the widget.
Fl_Image * | deimage ()
| Gets the image that is used as part of the widget label when in the inactive state.
const Fl_Image * | deimage () const
| Gets the image that is used as part of the widget label when in the inactive state.
void | deimage (Fl_Image &img)
| Sets the image to use as part of the widget label when in the inactive state.
void | deimage (Fl_Image *img)
| Sets the image to use as part of the widget label when in the inactive state.
int | deimage_bound () const
| Returns whether the inactive image is managed by the widget.
void | do_callback (Fl_Callback_Reason reason=FL_REASON_UNKNOWN)
| Calls the widget callback function with default arguments.
void | do_callback (Fl_Widget *widget, long arg, Fl_Callback_Reason reason=FL_REASON_UNKNOWN)
| Calls the widget callback function with arbitrary arguments.
void | do_callback (Fl_Widget *widget, void *arg=0, Fl_Callback_Reason reason=FL_REASON_UNKNOWN)
| Calls the widget callback function with arbitrary arguments.
void | draw_label (int, int, int, int, Fl_Align) const
| Draws the label in an arbitrary bounding box with an arbitrary alignment.
int | h () const
| Gets the widget height.
virtual void | hide ()
| Makes a widget invisible.
int | horizontal_label_margin ()
| Get the spacing between the label and the horizontal edge of the widget.
void | horizontal_label_margin (int px)
| Set the spacing between the label and the horizontal edge of the widget.
Fl_Image * | image ()
| Gets the image that is used as part of the widget label when in the active state.
const Fl_Image * | image () const
| Gets the image that is used as part of the widget label when in the active state.
void | image (Fl_Image &img)
| Sets the image to use as part of the widget label when in the active state.
void | image (Fl_Image *img)
| Sets the image to use as part of the widget label when in the active state.
int | image_bound () const
| Returns whether the image is managed by the widget.
int | inside (const Fl_Widget *wgt) const
| Checks if this widget is a child of `wgt`.
int | is_label_copied () const
| Returns whether the current label was assigned with copy_label().
const char * | label () const
| Gets the current label text.
void | label (const char *text)
| Sets the current label pointer.
void | label (Fl_Labeltype a, const char *b)
| Shortcut to set the label text and type in one call.
int | label_image_spacing ()
| Return the gap size between the label and the image.
void | label_image_spacing (int gap)
| Set the gap between the label and the image in pixels.
Fl_Color | labelcolor () const
| Gets the label color.
void | labelcolor (Fl_Color c)
| Sets the label color.
Fl_Font | labelfont () const
| Gets the font to use.
void | labelfont (Fl_Font f)
| Sets the font to use.
Fl_Fontsize | labelsize () const
| Gets the font size in pixels.
void | labelsize (Fl_Fontsize pix)
| Sets the font size in pixels.
Fl_Labeltype | labeltype () const
| Gets the label type.
void | labeltype (Fl_Labeltype a)
| Sets the label type.
void | measure_label (int &ww, int &hh) const
| Sets width ww and height hh accordingly with the label size.
bool | needs_keyboard () const
| Returns whether this widget needs a keyboard.
void | needs_keyboard (bool needs)
| Sets whether this widget needs a keyboard.
unsigned int | output () const
| Returns if a widget is used for output only.
Fl_Group * | parent () const
| Returns a pointer to the parent widget.
void | parent (Fl_Group *p)
| Internal use only - "for hacks only".
void | position (int X, int Y)
| Repositions the window or widget.
void | redraw ()
| Schedules the drawing of the widget.
void | redraw_label ()
| Schedules the drawing of the label.
Fl_Color | selection_color () const
| Gets the selection color.
void | selection_color (Fl_Color a)
| Sets the selection color.
void | set_active ()
| Marks the widget as active without sending events or changing focus.
void | set_changed ()
| Marks the value of the widget as changed.
void | set_output ()
| Sets a widget to output only.
void | set_visible ()
| Makes the widget visible.
void | set_visible_focus ()
| Enables keyboard focus navigation with this widget.
int | shortcut_label () const
| Returns whether the widget's label uses '&' to indicate shortcuts.
void | shortcut_label (int value)
| Sets whether the widget's label uses '&' to indicate shortcuts.
virtual void | show ()
| Makes a widget visible.
void | size (int W, int H)
| Changes the size of the widget.
int | take_focus ()
| Gives the widget the keyboard focus.
unsigned int | takesevents () const
| Returns if the widget is able to take events.
int | test_shortcut ()
| Returns true if the widget's label contains the entered '&x' shortcut.
const char * | tooltip () const
| Gets the current tooltip text.
void | tooltip (const char *text)
| Sets the current tooltip text.
Fl_Window * | top_window () const
| Returns a pointer to the top-level window for the widget.
Fl_Window * | top_window_offset (int &xoff, int &yoff) const
| Finds the x/y offset of the current widget relative to the top-level window.
uchar | type () const
| Gets the widget type.
void | type (uchar t)
| Sets the widget type.
int | use_accents_menu ()
| Returns non zero if MAC_USE_ACCENTS_MENU flag is set, 0 otherwise.
void * | user_data () const
| Gets the user data for this widget.
void | user_data (Fl_Callback_User_Data *v, bool auto_free)
| Sets the user data for this widget.
void | user_data (void *v)
| Sets the user data for this widget.
int | vertical_label_margin ()
| Get the spacing between the label and the vertical edge of the widget.
void | vertical_label_margin (int px)
| Set the spacing between the label and the vertical edge of the widget.
unsigned int | visible () const
| Returns whether a widget is visible.
unsigned int | visible_focus () const
| Checks whether this widget has a visible focus.
void | visible_focus (int v)
| Modifies keyboard focus navigation.
int | visible_r () const
| Returns whether a widget and all its parents are visible.
int | w () const
| Gets the widget width.
Fl_When | when () const
| Returns the conditions under which the callback is called.
void | when (uchar i)
| Sets the flags used to decide when a callback is called.
Fl_Window * | window () const
| Returns a pointer to the nearest parent window up the widget hierarchy.
int | x () const
| Gets the widget position in its window.
int | y () const
| Gets the widget position in its window.
virtual | ~Fl_Widget ()
| Destroys the widget.

## Protected Member Functions
int | find_cell (TableContext context, int R, int C, int &X, int &Y, int &W, int &H)
int | handle (int event) FL_OVERRIDE
| Handle FLTK events.
Protected Member Functions inherited from Fl_Table
void | change_cursor (Fl_Cursor newcursor)
| Change mouse cursor to different type.
long | col_scroll_position (int col)
| Returns the scroll position (in pixels) of the specified column 'col'.
TableContext | cursor2rowcol (int &R, int &C, ResizeFlag &resizeflag)
| Find row/col for the recent mouse event.
void | damage_zone (int r1, int c1, int r2, int c2, int r3=0, int c3=0)
| Sets the damage zone to the specified row/col values.
void | draw () FL_OVERRIDE
| Draws the entire Fl_Table.
virtual void | draw_cell (TableContext context, int R=0, int C=0, int X=0, int Y=0, int W=0, int H=0)
| Subclass should override this method to handle drawing the cells.
int | find_cell (TableContext context, int R, int C, int &X, int &Y, int &W, int &H)
| Find a cell's X/Y/W/H region for the specified cell in row 'R', column 'C'.
void | get_bounds (TableContext context, int &X, int &Y, int &W, int &H)
| Returns the (X,Y,W,H) bounding region for the specified 'context'.
int | is_fltk_container ()
| Does the table contain any child fltk widgets?
void | recalc_dimensions ()
| Recalculate the dimensions of the table, and affect any children.
void | redraw_range (int topRow, int botRow, int leftCol, int rightCol)
| Define region of cells to be redrawn by specified range of rows/cols, and then sets damage(DAMAGE_CHILD).
int | row_col_clamp (TableContext context, int &R, int &C)
| Return specified row/col values R and C to within the table's current row/col limits.
long | row_scroll_position (int row)
| Returns the scroll position (in pixels) of the specified 'row'.
void | table_resized ()
| Call this if table was resized, to recalculate internal data.
void | table_scrolled ()
| Recalculate internals after a scroll.
Protected Member Functions inherited from Fl_Group
Fl_Rect * | bounds ()
| Returns the internal array of widget sizes and positions.
void | draw_child (Fl_Widget &widget) const
| Forces a child to redraw.
void | draw_children ()
| Draws all children of the group.
void | draw_outside_label (const Fl_Widget &widget) const
| Parents normally call this to draw outside labels of child widgets.
virtual int | on_insert (Fl_Widget *, int)
| Allow derived groups to act when a widget is added as a child.
virtual int | on_move (int, int)
| Allow derived groups to act when a widget is moved within the group.
virtual void | on_remove (int)
| Allow derived groups to act when a child widget is removed from the group.
int * | sizes ()
| Returns the internal array of widget sizes and positions.
void | update_child (Fl_Widget &widget) const
| Draws a child only if it needs it.
Protected Member Functions inherited from Fl_Widget
void | clear_flag (unsigned int c)
| Clears a flag in the flags mask.
void | draw_backdrop () const
| If FL_ALIGN_IMAGE_BACKDROP is set, the image or deimage will be drawn.
void | draw_box () const
| Draws the widget box according its box style.
void | draw_box (Fl_Boxtype t, Fl_Color c) const
| Draws a box of type t, of color c at the widget's position and size.
void | draw_box (Fl_Boxtype t, int x, int y, int w, int h, Fl_Color c) const
| Draws a box of type t, of color c at the position X,Y and size W,H.
void | draw_focus () const
| Draws a focus rectangle around the widget.
void | draw_focus (Fl_Boxtype t, int X, int Y, int W, int H) const
| Draws a focus rectangle around the widget.
void | draw_focus (Fl_Boxtype t, int x, int y, int w, int h, Fl_Color bg) const
| Draws a focus box for the widget at the given position and size.
void | draw_label () const
| Draws the widget's label at the defined label position.
void | draw_label (int, int, int, int) const
| Draws the label in an arbitrary bounding box.
| Fl_Widget (int x, int y, int w, int h, const char *label=0L)
| Creates a widget at the given position and size.
unsigned int | flags () const
| Gets the widget flags mask.
void | h (int v)
| Internal use only.
void | set_flag (unsigned int c)
| Sets a flag in the flags mask.
void | w (int v)
| Internal use only.
void | x (int v)
| Internal use only.
void | y (int v)
| Internal use only.

## Additional Inherited Members
Static Public Member Functions inherited from Fl_Group
static Fl_Group * | current ()
| Returns the currently active group.
static void | current (Fl_Group *g)
| Sets the current group.
Static Public Member Functions inherited from Fl_Widget
static void | default_callback (Fl_Widget *widget, void *data)
| The default callback for all widgets that don't set a callback.
static unsigned int | label_shortcut (const char *t)
| Returns the Unicode value of the '&x' shortcut in a given text.
static int | test_shortcut (const char *, const bool require_alt=false)
| Returns true if the given text `t` contains the entered '&x' shortcut.
Protected Types inherited from Fl_Table
enum | ResizeFlag { RESIZE_NONE = 0 , RESIZE_COL_LEFT = 1 , RESIZE_COL_RIGHT = 2 , RESIZE_ROW_ABOVE = 3 , RESIZE_ROW_BELOW = 4 }
Protected Types inherited from Fl_Widget
enum | { INACTIVE = 1<<0 , INVISIBLE = 1<<1 , OUTPUT = 1<<2 , NOBORDER = 1<<3 , FORCE_POSITION = 1<<4 , NON_MODAL = 1<<5 , SHORTCUT_LABEL = 1<<6 , CHANGED = 1<<7 , OVERRIDE = 1<<8 , VISIBLE_FOCUS = 1<<9 , COPIED_LABEL = 1<<10 , CLIP_CHILDREN = 1<<11 , MENU_WINDOW = 1<<12 , TOOLTIP_WINDOW = 1<<13 , MODAL = 1<<14 , NO_OVERLAY = 1<<15 , GROUP_RELATIVE = 1<<16 , COPIED_TOOLTIP = 1<<17 , FULLSCREEN = 1<<18 , MAC_USE_ACCENTS_MENU = 1<<19 , NEEDS_KEYBOARD = 1<<20 , IMAGE_BOUND = 1<<21 , DEIMAGE_BOUND = 1<<22 , AUTO_DELETE_USER_DATA = 1<<23 , MAXIMIZED = 1<<24 , POPUP = 1<<25 , USERFLAG3 = 1<<29 , USERFLAG2 = 1<<30 , USERFLAG1 = 1<<31 }
| flags possible values enumeration. More...
Static Protected Member Functions inherited from Fl_Table
static void | scroll_cb (Fl_Widget *, void *)
| Callback for when someone moves a scrollbar.
Protected Attributes inherited from Fl_Table
int | botrow
| bottom row# of currently visible table on screen
int | current_col
| selection cursor's current column (-1 if none)
int | current_row
| selection cursor's current row (-1 if none)
Fl_Scrollbar * | hscrollbar
| child horizontal scrollbar widget
int | leftcol
| left column# of currently visible table on screen
int | leftcol_scrollpos
| precomputed scroll position for left column
int | rightcol
| right column# of currently visible table on screen
int | select_col
| extended selection column (-1 if none)
int | select_row
| extended selection row (-1 if none)
Fl_Scroll * | table
| child Fl_Scroll widget container for child fltk widgets (if any)
int | table_h
| table's virtual height (in pixels)
int | table_w
| table's virtual width (in pixels)
int | tih
| Data table's inner h dimension, inside bounding box. See Table Dimension Diagram.
int | tiw
| Data table's inner w dimension, inside bounding box. See Table Dimension Diagram.
int | tix
| Data table's inner x dimension, inside bounding box. See Table Dimension Diagram.
int | tiy
| Data table's inner y dimension, inside bounding box. See Table Dimension Diagram.
int | toh
| Data table's outer h dimension, outside bounding box. See Table Dimension Diagram.
int | toprow
| top row# of currently visible table on screen
int | toprow_scrollpos
| precomputed scroll position for top row
int | tow
| Data table's outer w dimension, outside bounding box. See Table Dimension Diagram.
int | tox
| Data table's outer x dimension, outside bounding box. See Table Dimension Diagram.
int | toy
| Data table's outer y dimension, outside bounding box. See Table Dimension Diagram.
Fl_Scrollbar * | vscrollbar
| child vertical scrollbar widget
int | wih
| Table widget's inner h dimension, inside bounding box. See Table Dimension Diagram.
int | wiw
| Table widget's inner w dimension, inside bounding box. See Table Dimension Diagram.
int | wix
| Table widget's inner x dimension, inside bounding box. See Table Dimension Diagram.
int | wiy
| Table widget's inner y dimension, inside bounding box. See Table Dimension Diagram.

## Detailed Description

A table with row selection capabilities.

This class implements a simple table with the ability to select rows. This widget is similar to an Fl_Browser with columns. Most methods of importance will be found in the Fl_Table widget, such as Fl_Table::rows() and Fl_Table::cols().

To be useful it must be subclassed and at minimum the draw_cell() method must be overridden to provide the content of the cells. This widget does not manage the cell's data content; it is up to the parent class's draw_cell() method override to provide this.

Events on the cells and/or headings generate callbacks when they are clicked by the user. You control when events are generated based on the values you supply for Fl_Table::when().

## Constructor & Destructor Documentation

## ◆ Fl_Table_Row()

Fl_Table_Row::Fl_Table_Row | ( | int | X,
|  | int | Y,
|  | int | W,
|  | int | H,
|  | const char * | l = 0 )
| inline

The constructor for the Fl_Table_Row.

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

## ◆ ~Fl_Table_Row()

Fl_Table_Row::~Fl_Table_Row | ( |  | ) |
| inline

The destructor for the Fl_Table_Row.

Destroys the table and its associated widgets.

## Member Function Documentation

## ◆ clear()

void Fl_Table_Row::clear | ( |  | ) |
| inline virtual

Clears the table to zero rows (rows(0)), zero columns (cols(0)), and clears any widgets (table->clear()) that were added with begin()/end() or add()/insert()/etc.

See also
  rows(int), cols(int)

Reimplemented from Fl_Table.

## ◆ handle()

int Fl_Table_Row::handle | ( | int | e | ) |
| protected virtual

Handle FLTK events.

Reimplemented from Fl_Table.

## ◆ row_selected()

int Fl_Table_Row::row_selected | ( | int | row | ) |

Checks to see if 'row' is selected.

Returns 1 if selected, 0 if not. You can change the selection of a row by clicking on it, or by using select_row(row, flag)

`row` should be a valid row. If the row is out of range the return value is 0 (zero).

Parameters

  [in] | row | row to be checked

Returns
  whether given row is selected

Return values

  1 | row is selected
  0 | row is not selected or `row` is out of range

## ◆ rows()

void Fl_Table_Row::rows | ( | int | val | ) |
| virtual

Sets the number of rows in the table, and the table is redrawn.

Reimplemented from Fl_Table.

## ◆ select_all_rows()

void Fl_Table_Row::select_all_rows | ( | int | flag = 1 | ) |

This convenience function changes the selection state for all rows based on 'flag'.

0=deselect, 1=select, 2=toggle existing state.

## ◆ select_row()

int Fl_Table_Row::select_row | ( | int | row,
|  | int | flag = 1 )

Changes the selection state for `'row'`, depending on the value of `'flag'`.

The optional `flag` can be:

- 0: clear selection
- 1: set selection (default)
- 2: toggle selection

Parameters

  [in] | row | row to be selected, deselected, or toggled
  [in] | flag | change mode, see description

Returns
  result of modification, see description

Return values

  0 | selection state did not change
  1 | selection state changed
  -1 | row out of range or incorrect selection mode (`flag`)

## ◆ type()

void Fl_Table_Row::type | ( | TableRowSelectMode | val | ) |

Sets the table selection mode.

- `Fl_Table_Row::SELECT_NONE` - No selection allowed
- `Fl_Table_Row::SELECT_SINGLE` - Only single rows can be selected
- `Fl_Table_Row::SELECT_MULTI` - Multiple rows can be selected

The documentation for this class was generated from the following files:

- Fl_Table_Row.H
- Fl_Table_Row.cxx