Inheritance diagram for Chesto::ListElement:

Collaboration diagram for Chesto::ListElement:

Public Member Functions
bool	process (InputEvents *event)
	process any input that is received for this element More...

bool	handleInertiaScroll (InputEvents *event)

bool	processUpDown (InputEvents *event)

Public Member Functions inherited from Chesto::Element
virtual bool	process (InputEvents *event)
	process any input that is received for this element More...

virtual void	render (Element *parent)
	display the current state of the display More...

bool	onTouchDown (InputEvents *event)

bool	onTouchDrag (InputEvents *event)

bool	onTouchUp (InputEvents *event)

void	hide ()

void	unhide ()

void	renderBackground (bool fill=true)

void	addNode (std::unique_ptr< Element > node)

void	remove (Element *element)

void	removeAll ()

void	position (int x, int y)
	position the element More...

void	recalcPosition (Element *parent)

float	getEffectiveScale () const

CST_Rect	getBounds ()

CST_Renderer *	getRenderer ()

Element *	setPosition (int x, int y)

Element *	setAction (std::function< void()> func)

Element *	setAbsolute (bool isAbs)

template<typename T , typename... Args>
T *	createNode (Args &&... args)

Element *	constrain (int flags, int padding=0)

Element *	constrainToTarget (Element *target, int flags, int padding=0)

Element *	animate (int durationIn, std::function< void(float)> onStep, std::function< void()> onFinish)

Element *	moveToFront ()

Element *	setTouchable (bool touchable)

void	screenshot (std::string path)
	Take a screenshot of this element and its children, and save it to the given path. More...

Public Attributes
int	highlighted = -1

int	initialTouchDown = -1

int	minYScroll = 0

Public Attributes inherited from Chesto::Element
std::function< void()>	action = NULL
	the action to call (from binded callback) on touch or button selection https://stackoverflow.com/questions/14189440/c-class-member-callback-simple-examples More...

std::function< void(InputEvents *event)>	actionWithEvents = NULL

std::vector< std::unique_ptr< Element, std::function< void(Element *)> > >	elements
	visible GUI child elements of this element More...

float	scale = 1.0f

bool	touchable = false
	whether or not this element can be touched (highlights bounds) More...

bool	dragging = false
	whether or not this element is currently being dragged More...

bool	needsRedraw = false
	whether or not this element needs the screen redrawn next time it's processed More...

int	futureRedrawCounter = 0
	whether this element needs a redraw for the next X redraws (decreases each time) (0 is no redraws) More...

int	lastMouseY = 0
	the last Y, X coordinate of the mouse (from a drag probably) More...

int	lastMouseX = 0

bool	hasBackground = false

rgb	backgroundColor = {0, 0, 0}

int	backgroundOpacity = 0xff

bool	isAbsolute = false

Element *	parent = nullptr
	the parent element (reference only, not owned) More...

bool	hidden = false
	whether this element should skip rendering or not More...

bool	isProtected = false

int	elasticCounter = 0
	how much time is left in an elastic-type flick/scroll set by the last distance traveled in a scroll, and counts down every frame More...

int	width = 0
	width and height of this element (must be manually set, isn't usually calculated (but is in some cases, like text or images)) More...

int	height = 0

int	x = 0

int	y = 0

int	xAbs = 0

int	yAbs = 0

double	angle = 0
	rotation angle in degrees More...

int	cornerRadius = 0

int	tag = 0

std::vector< std::unique_ptr< Constraint > >	constraints

std::vector< std::unique_ptr< Animation > >	animations

bool	useColorMask = false
	whether or not to overlay a color mask on top of this element More...

CST_Color	maskColor = {0,0,0,0}
	The color to overlay on top. More...

Additional Inherited Members
Public Types inherited from Chesto::Element
typedef Element	super

Protected Member Functions inherited from Chesto::Element
void	addStackMember (Element *element)

Detailed Description

Definition at line 8 of file ListElement.hpp.

Member Function Documentation

◆ handleInertiaScroll()

bool Chesto::ListElement::handleInertiaScroll ( InputEvents * event )

Definition at line 37 of file ListElement.cpp.

{
    bool ret = false;
    ListElement* elem = this;
 
    if (event->isTouchDown())
    {
        // make sure that the mouse down's X coordinate is over the app list (not sidebar)
        if (event->xPos < elem->xAbs)
            return false;
 
        // saw mouse down so set it in our element object
        elem->dragging = true;
        elem->lastMouseY = event->yPos;
        elem->initialTouchDown = event->yPos;
 
        ret |= true;
    }
    // drag event for scrolling up or down
    else if (event->isTouchDrag())
    {
        if (elem->dragging)
        {
            // prevent scrolling until we exceed a treshold distance in the Y direction
            if (this->initialTouchDown >= 0 && (abs(event->yPos - this->initialTouchDown) < 10 * getEffectiveScale()))
                return false;
 
            this->initialTouchDown = -1;
 
            int distance = event->yPos - elem->lastMouseY;
            elem->y += distance;
            elem->lastMouseY = event->yPos;
 
            // use the last distance as the rubber band value
            elem->elasticCounter = distance;
 
            ret |= true;
        }
    }
    else if (event->isTouchUp())
    {
        // mouse up, no more mouse down (TODO: fire selected event here)
        elem->dragging = false;
 
        // if the scroll offset is less than the total number of apps
        // (put on the mouse up to make it "snap" when going out of bounds)
        // TODO: account for max number of apps too (prevent scrolling down forever)
        if (elem->y > minYScroll)
            elem->y = minYScroll;
 
        ret |= true;
    }
 
    // if mouse is up, and there's some elastic counter left, burn out remaining elastic value
    if (!elem->dragging && elem->elasticCounter != 0)
    {
        elem->y += elem->elasticCounter;
 
        // reduce the elastic counter by 5% each time (slows down the scroll)
        elem->elasticCounter *= 0.95;
        
        // if we're less than 10 pixels on the counter, just stop
        if (abs(elem->elasticCounter) < 10)
            elem->elasticCounter = 0;
 
        // TODO: same problem as above todo, also extract into method?
        if (elem->y > minYScroll)
            elem->y = minYScroll;
 
        ret |= true;
    }
 
    if (ret) event->isScrolling = true;
 
    if (event->wheelScroll != 0)
    {
        // apply wheel scroll directly to y position, and then reset
        elem->y += event->wheelScroll * 10;
        if (elem->y > minYScroll)
            elem->y = minYScroll;
        event->wheelScroll *= 0.95;
 
        if (abs(event->wheelScroll) < 0.1)
            event->wheelScroll = 0;
            
        ret |= true;
    }
 
    return ret;
}

◆ process()

bool Chesto::ListElement::process ( InputEvents * event )

virtual

process any input that is received for this element

Reimplemented from Chesto::Element.

Definition at line 5 of file ListElement.cpp.

{
    bool ret = false;
 
    // if we're hidden, don't process input
    if (hidden) return ret;
 
    // perform inertia scrolling for this element
    ret |= this->handleInertiaScroll(event);
 
    ret |= super::process(event);
 
    return ret;
}

References Chesto::Element::hidden, and Chesto::Element::process().

◆ processUpDown()

bool Chesto::ListElement::processUpDown ( InputEvents * event )

Definition at line 20 of file ListElement.cpp.

{
    bool ret = false;
    int SPEED = 1;
 
    // handle up and down for the scroll view
    if (event->isKeyDown())
    {
        // scroll the view by offsetting the elastic counter
        event->wheelScroll += (SPEED * event->held(UP_BUTTON) - SPEED * event->held(DOWN_BUTTON));
 
        ret |= event->held(UP_BUTTON) || event->held(DOWN_BUTTON);
    }
 
    return ret;
}

Member Data Documentation

◆ highlighted

int Chesto::ListElement::highlighted = -1

Definition at line 11 of file ListElement.hpp.

◆ initialTouchDown

int Chesto::ListElement::initialTouchDown = -1

Definition at line 12 of file ListElement.hpp.

◆ minYScroll

int Chesto::ListElement::minYScroll = 0

Definition at line 13 of file ListElement.hpp.

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

src/ListElement.hpp
src/ListElement.cpp

Public Member Functions

Public Attributes

Additional Inherited Members