Widget container to delegate any widget dynamically. More...

#include <WidgetProxy.h>

Inheritance diagram for cloudViewer::visualization::gui::WidgetProxy:

Collaboration diagram for cloudViewer::visualization::gui::WidgetProxy:

Classes
struct	Impl

Public Member Functions
	WidgetProxy ()

	~WidgetProxy () override

void	AddChild (std::shared_ptr< Widget > child) override

const std::vector< std::shared_ptr< Widget > >	GetChildren () const override

virtual void	SetWidget (std::shared_ptr< Widget > widget)
	set a new widget to be delegated by this one. More...

virtual std::shared_ptr< Widget >	GetWidget ()
	Retrieve current delegated widget. More...

const Rect &	GetFrame () const override
	Returns the frame size in pixels. More...

void	SetFrame (const Rect &f) override

const Color &	GetBackgroundColor () const override

bool	IsDefaultBackgroundColor () const override

void	SetBackgroundColor (const Color &color) override

bool	IsVisible () const override

void	SetVisible (bool vis) override

bool	IsEnabled () const override

void	SetEnabled (bool enabled) override

void	SetTooltip (const char *text) override

const char *	GetTooltip () const override

Size	CalcPreferredSize (const LayoutContext &context, const Constraints &constraints) const override

Size	CalcMinimumSize (const LayoutContext &context) const override

void	Layout (const LayoutContext &context) override

DrawResult	Draw (const DrawContext &context) override

EventResult	Mouse (const MouseEvent &e) override

EventResult	Key (const KeyEvent &e) override

DrawResult	Tick (const TickEvent &e) override

Public Member Functions inherited from cloudViewer::visualization::gui::Widget
	Widget ()

	Widget (const std::vector< std::shared_ptr< Widget >> &children)

virtual	~Widget ()

Protected Member Functions
virtual std::shared_ptr< Widget >	GetActiveWidget () const

Protected Member Functions inherited from cloudViewer::visualization::gui::Widget
void	DrawImGuiPushEnabledState ()

void	DrawImGuiPopEnabledState ()

void	DrawImGuiTooltip ()

Additional Inherited Members
Public Types inherited from cloudViewer::visualization::gui::Widget
enum class	DrawResult { NONE , REDRAW , RELAYOUT }

enum class	EventResult { IGNORED , CONSUMED , DISCARD }

Static Public Attributes inherited from cloudViewer::visualization::gui::Widget
static constexpr int	DIM_GROW = 10000

Detailed Description

Widget container to delegate any widget dynamically.

Widget can not be managed dynamically. Although it is allowed to add more child widgets, it's impossible to replace some child with new on or remove children. WidgetProxy is designed to solve this problem.

When WidgetProxy is created, it's invisible and disabled, so it won't be drawn or layout, seeming like it does not exist. When a widget is set by SetWidget, all Widget's APIs will be conducted to that child widget. It looks like WidgetProxy is that widget.

At any time, a new widget could be set, to replace the old one. and the old widget will be destroyed.

Due to the content changing after a new widget is set or cleared, a relayout of Window might be called after SetWidget.

The delegated widget could be retrieved by GetWidget in case you need to access it directly, like get check status of a CheckBox.

API other than SetWidget and GetWidget has completely same function as Widget.

Definition at line 47 of file WidgetProxy.h.

Constructor & Destructor Documentation

◆ WidgetProxy()

cloudViewer::visualization::gui::WidgetProxy::WidgetProxy ( )

Definition at line 21 of file WidgetProxy.cpp.

◆ ~WidgetProxy()

cloudViewer::visualization::gui::WidgetProxy::~WidgetProxy ( )

override

Definition at line 22 of file WidgetProxy.cpp.

Member Function Documentation

◆ AddChild()

void cloudViewer::visualization::gui::WidgetProxy::AddChild ( std::shared_ptr< Widget > child )

overridevirtual

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 32 of file WidgetProxy.cpp.

References GetActiveWidget().

◆ CalcMinimumSize()

Size cloudViewer::visualization::gui::WidgetProxy::CalcMinimumSize ( const LayoutContext & context ) const

overridevirtual

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 142 of file WidgetProxy.cpp.

References cloudViewer::visualization::gui::Widget::CalcMinimumSize(), context, and GetActiveWidget().

◆ CalcPreferredSize()

Size cloudViewer::visualization::gui::WidgetProxy::CalcPreferredSize	(	const LayoutContext &	context,
		const Constraints &	constraints
	)		const

overridevirtual

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 133 of file WidgetProxy.cpp.

References cloudViewer::visualization::gui::Widget::CalcPreferredSize(), context, and GetActiveWidget().

◆ Draw()

Widget::DrawResult cloudViewer::visualization::gui::WidgetProxy::Draw ( const DrawContext & context )

overridevirtual

Draws the widget. If this is a Dear ImGUI widget, this is where the actual event processing happens. Return NONE if no action needs to be taken, REDRAW if the widget needs to be redrawn (e.g. its value changed), and RELAYOUT if the widget wishes to change size.

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 157 of file WidgetProxy.cpp.

References context, GetActiveWidget(), IsVisible(), cloudViewer::visualization::gui::Widget::NONE, cloudViewer::visualization::gui::Widget::RELAYOUT, and result.

◆ GetActiveWidget()

std::shared_ptr< Widget > cloudViewer::visualization::gui::WidgetProxy::GetActiveWidget ( ) const

protectedvirtual

Definition at line 24 of file WidgetProxy.cpp.

Referenced by AddChild(), CalcMinimumSize(), CalcPreferredSize(), Draw(), GetBackgroundColor(), GetChildren(), GetFrame(), GetTooltip(), GetWidget(), IsDefaultBackgroundColor(), IsEnabled(), IsVisible(), Key(), Layout(), Mouse(), SetBackgroundColor(), SetEnabled(), SetFrame(), SetTooltip(), SetVisible(), and Tick().

◆ GetBackgroundColor()

const Color & cloudViewer::visualization::gui::WidgetProxy::GetBackgroundColor ( ) const

overridevirtual

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 63 of file WidgetProxy.cpp.

References GetActiveWidget(), and cloudViewer::visualization::gui::Widget::GetBackgroundColor().

◆ GetChildren()

const std::vector< std::shared_ptr< Widget > > cloudViewer::visualization::gui::WidgetProxy::GetChildren ( ) const

overridevirtual

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 39 of file WidgetProxy.cpp.

References GetActiveWidget(), and cloudViewer::visualization::gui::Widget::GetChildren().

◆ GetFrame()

const Rect & cloudViewer::visualization::gui::WidgetProxy::GetFrame ( ) const

overridevirtual

Returns the frame size in pixels.

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 47 of file WidgetProxy.cpp.

References GetActiveWidget(), and cloudViewer::visualization::gui::Widget::GetFrame().

Referenced by cloudViewer::visualization::gui::pybind_gui_classes().

◆ GetTooltip()

const char * cloudViewer::visualization::gui::WidgetProxy::GetTooltip ( ) const

overridevirtual

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 125 of file WidgetProxy.cpp.

References GetActiveWidget(), and cloudViewer::visualization::gui::Widget::GetTooltip().

◆ GetWidget()

std::shared_ptr< Widget > cloudViewer::visualization::gui::WidgetProxy::GetWidget ( )

virtual

Retrieve current delegated widget.

Returns: Instance of current delegated widget set by SetWidget. An empty pointer will be returned if there is none.

Definition at line 31 of file WidgetProxy.cpp.

References GetActiveWidget().

Referenced by cloudViewer::visualization::gui::pybind_gui_classes().

◆ IsDefaultBackgroundColor()

bool cloudViewer::visualization::gui::WidgetProxy::IsDefaultBackgroundColor ( ) const

overridevirtual

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 71 of file WidgetProxy.cpp.

References GetActiveWidget(), and cloudViewer::visualization::gui::Widget::IsDefaultBackgroundColor().

◆ IsEnabled()

bool cloudViewer::visualization::gui::WidgetProxy::IsEnabled ( ) const

overridevirtual

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 102 of file WidgetProxy.cpp.

References GetActiveWidget(), and cloudViewer::visualization::gui::Widget::IsEnabled().

◆ IsVisible()

bool cloudViewer::visualization::gui::WidgetProxy::IsVisible ( ) const

overridevirtual

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 87 of file WidgetProxy.cpp.

References GetActiveWidget(), and cloudViewer::visualization::gui::Widget::IsVisible().

Referenced by Draw(), Key(), and Mouse().

◆ Key()

Widget::EventResult cloudViewer::visualization::gui::WidgetProxy::Key ( const KeyEvent & e )

overridevirtual

Widgets that use Dear ImGUI should not need to override this, as Dear ImGUI will take care of all the key handling during the Draw().

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 185 of file WidgetProxy.cpp.

References cloudViewer::visualization::gui::Widget::DISCARD, GetActiveWidget(), cloudViewer::visualization::gui::Widget::IGNORED, and IsVisible().

◆ Layout()

void cloudViewer::visualization::gui::WidgetProxy::Layout ( const LayoutContext & context )

overridevirtual

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 150 of file WidgetProxy.cpp.

References context, and GetActiveWidget().

◆ Mouse()

Widget::EventResult cloudViewer::visualization::gui::WidgetProxy::Mouse ( const MouseEvent & e )

overridevirtual

Widgets that use Dear ImGUI should not need to override this, as Dear ImGUI will take care of all the mouse handling during the Draw().

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 174 of file WidgetProxy.cpp.

References cloudViewer::visualization::gui::Widget::DISCARD, GetActiveWidget(), cloudViewer::visualization::gui::Widget::IGNORED, and IsVisible().

◆ SetBackgroundColor()

void cloudViewer::visualization::gui::WidgetProxy::SetBackgroundColor ( const Color & color )

overridevirtual

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 79 of file WidgetProxy.cpp.

References color, GetActiveWidget(), and cloudViewer::visualization::gui::Widget::SetBackgroundColor().

◆ SetEnabled()

void cloudViewer::visualization::gui::WidgetProxy::SetEnabled ( bool enabled )

overridevirtual

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 110 of file WidgetProxy.cpp.

References GetActiveWidget().

◆ SetFrame()

void cloudViewer::visualization::gui::WidgetProxy::SetFrame ( const Rect & f )

overridevirtual

The frame is in pixels. The size of a pixel varies on different and operating systems now frequently scale text sizes on high DPI monitors. Prefer using a Layout to using this function, but if you must use it, it is best to use a multiple of Window::GetTheme().fontSize, which represents 1em and is scaled according to the scaling factor of the window.

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 55 of file WidgetProxy.cpp.

References GetActiveWidget(), and cloudViewer::visualization::gui::Widget::SetFrame().

◆ SetTooltip()

void cloudViewer::visualization::gui::WidgetProxy::SetTooltip ( const char * text )

overridevirtual

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 117 of file WidgetProxy.cpp.

References GetActiveWidget(), and cloudViewer::visualization::gui::Widget::SetTooltip().

◆ SetVisible()

void cloudViewer::visualization::gui::WidgetProxy::SetVisible ( bool vis )

overridevirtual

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 95 of file WidgetProxy.cpp.

References GetActiveWidget().

◆ SetWidget()

void cloudViewer::visualization::gui::WidgetProxy::SetWidget ( std::shared_ptr< Widget > widget )

virtual

set a new widget to be delegated by this one.

After SetWidget, the previously delegated widget will be abandon, all calls to Widget's API will be conducted to widget.

Before any SetWidget call, this widget is invisible and disabled, seems it does not exist because it won't be drawn or in a layout.

Parameters

widget Any widget to be delegated. Set to NULL to clear current delegated proxy.

Definition at line 27 of file WidgetProxy.cpp.

Referenced by cloudViewer::visualization::gui::WidgetStack::PopWidget(), and cloudViewer::visualization::gui::WidgetStack::PushWidget().

◆ Tick()

Widget::DrawResult cloudViewer::visualization::gui::WidgetProxy::Tick ( const TickEvent & e )

overridevirtual

Tick events are sent regularly and allow for things like smoothly moving the camera based on keys that are pressed, or animations. Return DrawResult::REDRAW if you want to be redrawn.

Reimplemented from cloudViewer::visualization::gui::Widget.

Definition at line 196 of file WidgetProxy.cpp.

References GetActiveWidget(), cloudViewer::visualization::gui::Widget::NONE, and result.

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

/root/ACloudViewer/libs/cloudViewer/visualization/gui/WidgetProxy.h
/root/ACloudViewer/libs/cloudViewer/visualization/gui/WidgetProxy.cpp

Classes

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ WidgetProxy()

◆ ~WidgetProxy()

Member Function Documentation

◆ AddChild()

◆ CalcMinimumSize()

◆ CalcPreferredSize()

◆ Draw()

◆ GetActiveWidget()

◆ GetBackgroundColor()

◆ GetChildren()

◆ GetFrame()

◆ GetTooltip()

◆ GetWidget()

◆ IsDefaultBackgroundColor()

◆ IsEnabled()

◆ IsVisible()

◆ Key()

◆ Layout()

◆ Mouse()

◆ SetBackgroundColor()

◆ SetEnabled()

◆ SetFrame()

◆ SetTooltip()

◆ SetVisible()

◆ SetWidget()

◆ Tick()