AlertDialog Class Reference

Inheritance diagram for AlertDialog:

Collaboration diagram for AlertDialog:

Public Member Functions
	AlertDialog (const std::string &title, const std::string &message)
void	show ()
void	setText (const std::string &newText)
virtual void	render (Element *parent) override
	display the current state of the display More...
virtual bool	process (InputEvents *event) override
	process any input that is received for this element More...
Public Member Functions inherited from 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	append (Element *element)
void	remove (Element *element)
void	removeAll (bool moveToTrash=false)
void	position (int x, int y)
	position the element More...
void	recalcPosition (Element *parent)
CST_Rect	getBounds ()
CST_Renderer *	getRenderer ()
void	wipeAll (bool delSelf=false)
Element *	child (Element *child)
Element *	setPosition (int x, int y)
Element *	setAction (std::function< void()> func)
Element *	centerHorizontallyIn (Element *parent)
Element *	centerVerticallyIn (Element *parent)
Element *	centerIn (Element *parent)
Element *	setAbsolute (bool isAbs)
Element *	constrain (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
std::string	title
std::string	message
std::function< void()>	onConfirm
std::function< void()>	onCancel
bool	useAnimation = true
CST_Color	blackColor = CST_Color{0, 0, 0, 0xff}
TextElement *	messageText = new TextElement("(Placeholder text)", 20, &blackColor, NORMAL, 400)
Element *	overlay = new Element()
Container *	vStack = new Container(COL_LAYOUT, 50)
int	dialogWidth = 450
int	dialogHeight = 200
Public Attributes inherited from 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< 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 = NULL
	the parent element (can sometimes be null if it isn't set) 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	xOff = 0
int	yOff = 0
int	cornerRadius = 0
std::vector< Constraint * >	constraints
std::vector< 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 Element
typedef Element	super

Detailed Description

Definition at line 6 of file AlertDialog.hpp.

Constructor & Destructor Documentation

AlertDialog()

AlertDialog::AlertDialog	(	const std::string &	title,
		const std::string &	message
	)

AlertDialog

• Overlay (full screen dimmer, 100% width/height)
  • VStack (border of window, centered with light bg, dialog dimensions)
    • VStack (inner content, sized to fit the inner content)
      • TextElement (message text, width to the inner content)
      • Button (OK button)
        

Definition at line 6 of file AlertDialog.cpp.

    : title(title), message(message)
{
    hidden = true;
 
    messageText->setText(message);
    messageText->update(); // to set the size
 
    // just add the single button for now
    auto okButton = (new Button("OK", A_BUTTON));
    okButton->setAction([this]() {
        if (onConfirm) onConfirm();
    });
    okButton->cornerRadius = 10;
    okButton->updateBounds();
 
    auto innerVStack = new Container(COL_LAYOUT, 50);
    innerVStack->add(messageText);
    innerVStack->add(okButton);
    innerVStack->width = dialogWidth;
    // innerVStack->backgroundColor = fromRGB(0xff, 0, 0);
    // innerVStack->hasBackground = true;
 
    messageText->constrain(ALIGN_CENTER_HORIZONTAL, 0);
    okButton->constrain(ALIGN_CENTER_HORIZONTAL, 0);
 
    // prompt background color
    vStack->backgroundColor = fromRGB(0xdd, 0xdd, 0xdd);
    vStack->hasBackground = true;
    vStack->cornerRadius = 15;
    vStack->width = dialogWidth;
    vStack->height = dialogHeight;
    vStack->add(innerVStack);
    
    innerVStack->constrain(ALIGN_CENTER_BOTH, 0);
 
    // overlay and shade bg color
    overlay->width = RootDisplay::mainDisplay->width;
    overlay->height = RootDisplay::mainDisplay->height;
    overlay->backgroundColor = fromRGB(0, 0, 0);
    overlay->backgroundOpacity = 0x00;
    overlay->cornerRadius = 1; // forces transparency to render properly (via sdl_gfx)
    overlay->hasBackground = true;
    
    overlay->child(vStack);
 
    vStack->constrain(ALIGN_CENTER_BOTH, 0);
 
    this->child(overlay);
}

References Element::hidden, TextElement::update(), and Element::width.

Member Function Documentation

process()

bool AlertDialog::process ( InputEvents *  event )

overridevirtual

process any input that is received for this element

Reimplemented from Element.

Definition at line 102 of file AlertDialog.cpp.

                                            {
    // Implementation for processing input events
    return super::process(event);
}

References Element::process().

render()

void AlertDialog::render ( Element *  parent )

overridevirtual

display the current state of the display

Reimplemented from Element.

Definition at line 97 of file AlertDialog.cpp.

                                        {
    // Implementation for rendering the dialog
    super::render(this);
}

References Element::render().

setText()

void AlertDialog::setText

(

const std::string &

newText

)

Definition at line 65 of file AlertDialog.cpp.

                                                  {
    messageText->setText(newText);
    messageText->update();
}

show()

void AlertDialog::show

(

)

Definition at line 70 of file AlertDialog.cpp.

                       {
    // we have to go from being 100% transparent and small size to being opaque and full size
    // TODO: need opacity that affects all children elements
    hidden = false;
 
    if (useAnimation) {
        // start animation
        animate(250, [this](float progress) {
            // on step
            this->vStack->width = (dialogWidth * progress);
            this->vStack->height = (dialogHeight * progress);
            this->overlay->backgroundOpacity = (int)(0x80 * progress);
        }, [this]() {
            this->vStack->width = dialogWidth;
            this->vStack->height = dialogHeight;
            this->overlay->backgroundOpacity = 0x80;
        });
        return;
    }
 
    // no animation, just do it!
    // this->setVisible(true);
    this->width = dialogWidth;
    this->width = dialogHeight;
 
}

Member Data Documentation

blackColor

CST_Color AlertDialog::blackColor = CST_Color{0, 0, 0, 0xff}

Definition at line 21 of file AlertDialog.hpp.

dialogHeight

int AlertDialog::dialogHeight = 200

Definition at line 28 of file AlertDialog.hpp.

dialogWidth

int AlertDialog::dialogWidth = 450

Definition at line 27 of file AlertDialog.hpp.

message

std::string AlertDialog::message

Definition at line 14 of file AlertDialog.hpp.

messageText

TextElement* AlertDialog::messageText = new TextElement("(Placeholder text)", 20, &blackColor, NORMAL, 400)

Definition at line 22 of file AlertDialog.hpp.

onCancel

std::function<void()> AlertDialog::onCancel

Definition at line 16 of file AlertDialog.hpp.

onConfirm

std::function<void()> AlertDialog::onConfirm

Definition at line 15 of file AlertDialog.hpp.

overlay

Element* AlertDialog::overlay = new Element()

Definition at line 23 of file AlertDialog.hpp.

title

std::string AlertDialog::title

Definition at line 13 of file AlertDialog.hpp.

useAnimation

bool AlertDialog::useAnimation = true

Definition at line 17 of file AlertDialog.hpp.

vStack

Container* AlertDialog::vStack = new Container(COL_LAYOUT, 50)

Definition at line 24 of file AlertDialog.hpp.

---

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

• src/AlertDialog.hpp
• src/AlertDialog.cpp