ede/efiler/Flu_Wrap_Group.h
2007-08-20 16:53:43 +00:00

197 lines
6.2 KiB
C++

// $Id: Flu_Wrap_Group.h,v 1.10 2004/01/27 21:44:21 jbryan Exp $
/***************************************************************
* FLU - FLTK Utility Widgets
* Copyright (C) 2002 Ohio Supercomputer Center, Ohio State University
*
* This file and its content is protected by a software license.
* You should have received a copy of this license with this file.
* If not, please contact the Ohio Supercomputer Center immediately:
* Attn: Jason Bryan Re: FLU 1224 Kinnear Rd, Columbus, Ohio 43212
*
***************************************************************/
#ifndef _FLU_WRAP_GROUP_H
#define _FLU_WRAP_GROUP_H
/* fltk includes */
#include <FL/Fl.H>
#include <FL/fl_draw.H>
#include <FL/Fl_Group.H>
#include <FL/Fl_Scrollbar.H>
//#include "FLU/Flu_Enumerations.h"
#define FLU_EXPORT
//! This class provides an alternative to Fl_Group that automatically arranges the children either left to right and top to bottom (for type() == \c FL_VERTICAL), or top to bottom and left to right (for type() == \c FL_HORIZONTAL), within the available size of the group, with a scrollbar turning on if they don't all fit
/*! This class is a group with a scrollbar and an \b Fl_Group inside (both publicly exposed). The \b Fl_Group
contains the actual child widgets of this group.
Most of the \b Fl_Group member functions are reimplemented here in a pass-through fashion to the
internal group. This means that casual use of a descendent instance will be almost exactly the same
as for a regular \b Fl_Group, with any additional access provided directly through member \b group.
The goal of this class is to provide a group that dynamically and evenly distributes its children within
a fixed space, similar to those available in other GUI toolkits.
*/
class FLU_EXPORT Flu_Wrap_Group : public Fl_Group
{
public:
class Scrollbar : public Fl_Scrollbar
{
public:
Scrollbar( int x, int y, int w, int h, const char *l = 0 );
int handle( int event );
};
//! Normal FLTK constructor
Flu_Wrap_Group( int x, int y, int w, int h, const char *l = 0 );
//! \return the widget that is visibly above \b w in the group, or \c NULL if no such widget exists
Fl_Widget *above( Fl_Widget* w );
//! \return the widget that is visibly below \b w in the group, or \c NULL if no such widget exists
Fl_Widget *below( Fl_Widget* w );
//! Override of Fl_Group::draw()
void draw();
//! \return the widget that is visibly to the left of \b w in the group, or \c NULL if no such widget exists
Fl_Widget *left( Fl_Widget* w );
//! \return the widget that is logically after \b w in the groups order, or \c NULL if no such widget exists
Fl_Widget *next( Fl_Widget* w );
//! Set the offset for where the first child starts
inline void offset( int x, int y )
{ _offset[0] = x, _offset[1] = y; redraw(); }
//! \return the x offset for where the first child starts
inline int offset_x() const
{ return _offset[0]; }
//! \return the y offset for where the first child starts
inline int offset_y() const
{ return _offset[1]; }
//! \return the widget that is logically before \b w in the groups order, or \c NULL if no such widget exists
Fl_Widget *previous( Fl_Widget* w );
//! Override of Fl_Group::resize()
void resize( int x, int y, int w, int h );
//! \return the widget that is visibly to the right of \b w in the group, or \c NULL if no such widget exists
Fl_Widget *right( Fl_Widget* w );
//! Scroll the group so that the given widget is shown (usually aligned to the left/top)
void scroll_to( const Fl_Widget *w );
//! Scroll the group so that the given widget is shown (usually aligned to the left/top)
inline void scroll_to( const Fl_Widget& w )
{ scroll_to( &w ); }
//! Scroll the group to the beginning of the list
void scroll_to_beginning();
//! Scroll the group to the end of the list
void scroll_to_end();
//! Set the spacing between children
inline void spacing( int x, int y )
{ _spacing[0] = x, _spacing[1] = y; redraw(); }
//! \return the x spacing between children
inline int spacing_x() const
{ return _spacing[0]; }
//! \return the y spacing between children
inline int spacing_y() const
{ return _spacing[1]; }
//! Set the wrap type. Must be either \c FL_VERTICAL (children wrap according to the width, with a vertical scrollbar) or \c FL_HORIZONTAL (children wrap according to the height, with a horizontal scrollbar). Default is \c FL_HORIZONTAL
void type( int t );
//! Get the wrap type
inline int type() const
{ return _type; }
/*! \name Pass-through functions for the internal Fl_Group
* These are strictly for convenience. Only the most commonly called functions have been re-implemented.
* You can also explicitly access the group object for more control.
*/
//@{
inline Fl_Widget* const* array() const
{ return group.array(); }
inline int find( const Fl_Widget* w ) const
{ return group.find( w ); }
inline int find( const Fl_Widget& w ) const
{ return group.find( w ); }
inline void clear()
{ group.clear(); }
inline Fl_Widget *child(int n) const
{ return group.child(n); }
inline int children() const
{ return group.children(); }
inline void begin()
{ group.begin(); }
inline void end()
{ group.end(); Fl_Group::end(); }
inline void resizable(Fl_Widget *box)
{ group.resizable(box); }
inline void resizable(Fl_Widget &box)
{ group.resizable(box); }
inline Fl_Widget *resizable() const
{ return group.resizable(); }
inline void add( Fl_Widget &w )
{ group.add( w ); }
inline void add( Fl_Widget *w )
{ group.add( w ); }
inline void insert( Fl_Widget &w, int n )
{ group.insert( w, n ); }
inline void insert( Fl_Widget &w, Fl_Widget* beforethis )
{ group.insert( w, beforethis ); }
inline void remove( Fl_Widget &w )
{ group.remove( w ); }
inline void add_resizable( Fl_Widget &box )
{ group.add_resizable( box ); }
//@}
Scrollbar scrollbar;
Fl_Group group;
protected:
inline static void _scrollCB( Fl_Widget*, void *arg )
{ ((Flu_Wrap_Group*)arg)->redraw(); }
int layout( bool sbVisible, bool doScrollTo, int *measure = 0 );
const Fl_Widget *scrollTo;
int _offset[2], _spacing[2], _type;
};
#endif