ContainerVWidget Class Reference

#include <ContainerVWidget.h>

Inheritance diagram for ContainerVWidget:

Collaboration diagram for ContainerVWidget:

Public Member Functions
	ContainerVWidget ()
	ContainerVWidget (char *l, int x, int y, int w, int h, Widget *p)
virtual	~ContainerVWidget ()
virtual void	adjust () override
virtual int	getsize ()
virtual void	logic (CursorTask *mouse, KeyboardTask *keyboard) override
virtual void	render (SDL_Surface *screen, ColorEngine *colors, FontEngine *fonts) override
Public Member Functions inherited from Widget
	Widget (char *l, int x, int y, int w, int h, Widget *p)
virtual void	focus (Widget *emitter)
virtual void	unfocusup (Widget *emitter)
virtual void	unfocusdown (Widget *emitter)
virtual void	addchild (Widget *child)
virtual void	setdimensions (int mx, int my, int mw, int mh)
virtual void	setxpos (int mx)
virtual void	setypos (int my)
virtual void	setwidth (int mw)
virtual void	setheight (int mh)
virtual void	setlabel (char *l)
virtual void	setcontainerstatus (bool status)
virtual void	setparent (Widget *p)
virtual void	setvisible ()
virtual void	setinvisible ()
virtual void	enable ()
virtual void	disable ()
virtual int	getxpos ()
virtual int	getypos ()
virtual int	getwidth ()
virtual int	getheight ()
virtual int	getuseablexpos ()
virtual int	getuseableypos ()
virtual int	getuseablewidth ()
virtual int	getuseableheight ()
virtual char *	getlabel ()
virtual bool	getcontainerstatus ()
virtual Widget *	getparent ()
virtual bool	getisenabled ()
virtual bool	isvisible ()
virtual char *	getwidgettype ()
virtual void	linkonclick (void(*func)(char *))
virtual void	linkonrelease (void(*func)(char *))
virtual void	linkonhover (void(*func)(char *))

Additional Inherited Members
Protected Member Functions inherited from Widget
virtual bool	cursoron (CursorTask *mouse)
Protected Attributes inherited from Widget
bool	has_focus = false
bool	is_enabled = true
bool	is_visible = true
char *	widgettype
char *	label
int	xpos
int	xrel
int	ypos
int	yrel
int	width
int	widrel
int	height
int	heirel
bool	is_container = false
bool	is_hovering = false
Widget *	parent = nullptr
int	nbchildren
std::vector< Widget * >	children
void(*	clickfunction )(char *) = nullptr
void(*	releasefunction )(char *) = nullptr
void(*	hoverfunction )(char *) = nullptr

Detailed Description

Example of program using ContainerVWidget controls

The following simple example demonstrates how to use the ContainerVWidget controls.

Examples of usage:

#include "Toolkit/GUIToolkit.h"
 
int main ( int argc, char** argv )
{
    bool done = false;
 
    WidgetApplication *MyApp = new WidgetApplication();
    MyApp->setuniformbackgroundcolor(0, 0, 0);
 
    DesktopWidget *desktop1 = new DesktopWidget( (char*) "First Desktop", 0, 0, SCREEN_WIDTH, SCREEN_HEIGHT, nullptr );
 
   WindowWidget *window = new WindowWidget( (char*) "Examples of ContainerVWidget", 5, 5, 310, 230, desktop1 );
   ContainerVWidget *containervert = new ContainerVWidget( (char*) "container", 1, 1, 1, 1, window );
 
   LabelWidget *labelB = new LabelWidget( (char*) "Examples of ContainerVWidget", 1, 1, 1, 1, containervert );
 
   ContainerHWidget *contH1 = new ContainerHWidget( (char*) "container", 1, 1, 1, 1, containervert );
   CommuterWidget *com11 = new CommuterWidget( (char*) "St.1 Normal", 1, 1, 1, 1, contH1 );
   com11->settype( CommuterWidget::style1 );
   com11->setnormal();
   CommuterWidget *com12 = new CommuterWidget( (char*) "St.1 Reverse", 1, 1, 1, 1, contH1 );
   com12->settype( CommuterWidget::style1 );
   com12->setreversed();
 
   ContainerHWidget *contH2 = new ContainerHWidget( (char*) "container", 1, 1, 1, 1, containervert );
   CommuterWidget *com21 = new CommuterWidget( (char*) "St.2 Normal", 1, 1, 1, 1, contH2 );
   com21->settype( CommuterWidget::style2 );
   com21->setnormal();
   CommuterWidget *com22 = new CommuterWidget( (char*) "St.2 Reverse", 1, 1, 1, 1, contH2 );
   com22->settype( CommuterWidget::style2 );
   com22->setreversed();
 
   ContainerHWidget *contH3 = new ContainerHWidget( (char*) "container", 1, 1, 1, 1, containervert );
   CommuterWidget *com31 = new CommuterWidget( (char*) "St.3 Normal", 1, 1, 1, 1, contH3 );
   com31->settype( CommuterWidget::style3 );
   com31->setnormal();
   CommuterWidget *com32 = new CommuterWidget( (char*) "St.3 Reverse", 1, 1, 1, 1, contH3 );
   com32->settype( CommuterWidget::style3 );
   com32->setreversed();
 
   ContainerHWidget *contH4 = new ContainerHWidget( (char*) "container", 1, 1, 1, 1, containervert );
   CommuterWidget *com41 = new CommuterWidget( (char*) "St.4 Normal", 1, 1, 1, 1, contH4 );
   com41->settype( CommuterWidget::style4 );
   com41->setnormal();
   CommuterWidget *com42 = new CommuterWidget( (char*) "St.4 Reverse", 1, 1, 1, 1, contH4 );
   com42->settype( CommuterWidget::style4 );
   com42->setreversed();
 
    // the button to be clicked to quit
    ButtonWidget *buttonQuit = new ButtonWidget( (char*) "Quit [CTRL]+[ESC]", 1, 1, 1, 1, contH );
 
    // We ask for an automatic positioning of the widgets in the grid
    // Note : this will fully override the dimensions given to the Widgets manually
    window->adjust();
 
    MyApp->addchild( desktop1 );
 
    KeyboardTask *keyboard = MyApp->getkeyboardhandler();
 
    // We render the app for the first time so what we can see what's happening on the screen
    MyApp->render();
 
    while (!done)
    {
 
        MyApp->logic();
 
        if ((keyboard->kbCTRL && keyboard->kbESC) || buttonQuit->ispressed()) done = true;
 
    }
 
    return 0;
}

ContainerVWidget class.

The class to be used for using a ContainerVWidget control widget. ContainerVWidget inherits from Widget class.

See also

Widget

Examples of usage:

CommuterWidget* myContainerV = new ContainerVWidget();        // Simple constructor, will need specific properties assignement later

CommuterWidget* myContainerV = new ContainerVWidget( "I am a ContainerVWidget", 10, 50, 100, 15, parent );        // Full constructor

Constructor & Destructor Documentation

ContainerVWidget() [1/2]

ContainerVWidget::ContainerVWidget ( )

inline

Simple constructor.

Widget properties are set to default, nothing more. Simple constructor, will need specific properties assignement later.

Parameters

None

Returns

Nothing

See also

Widget()

ContainerVWidget() [2/2]

ContainerVWidget::ContainerVWidget ( char *  l, int  x, int  y, int  w, int  h, Widget *  p  )

inline

Advanced constructor.

Widget properties are set with parameters values given at call.

Parameters

l	: text string (char*) that will be used as the ContainerHWidget textual content
x	: position x in pixels relatively to the parent Widget usable drawspace
y	: position y in pixels relatively to the parent Widget usable drawspace
w	: width in pixel of the ButtonWidget
h	: height in pixel of the ButtonWidget
p	: pointer type to a Widget* to create a link with the parent widget (if any).

Note

p should be set to nullptr if no parent exists

p can be omitted (i.e. set to nullptr) and parent-children link can be created with a call to the Widget::addchild() method of the parent Widget.

Returns

Nothing

See also

Widget( char*, int, int, int, int, Widget* )

~ContainerVWidget()

virtual ContainerVWidget::~ContainerVWidget ( )

inlinevirtual

Object destructor

Object destructor, remove all trace of the object and free allocated memory

Parameters

None

Returns

Nothing

See also

~Widget()

Member Function Documentation

adjust()

void ContainerVWidget::adjust ( )

overridevirtual

Adjust method

This method permits to automatically adjust the dimensions of both the container and of the children widgets

Parameters

None

Returns

Nothing

See also

Widget::adjust()

Reimplemented from Widget.

getsize()

virtual int ContainerVWidget::getsize ( )

inlinevirtual

How many children do have the container ?

This method returns the number of children of the container (this is very usefull for setting their dimensions in the adjust() method.

Parameters

None

Returns

int number of children of the container

See also

~Widget()

logic()

void ContainerVWidget::logic ( CursorTask *  mouse, KeyboardTask *  keyboard  )

overridevirtual

The ContainerVWidget logic mechanism

Widget method to be launched to drive the the mechanics behind the CheckBoxWidget behavior.

Parameters

mouse	: pointer to a CursorTask handler object serving at passing the mouse (Touchpad) state and position
keyboard	: pointer to a KeyboardTask handler object serving at passing the keyboard state

Returns

Nothing, but will launch the logic() method of all the Widgets belonging to chidren (vector<Widget*>)

Note

This method overrides Widget::logic( CursorTask*, KeyboardTask*)

This method is not intended to be used by a direct call from the user, it is normally called through cascaded calls to children->logic() from the WidgetApplication class

Direct call can be used when the Widget is used out of the WidgetApplication 'ecosystem', for example in an application that just use few individual widgets (not recommended cause it may need intensive work from the developper to create adequate working conditions).

Warning

Before calling the logic method, a mouse handler and a keyboard handler must be instancied and properly updated through their respective logic() methods. This is normally done by using the WidgetApplication class.

Reimplemented from Widget.

render()

void ContainerVWidget::render ( SDL_Surface *  screen, ColorEngine *  colors, FontEngine *  fonts  )

overridevirtual

The ContainerVWidget render method.

Widget method to be launched to draw the ContainerHWidget. This actually do nothing cause ContainerHWidget and ContainerVWidget are just containers and nothing is actually drawn But this method is overriden as for all Widget and cascades the render() order to children widgets

Parameters

screen	: pointer to a SDL_Surface object where we would like to draw the widget
colors	: pointer to a ColorEngine object giving all the color options to be used (theme) for drawing the widget
fonts	: pointer to a FontEngine object giving all the fonts options to be used (theme) for drawing the widget

Returns

Nothing, but will launch the render() method of all the Widgets belonging to chidren (vector<Widget*>)

Note

This method overrides Widget::render( SDL_Surface*, ColorEngine*, FontEngine*)

This method is not intended to be used by a direct call from the user, it is normally called through cascaded calls to children->render() from the WidgetApplication class.

Direct call can be used when the Widget is used out of the WidgetApplication 'ecosystem', for example in an application that just use few individual widgets (not recommended cause it may need intensive work from the developper to create adequate working conditions).

Warning

Before calling the render method, a SDL_Surface (i.e. a rendering context) as well as a ColorEngine and FontEngine objects must be properly instancied. This is normally done by using the WidgetApplication class.

Reimplemented from Widget.

---

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

• /home/sylvain/NSpire_Programming/Widgets/Widgets/Toolkit/ContainerVWidget.h
• /home/sylvain/NSpire_Programming/Widgets/Widgets/Toolkit/ContainerVWidget.cpp