Spinning Topp Logo BlackTopp Studios
inc
Public Member Functions | Static Public Member Functions | Static Public Attributes | Protected Member Functions | Protected Attributes | List of all members
Mezzanine::UI::Scrollbar Class Referenceabstract

This is the scrollbar base class. More...

#include <scrollbar.h>

+ Inheritance diagram for Mezzanine::UI::Scrollbar:
+ Collaboration diagram for Mezzanine::UI::Scrollbar:

Public Member Functions

 Scrollbar (Screen *Parent)
 Blank constructor. More...
 
 Scrollbar (const String &RendName, Screen *Parent)
 Standard initialization constructor. More...
 
 Scrollbar (const String &RendName, const UnifiedRect &RendRect, Screen *Parent)
 Rect constructor. More...
 
virtual ~Scrollbar ()
 Standard class destructor.
 
virtual Boole _ButtonScroll (Button *TheButton)=0
 Performs the operations for when one of the buttons is pressed to manipulate the scroller. More...
 
virtual Boole _MouseScroll (const Vector2 &MouseDelta)=0
 Performs the operations for when the scroller is directly manipulated by the mouse. More...
 
virtual Boole _MouseWheelScroll (const Integer Direction)=0
 Performs the operations for when the scroller is manipulated by the mouse wheel. More...
 
virtual void _NotifyEvent (EventArgumentsPtr Args)
 Notifies this subscriber of an event being fired. More...
 
virtual void _OnScrollValueChanged (const Real OldValue, const Real NewValue)
 Self logic to be executed when this scrollbar changes it's scrollvalue. More...
 
virtual Boole _ScrollBackScroll (const Vector2 &HitPosition)=0
 Performs the operations for when the scrollback is clicked on to manipulate the scroller. More...
 
virtual Boole GetAutoHide () const
 Gets whether or not this scrollbar will hide when it's set page container has less than one page to display. More...
 
virtual ButtonGetDownRightButton () const
 Gets the DownRight button within this widget, if it was initialized. More...
 
virtual Real GetIncrementDistance () const
 Gets the relative distance the scroller will move on a button press. More...
 
virtual ButtonGetScrollBack () const
 Gets the Scroller background within this widget. More...
 
virtual ButtonGetScroller () const
 Gets the Scroller button within this widget. More...
 
virtual Real GetScrollerSize () const =0
 Gets the size of the scroller relative to the ScrollBack. More...
 
virtual Real GetScrollerValue () const =0
 Get the currnent scroll position represented by a value between 0 and 1. More...
 
virtual ButtonGetUpLeftButton () const
 Gets the UpLeft button within this widget, if it was initialized. More...
 
virtual void ProtoDeSerializeProperties (const XML::Node &SelfRoot)
 Take the data stored in an XML Node and overwrite the properties of this object with it. More...
 
virtual void ProtoSerializeProperties (XML::Node &SelfRoot) const
 Convert the properties of this class to an XML::Node ready for serialization. More...
 
virtual void SetAutoHide (Boole AutoHide)
 Sets whether or not this scrollbar will hide when it's set page container has less than one page to display. More...
 
virtual void SetIncrementDistance (const Real &IncDist)
 Sets the relative distance the scroller will move when the up/left or down/right buttons are pressed. More...
 
virtual void SetScrollerSize (const Real &Size)=0
 Sets the length(or height) of the scroller based on the relative size of it's background. More...
 
virtual void SetScrollerValue (const Real &Value)=0
 Sets the value of this scrollbar and warps the scroller to that respective position. More...
 
- Public Member Functions inherited from Mezzanine::UI::PageProvider
virtual void _NotifyContainerUpdated ()=0
 Notifies this provider that the container it is providing page data to has been updated. More...
 
virtual void _SetContainer (PagedContainer *ToUpdate)
 Sets the container that is using this provider to update which renderables are visible. More...
 
virtual Real GetCurrentXPage () const =0
 Gets the current page position on the X axis. More...
 
virtual Real GetCurrentYPage () const =0
 Gets the current page position on the Y axis. More...
 
virtual Real GetMaxXPages () const =0
 Gets the maximum number of pages supported on the X axis. More...
 
virtual Real GetMaxYPages () const =0
 Gets the maximum number of pages supported on the Y axis. More...
 
virtual void ProtoDeSerializePageData (const XML::Node &SelfRoot)
 Take the data stored in an XML Node and overwrite the PageProvider data of this object with it. More...
 
virtual void ProtoSerializePageData (XML::Node &SelfRoot) const
 Convert the PageProvider data of this class to an XML::Node ready for serialization. More...
 
- Public Member Functions inherited from Mezzanine::UI::Widget
 Widget (Screen *Parent)
 Blank constructor. More...
 
 Widget (const String &RendName, Screen *Parent)
 Standard initialization constructor. More...
 
 Widget (const String &RendName, const UnifiedRect &RendRect, Screen *Parent)
 Rect constructor. More...
 
 Widget (const XML::Node &XMLNode, Screen *Parent)
 XML constructor. More...
 
virtual ~Widget ()
 Standard destructor.
 
virtual Boole _HandleInput (const Input::MetaCode &Code)
 Handles input passed to this widget. More...
 
virtual void _NotifyChildStateChange (Widget *Child, const UInt32 &OldState, const UInt32 &NewState)
 Notifies this widget that a child (or grandchild) has had it's state updated. More...
 
virtual void _OnFocusGained ()
 Self logic to be executed when focus is given to this widget. More...
 
virtual void _OnFocusLocked ()
 Self logic to be executed when focus is locked to this widget. More...
 
virtual void _OnFocusLost ()
 Self logic to be executed when focus is removed from this widget. More...
 
virtual void _OnFocusUnlocked ()
 Self logic to be executed when focus is no longer locked to this widget. More...
 
virtual void _OnMouseDragEnd ()
 Self logic to be executed when the mouse cursor stops dragging across the bounds of this widget. More...
 
virtual void _OnMouseDragStart ()
 Self logic to be executed when the mouse cursor starts dragging across the bounds of this widget. More...
 
virtual void _OnMouseEnter ()
 Self logic to be executed when the mouse cursor enters the bounds of this widget. More...
 
virtual void _OnMouseExit ()
 Self logic to be executed when the mouse cursor leaves the bounds of thiw widget. More...
 
virtual void _OnVisibilityHidden ()
 Self logic to be executed when this widget becomes invisible.
 
virtual void _OnVisibilityShown ()
 Self logic to be executed when this widget becomes visible.
 
virtual void BindGroupToState (const UInt32 BindState, RenderLayerGroup *ToBind)
 Binds a RenderLayerGroup to a WidgetState. More...
 
virtual void ForceState (const UInt32 NewState)
 Forces a new state of this Widget. More...
 
WidgetGetBottomMostHoveredWidget ()
 Gets a pointer to the Widget at the bottom of the hovered SubWidget chain. More...
 
virtual String GetDerivedSerializableName () const
 Gets the most derived serializable name of this Renderable. More...
 
virtual RenderLayerGroupGetGroupBoundToState (const UInt32 BindState) const
 Gets the current RenderLayerGroup bound to a specified WidgetState. More...
 
WidgetGetHoveredSubWidget () const
 Gets the hovered sub-widget within this widget, if any. More...
 
virtual RenderableType GetRenderableType () const
 Gets the type of renderable this is. More...
 
virtual UInt32 GetState () const
 Gets the current state of this Widget. More...
 
virtual const StringGetTypeName () const
 Gets the type of widget this is. More...
 
virtual Boole GetVisible () const
 Gets the visibility setting of this renderable. More...
 
virtual Boole HasFocus () const
 Gets whether or not this widget currently has focus. More...
 
virtual void Hide ()
 Forces this renderable to hide. More...
 
virtual Boole IsDragged () const
 Gets whether or not the system mouse is being dragged over this widget. More...
 
virtual Boole IsHovered () const
 Gets the result of the last mouse hover check. More...
 
virtual Boole IsVisible () const
 Gets whether or not this renderable is being drawn. More...
 
virtual void ProtoDeSerializeEvents (const XML::Node &SelfRoot)
 Take the data stored in an XML Node and overwrite the Events of this object with it. More...
 
virtual void ProtoDeSerializeStateGroupBindings (const XML::Node &SelfRoot)
 Take the data stored in an XML Node and overwrite the state-group bindings of this object with it. More...
 
virtual void ProtoSerializeEvents (XML::Node &SelfRoot) const
 Convert the Events of this class to an XML::Node ready for serialization. More...
 
virtual void ProtoSerializeStateGroupBindings (XML::Node &SelfRoot) const
 Convert the state-group bindings of this class to an XML::Node ready for serialization. More...
 
virtual Boole SetGroupFromState (const UInt32 BindState)
 Sets the group bound to the specified WidgetState as active. More...
 
virtual void SetVisible (Boole CanSee)
 Sets the visibility of this renderable. More...
 
virtual void Show ()
 Forces this renderable to be shown. More...
 
- Public Member Functions inherited from Mezzanine::UI::QuadRenderable
 QuadRenderable (Screen *Parent)
 Blank constructor. More...
 
 QuadRenderable (const String &RendName, Screen *Parent)
 Class constructor. More...
 
 QuadRenderable (const String &RendName, const UnifiedRect &RendRect, Screen *Parent)
 Parent-less constructor. More...
 
virtual ~QuadRenderable ()
 Class destructor. More...
 
virtual void _AppendRenderData (ScreenRenderData &RenderData)
 Appends the vertices of this renderable to another vector. More...
 
virtual void _AppendRenderDataCascading (ScreenRenderData &RenderData)
 Appends the vertices of this renderable to another vector, and then does the same for this renderable's children. More...
 
virtual void _Clean ()
 Refreshes the render data of this renderable. More...
 
virtual void _MarkAllChildrenDirty ()
 Tells this QuadRenderable to mark each of it's children (and their children) as dirty. More...
 
virtual void _MarkAllLayersDirty ()
 Tells this QuadRenderable that all of it's layers are dirty. More...
 
virtual void _MarkDirty ()
 Marks this renderable as dirty, and informs other renderables if needed. More...
 
virtual void _NotifyParenthood (QuadRenderable *NewParent)
 Notifies this QuadRenderable that it has been added to another QuadRenderable. More...
 
virtual void _SetLayoutStrat (LayoutStrategy *ToSet)
 Sets a new LayoutStrategy for this quad to use. More...
 
virtual void _SetZOrder (const UInt16 &Zorder)
 Ssts the ZOrder value for this renderable. More...
 
virtual void AddChild (Widget *Child)
 Adds a Widget to this as a child of this quad. More...
 
virtual void AddChild (Widget *Child, const UInt16 ZOrder)
 Adds a Widget to this as a child of this quad. More...
 
void AddLayerToExistingGroup (RenderLayer *Layer, const UInt16 LayerZOrder, const UInt16 GroupID)
 Adds a RenderLayer to the specified group. More...
 
void AddLayerToGroup (RenderLayer *Layer, const UInt16 LayerZOrder, const UInt16 GroupID)
 Adds a RenderLayer to the specified group. More...
 
void AddLayerToGroup (RenderLayer *Layer, const GroupOrderEntry &GroupAndZ)
 Adds a RenderLayer to the specified group. More...
 
void AddLayerToGroups (RenderLayer *Layer, const GroupOrderEntryVector &Entrys)
 Adds a RenderLayer to multiple groups. More...
 
virtual Boole CheckOverlap (const QuadRenderable *Quad) const
 Checks to see if another Quad is overlapping with this one. More...
 
ChildIterator ChildrenBegin ()
 Gets an iterator to the first child Widget. More...
 
ConstChildIterator ChildrenBegin () const
 Gets a const iterator to the first child Widget. More...
 
ChildIterator ChildrenEnd ()
 Gets an iterator to one passed the last child Widget. More...
 
ConstChildIterator ChildrenEnd () const
 Gets an iterator to one passed the last child Widget. More...
 
MultiImageLayerCreateMultiImageLayer ()
 Creates an MultiImageLayer for this renderable. More...
 
MultiImageLayerCreateMultiImageLayer (const UInt16 NormalZ, const UInt16 HoveredZ)
 Creates an MultiImageLayer for this renderable. More...
 
MultiImageLayerCreateMultiImageLayer (const GroupOrderEntry &GroupAndZ)
 Creates an MultiImageLayer for this renderable and adds it to a RenderLayerGroup. More...
 
MultiLineTextLayerCreateMultiLineTextLayer ()
 Creats a MultiLineTextLayer for this renderable. More...
 
MultiLineTextLayerCreateMultiLineTextLayer (const UInt16 NormalZ, const UInt16 HoveredZ)
 Creats a MultiLineTextLayer for this renderable. More...
 
MultiLineTextLayerCreateMultiLineTextLayer (const GroupOrderEntry &GroupAndZ)
 Creats a MultiLineTextLayer for this renderable. More...
 
MultiLineTextLayerCreateMultiLineTextLayer (const String &FontName)
 Creats a MultiLineTextLayer for this renderable. More...
 
MultiLineTextLayerCreateMultiLineTextLayer (const String &FontName, const UInt16 NormalZ, const UInt16 HoveredZ)
 Creats a MultiLineTextLayer for this renderable. More...
 
MultiLineTextLayerCreateMultiLineTextLayer (const String &FontName, const GroupOrderEntry &GroupAndZ)
 Creats a MultiLineTextLayer for this renderable. More...
 
RenderLayerGroupCreateOrRetrieveRenderLayerGroup (const UInt16 GroupID)
 Gets the named RenderLayerGroup or creates one with the specified ID if it does not exist. More...
 
RenderLayerGroupCreateRenderLayerGroup (const UInt16 GroupID)
 Creates a new RenderLayerGroup that can have.

Exceptions
Thisfunction will throw an exception if a group already exists with the provided name.
More...
 
SingleImageLayerCreateSingleImageLayer ()
 Creates a SingleImageLayer for this renderable. More...
 
SingleImageLayerCreateSingleImageLayer (const UInt16 NormalZ, const UInt16 HoveredZ)
 Creates a SingleImageLayer for this renderable. More...
 
SingleImageLayerCreateSingleImageLayer (const GroupOrderEntry &GroupAndZ)
 Creates a SingleImageLayer for this renderable and adds it to a RenderLayerGroup. More...
 
SingleImageLayerCreateSingleImageLayer (const String &SpriteName)
 Creates a SingleImageLayer for this renderable. More...
 
SingleImageLayerCreateSingleImageLayer (const String &SpriteName, const UInt16 NormalZ, const UInt16 HoveredZ)
 Creates a SingleImageLayer for this renderable. More...
 
SingleImageLayerCreateSingleImageLayer (const String &SpriteName, const GroupOrderEntry &GroupAndZ)
 Creates a SingleImageLayer for this renderable and adds it to a RenderLayerGroup. More...
 
SingleLineTextLayerCreateSingleLineTextLayer ()
 Creats a SingleLineTextLayer for this renderable. More...
 
SingleLineTextLayerCreateSingleLineTextLayer (const UInt16 NormalZ, const UInt16 HoveredZ)
 Creats a SingleLineTextLayer for this renderable. More...
 
SingleLineTextLayerCreateSingleLineTextLayer (const GroupOrderEntry &GroupAndZ)
 Creats a SingleLineTextLayer for this renderable. More...
 
SingleLineTextLayerCreateSingleLineTextLayer (const String &FontName)
 Creats a SingleLineTextLayer for this renderable. More...
 
SingleLineTextLayerCreateSingleLineTextLayer (const String &FontName, const UInt16 NormalZ, const UInt16 HoveredZ)
 Creats a SingleLineTextLayer for this renderable. More...
 
SingleLineTextLayerCreateSingleLineTextLayer (const String &FontName, const GroupOrderEntry &GroupAndZ)
 Creats a SingleLineTextLayer for this renderable. More...
 
virtual void DestroyAllChildren ()
 Destroys all child Widgets currently inside this QuadRenderable.
 
void DestroyAllRenderLayerGroups ()
 Destroy's all RenderLayerGroups being stored/managed by this QuadRenderable.
 
void DestroyAllRenderLayers ()
 Destroys all RenderLayers being stored by this renderable.
 
virtual void DestroyChild (Widget *ToBeDestroyed)
 Destroys a child Widget currently inside this QuadRenderable. More...
 
void DestroyRenderLayer (RenderLayer *ToBeDestroyed)
 Destroys a RenderLayer being stored by this renderable. More...
 
void DestroyRenderLayerGroup (const UInt16 GroupID)
 Destroy's a RenderLayerGroup by ID. More...
 
void DestroyRenderLayerGroup (RenderLayerGroup *ToBeDestroyed)
 Destroy's a RenderLayerGroup by pointer. More...
 
RenderLayerGroupGetActiveGroup () const
 Gets the current RenderLayerGroup used for rendering. More...
 
virtual Vector2 GetActualPosition () const
 Gets the pixel position of this widget. More...
 
virtual Vector2 GetActualSize () const
 Gets the pixel size of this widget. More...
 
virtual UI::AspectRatioLock GetAspectRationLock () const
 Gets how (and if) the aspect ratio of this quad is locked. More...
 
virtual WidgetGetChild (const UInt16 Zorder) const
 Gets a child by it's ZOrder. More...
 
virtual WidgetGetChild (const String &RendName) const
 Gets a child by it's name. More...
 
WidgetGetClosestChild (Widget *Child)
 Gets a pointer to the child of this QuadRenderable that is storing a child, or another quad that is. More...
 
virtual UInt16 GetHighestChildZOrder () const
 Gets the highest ZOrder among the children of this QuadRenderable. More...
 
virtual Whole GetHorizontalPositioningRules () const
 Gets the current behavior this quad will follow when it is positioned automatically on the X axis. More...
 
virtual Whole GetHorizontalSizingRules () const
 Gets the current behavior this quad will follow for the X axis when it is resized. More...
 
virtual Real GetIdealHeightForText () const
 Gets the height needed for this quadrenderable to be able to completely display text in it's child text layers. More...
 
virtual UInt16 GetLowestChildZOrder () const
 Gets the lowest ZOrder among the children of this QuadRenderable. More...
 
virtual Boole GetManualTransformUpdates () const
 Gets whether or not this quad will be automatically updated when parent transforms are updated. More...
 
virtual UnifiedVec2 GetMaxSize () const
 Gets the currently set maximum size for this quad. More...
 
virtual UnifiedVec2 GetMinSize () const
 Gets the currently set minimum size for this quad. More...
 
virtual Boole GetMousePassthrough () const
 Gets whether or not Mouse Passthrough is enabled. More...
 
QuadRenderableGetNextSibling (Boole Wrap=true)
 Gets the QuadRenderable after this one among the QuadRenderables owned by it's parent. More...
 
virtual Whole GetNumChildren () const
 Gets the number of children in this QuadRenderable. More...
 
UInt32 GetNumRenderLayerGroups () const
 Gets the number of RenderLayerGroup's created for this renderable. More...
 
UInt32 GetNumRenderLayers () const
 Gets the number of RenderLayers created for this renderable. More...
 
UInt32 GetNumVisibleRenderLayers () const
 Gets the number of RenderLayers that are visible in this renderable. More...
 
QuadRenderableGetParent () const
 Gets the parent of this quad. More...
 
virtual const PositioningInfoGetPositioningPolicy () const
 Gets the current behavior this QuadRenderable will use when it is positioned. More...
 
QuadRenderableGetPrevSibling (Boole Wrap=true)
 Gets the QuadRenderable before this one among the QuadRenderables owned by it's parent. More...
 
virtual Rect GetRect () const
 Gets this QuadRenderables' Rect. More...
 
RenderLayerGetRenderLayer (const UInt32 &Index) const
 Gets a RenderLayer belonging to this QuadRenderable by index. More...
 
RenderLayerGetRenderLayer (const Whole Which, const UI::RenderLayerType Type)
 Gets a RenderLayer belonging to this QuadRenderable by it's type. More...
 
RenderLayerGroupGetRenderLayerGroup (const UInt16 GroupID) const
 Gets a RenderLayerGroup by ID. More...
 
virtual const SizingInfoGetSizingPolicy () const
 Gets the current behavior this QuadRenderable will use when it is sized. More...
 
QuadRenderableGetTopMostQuad ()
 Gets the QuadRenderable that is both an ancestor of this quad, and a direct child of the screen. More...
 
virtual UnifiedVec2 GetUnifiedPosition () const
 Gets the position of this QuadRenderable as a Unified Vector2. More...
 
virtual UnifiedRect GetUnifiedRect () const
 Gets the Unified positiona nd size of this QuadRenderable as a unified rect. More...
 
virtual UnifiedVec2 GetUnifiedSize () const
 Gets the size of this QuadRenderable as a Unified Vector2. More...
 
virtual Whole GetVerticalPositioningRules () const
 Gets the current behavior this quad will follow when it is positioned automatically on the Y axis. More...
 
virtual Whole GetVerticalSizingRules () const
 Gets the current behavior this quad will follow for the Y axis when it is resized. More...
 
virtual const UInt16GetZOrder () const
 Gets the currently set ZOrder of this QuadRenderable with it's parent. More...
 
virtual Boole IsChildOfScreen () const
 Gets whether or not this QuadRenderable is a direct child of it's screen. More...
 
virtual Boole IsInside (const Vector2 &Point) const
 Checks to see if a point in 2D space is inside this quad. More...
 
Boole IsVertexCachingEnabled () const
 Gets whether or not vertex caching is enabled for this Quad. More...
 
virtual void PopulateTextLinesInLayers (const Real MaxWidth)
 Populates all text lines in all text layers owned by this quad. More...
 
virtual void ProtoDeSerialize (const XML::Node &SelfRoot)
 Take the data stored in an XML Node and overwrite this object with it. More...
 
virtual void ProtoDeSerializeChildQuads (const XML::Node &SelfRoot)
 Take the data stored in an XML Node and overwrite the ChildQuads of this object with it. More...
 
virtual void ProtoDeSerializeRenderLayerGroups (const XML::Node &SelfRoot)
 Take the data stored in an XML Node and overwrite the RenderLayerGroups of this object with it. More...
 
virtual void ProtoDeSerializeRenderLayers (const XML::Node &SelfRoot)
 Take the data stored in an XML Node and overwrite the RenderLayers of this object with it. More...
 
virtual void ProtoSerialize (XML::Node &ParentNode) const
 Convert this class to an XML::Node ready for serialization. More...
 
virtual void ProtoSerializeChildQuads (XML::Node &SelfRoot) const
 Convert the child quads of this class to an XML::Node ready for serialization. More...
 
virtual void ProtoSerializeRenderLayerGroups (XML::Node &SelfRoot) const
 Convert the RenderLayerGroups of this class to an XML::Node ready for seriailization. More...
 
virtual void ProtoSerializeRenderLayers (XML::Node &SelfRoot) const
 Convert the RenderLayers of this class to an XML::Node ready for serialization. More...
 
ReverseChildIterator RChildrenBegin ()
 Gets an iterator to the last Widget. More...
 
ConstReverseChildIterator RChildrenBegin () const
 Gets a const iterator to the last Widget. More...
 
ReverseChildIterator RChildrenEnd ()
 Gets an iterator to one before the first child Widget. More...
 
ConstReverseChildIterator RChildrenEnd () const
 Gets a const iterator to one before the first child Widget. More...
 
virtual void RemoveAllChildren ()
 Removes all child Widgets from this QuadRenderable. More...
 
virtual void RemoveChild (Widget *ToBeRemoved)
 Removes a child Widget from this quadrenderable. More...
 
void RemoveLayerFromAllGroups (RenderLayer *Layer)
 Removes a single RenderLayer from all RenderLayerGroups owned by this QuadRenderable. More...
 
void RemoveLayerFromGroup (RenderLayer *Layer, const UInt16 GroupID)
 Removes a single RenderLayer from a specified RenderLayerGroup. More...
 
RenderLayerIterator RenderLayerBegin ()
 Gets an iterator to the first RenderLayer. More...
 
ConstRenderLayerIterator RenderLayerBegin () const
 Gets a const iterator to the first RenderLayer. More...
 
RenderLayerIterator RenderLayerEnd ()
 Gets an iterator to one passed the last RenderLayer. More...
 
ConstRenderLayerIterator RenderLayerEnd () const
 Gets an iterator to one passed the last RenderLayer. More...
 
RenderLayerGroupIterator RenderLayerGroupBegin ()
 Gets an iterator to the first RenderLayerGroup. More...
 
ConstRenderLayerGroupIterator RenderLayerGroupBegin () const
 Gets a const iterator to the first RenderLayerGroup. More...
 
RenderLayerGroupIterator RenderLayerGroupEnd ()
 Gets an iterator to one passed the last RenderLayerGroup. More...
 
ConstRenderLayerGroupIterator RenderLayerGroupEnd () const
 Gets an iterator to one passed the last RenderLayerGroup. More...
 
Boole RenderLayerGroupExists (const UInt16 GroupID) const
 Checks to see if a RenderLayerGroup exists. More...
 
void SetActiveGroup (const UInt16 GroupID)
 Sets the RenderLayerGroup that will be used to render this renderable. More...
 
void SetActiveGroup (RenderLayerGroup *Group)
 Sets the RenderLayerGroup that will be used to render this renderable. More...
 
virtual void SetAspectRatioLock (const UI::AspectRatioLock Lock)
 Sets how (and if) the aspect ratio of this quad is locked. More...
 
virtual void SetHorizontalPositioningRules (const Whole Rules)
 Sets the behavior this quad will have when it is positioned automatically on the X axis. More...
 
virtual void SetHorizontalSizingRules (const Whole Rules)
 Sets the behavior this quad will have on the X axis when it is resized. More...
 
void SetLocalVertexCaching (Boole Enable)
 Enables or disables caching of vertex's belonging to this and all child renderables. More...
 
virtual void SetManualTransformUpdates (Boole Enable)
 Sets whether or not this quad has specific behaviors for it's transform updates and they should not be done automatically. More...
 
virtual void SetMaxSize (const UnifiedVec2 &Max)
 Sets the maximum size this quad is allowed to have. More...
 
virtual void SetMinSize (const UnifiedVec2 &Min)
 Sets the minimum size this quad is allowed to have. More...
 
virtual void SetMousePassthrough (Boole Enable)
 Sets whether or not this quad should be skipped when determining if the mouse is hovered over this quad. More...
 
virtual void SetPositioningPolicy (const PositioningInfo &Policy)
 Sets the behavior to be used when this QuadRenderable is positioned. More...
 
virtual void SetSizingPolicy (const SizingInfo &Policy)
 Sets the behavior to be used when this QuadRenderable is sized. More...
 
virtual void SetUnifiedPosition (const UnifiedVec2 &Position)
 Sets the position this QuadRenderable will have within it's parent. More...
 
virtual void SetUnifiedSize (const UnifiedVec2 &Size)
 Sets the size this QuadRenderable will have within it's parent. More...
 
virtual void SetVerticalPositioningRules (const Whole Rules)
 Sets the behavior this quad will have when it is positioned automatically on the Y axis. More...
 
virtual void SetVerticalSizingRules (const Whole Rules)
 Sets the behavior this quad will have on the Y axis when it is resized. More...
 
virtual void UpdateChildDimensions ()
 Updates the dimensions of the children in this QuadRenderable. More...
 
virtual void UpdateChildOrder ()
 Updates the order of children in this QuadRenderable based on the ZOrder set on each child.
 
virtual void UpdateDimensions ()
 Updates the dimensions of this QuadRenderable based on the transform of it's parent. More...
 
virtual void UpdateDimensions (const Rect &OldSelfRect, const Rect &NewSelfRect)
 Updates the dimensions of this QuadRenderable based on the transform of it's parent. More...
 
- Public Member Functions inherited from Mezzanine::UI::Renderable
Boole _IsDirty () const
 Gets whether or not this renderable is dirty. More...
 
const StringGetName () const
 Gets the name of this renderable. More...
 
ScreenGetScreen () const
 Gets the parent screen of this renderable. More...
 
Boole IsScreen () const
 Gets whether or not this renderable is a Screen. More...
 
Boole IsWidget () const
 Gets whether or not this renderable is a Widget. More...
 
- Public Member Functions inherited from Mezzanine::EventPublisher
 EventPublisher ()
 Class constructor.
 
virtual ~EventPublisher ()
 Class destructor.
 
EventGetEvent (const String &EventName) const
 Gets an event in this publisher. More...
 
EventGetEventExcept (const String &EventName) const
 Gets an event in this publisher.

Exceptions
Thisversion differs from the non-except version in that if it fails to find the event specified it will throw a "II_IDENTITY_NOT_FOUND_EXCEPTION".
More...
 
Boole GetMuteEvents () const
 Gets whether or not event firings by this publisher will be suppressed. More...
 
void SetMuteEvents (const Boole Mute)
 Sets whether or not event firings by this publisher will be suppressed. More...
 
EventSubscriberSlotSubscribe (const String &EventName, EventSubscriber *Sub)
 Adds a subscriber to this event. More...
 
EventSubscriberSlotSubscribe (const String &EventName, FunctorEventSubscriber *Funct, Boole CleanUpAfter)
 Subscribes a functor object to this event. More...
 
EventSubscriberSlotSubscribe (const String &EventName, CFunctionSubscriberSlot::SubscriberFunction *CFunct)
 Subscribes a C-style function to this event. More...
 
EventSubscriberSlotSubscribe (const String &EventName, Scripting::iScript *SubScript)
 Subscribes a script to this event. More...
 
void Unsubscribe (EventSubscriber *Subscriber)
 Unsubscribes a single subscriber all events in this publisher. More...
 
void Unsubscribe (FunctorEventSubscriber *Funct)
 Unsubscribes a single subscriber all events in this publisher. More...
 
void Unsubscribe (CFunctionSubscriberSlot::SubscriberFunction *CFunct)
 Unsubscribes a single subscriber from all events in this publisher. More...
 
void Unsubscribe (Scripting::iScript *SubScript)
 Unsubscribes a single subscriber from all events in this publisher. More...
 
void Unsubscribe (EventSubscriberSlot *SubSlot)
 Unsubscribes a single subscriber from all events in this publisher. More...
 
void Unsubscribe (const String &EventName, EventSubscriber *Subscriber)
 Unsubscribes a single subscriber from the named event. More...
 
void Unsubscribe (const String &EventName, FunctorEventSubscriber *Funct)
 Unsubscribes a single subscriber from the named event. More...
 
void Unsubscribe (const String &EventName, CFunctionSubscriberSlot::SubscriberFunction *CFunct)
 Unsubscribes a single subscriber from the named event. More...
 
void Unsubscribe (const String &EventName, Scripting::iScript *SubScript)
 Unsubscribes a single subscriber from the named event. More...
 
void Unsubscribe (const String &EventName, EventSubscriberSlot *SubSlot)
 Unsubscribes a single subscriber from the named event. More...
 
Whole UnsubscribeAll ()
 Unsubscribes all subscribers from all events in this publisher. More...
 
Whole UnsubscribeAll (const String &EventName)
 Unsubscribes all subscribers from the named Event. More...
 

Static Public Member Functions

static String GetSerializableName ()
 Get the name of the the XML tag the Renderable class will leave behind as its instances are serialized. More...
 
- Static Public Member Functions inherited from Mezzanine::UI::Widget
static String GetSerializableName ()
 Get the name of the the XML tag the Renderable class will leave behind as its instances are serialized. More...
 
- Static Public Member Functions inherited from Mezzanine::UI::QuadRenderable
static String GetSerializableName ()
 Get the name of the the XML tag the Renderable class will leave behind as its instances are serialized. More...
 
- Static Public Member Functions inherited from Mezzanine::UI::Renderable
static String GetSerializableName ()
 Get the name of the the XML tag the Renderable class will leave behind as its instances are serialized. More...
 

Static Public Attributes

static const String EventScrollValueChanged = "ScrollValueChanged"
 Event name for when this scrollbar has his scrollvalue updated.
 
static const String TypeName = "Scrollbar"
 String containing the type name for this class: "Scrollbar".
 
- Static Public Attributes inherited from Mezzanine::UI::Widget
static const String EventFocusGained = "FocusGained"
 Event name for when this widget gains focus.
 
static const String EventFocusLocked = "FocusLocked"
 Event name for when the system locks focus on this widget.
 
static const String EventFocusLost = "FocusLost"
 Event name for when this widget loses focus.
 
static const String EventFocusUnlocked = "FocusUnlocked"
 Event name fow when the system removes the focus lock from this widget.
 
static const String EventMouseDragEnd = "MouseDragEnd"
 Event name for when the mouse stops dragging this widget.
 
static const String EventMouseDragStart = "MouseDragStart"
 Event name for when the mouse starts dragging this widget.
 
static const String EventMouseEnter = "MouseEnter"
 Event name for when the mouse enters this widget.
 
static const String EventMouseExit = "MouseExit"
 Event name for when the mouse leaves this widget.
 
static const String EventVisibilityHidden = "VisibilityHidden"
 Event name for when this widget is switched from being shown to being hidden.
 
static const String EventVisibilityShown = "VisibilityShown"
 Event name for when this widget is switched from being hidden to being shown.
 
static const String TypeName = "GenericWidget"
 String containing the type name for this class: "GenericWidget".
 

Protected Member Functions

virtual Real GetLowerScrollLimit () const =0
 Gets the pixel position of the lower limit the scroller can be placed on. More...
 
virtual Real GetScrollRange () const
 Gets the range on which the scroller can be placed. More...
 
virtual Real GetUpperScrollLimit () const =0
 Gets the pixel position of the upper limit the scroller can be placed on. More...
 
virtual Boole HandleInputImpl (const Input::MetaCode &Code)
 Consumes input for this widget's use. More...
 
virtual void SubscribeToChildEvents ()
 Subscribes to all the events of this scrollbars children we care about. Used only on construction. More...
 
- Protected Member Functions inherited from Mezzanine::UI::PageProvider
 PageProvider (Screen *Parent)
 Blank constructor. More...
 
 PageProvider (const String &RendName, Screen *Parent)
 Standard initialization constructor. More...
 
 PageProvider (const String &RendName, const UnifiedRect &RendRect, Screen *Parent)
 Rect constructor. More...
 
virtual ~PageProvider ()
 Standard destructor.
 
virtual void ProtoDeSerializeImpl (const XML::Node &SelfRoot)
 Implementation method for deseriailizing additional sets of data. More...
 
virtual void ProtoSerializeImpl (XML::Node &SelfRoot) const
 Implementation method for serializing additional sets of data. More...
 
- Protected Member Functions inherited from Mezzanine::UI::Widget
void ConstructWidget ()
 Contains all the common necessary startup initializations for this class. More...
 
virtual void HandleChildStateChangeImpl (Widget *Child, const UInt32 &OldState, const UInt32 &NewState)
 Handles the logic to execute when a child of this widget has it's state updated. More...
 
- Protected Member Functions inherited from Mezzanine::UI::QuadRenderable
void AppendLayerVertices (std::vector< VertexData > &Vertices)
 Adds all the vertices belonging to all the layers of this renderable to the provided vector. More...
 
RenderLayerGroupCreateRenderLayerGroupNoCheck (const UInt16 ID)
 Creates a new RenderLayerGroup with the provided ID, without checking if it is unique. More...
 
void ResizeLayers (const Whole NewSize)
 Resizes the container for RenderLayers in this QuadRenderable. More...
 
- Protected Member Functions inherited from Mezzanine::UI::Renderable
 Renderable (Screen *Parent)
 Blank constructor. More...
 
 Renderable (const String &RendName, Screen *Parent)
 Class constructor. More...
 
virtual ~Renderable ()
 Class destructor.
 
- Protected Member Functions inherited from Mezzanine::EventPublisher
EventAddEvent (const String &EventName)
 Creates a new event this Publisher can fire. More...
 
void FireEvent (EventArgumentsPtr Args)
 Fires an event. More...
 
void RemoveAllEvents ()
 Removes all events in this Publisher. More...
 
void RemoveEvent (const String &EventName)
 Removes an existing event in this Publisher. More...
 
- Protected Member Functions inherited from Mezzanine::EventSubscriber
 EventSubscriber ()
 Class constructor.
 
virtual ~EventSubscriber ()
 Class destructor.
 

Protected Attributes

Boole AutoHideScroll
 Stores whether or not this scrollbar should hide when there is 1 page or less of list items. Only used when this is set as a PageProvider. More...
 
ButtonChildLock
 This is a pointer to the specific child that is locked and being manipulated. More...
 
ButtonDownRightButton
 The Down/Right button that when clicked will move the scroller in that respective direction. More...
 
Real IncrementDistance
 The distance the scroller is to be moved when the up, left, down, or right buttons are clicked. More...
 
ButtonScrollBack
 The background around that can be clicked on and represents the valid bounds for the scroller. More...
 
ButtonScroller
 The manipulatable widget that represents the current position on the scrollbar/slider. More...
 
Real ScrollerSize
 The size of the scroller on the appropriate axis relative to the ScrollBack. More...
 
ButtonUpLeftButton
 The Up/Left button that when clicked will move the scroller in that respective direction. More...
 
- Protected Attributes inherited from Mezzanine::UI::PageProvider
PagedContainerContainer
 A pointer to the PagedContainer this scrollbar is providing page data for. More...
 
- Protected Attributes inherited from Mezzanine::UI::Widget
WidgetHoveredSubWidget
 The child widget of this widget the mouse is over, if any. More...
 
UInt32 State
 UInt32 describing the current state of this widget. More...
 
StateLayerGroupMap StateGroupBindings
 Map containing all the RenderLayerGroups bound to specific widget states. More...
 
- Protected Attributes inherited from Mezzanine::UI::QuadRenderable
Rect ActDims
 The actual (pixel) position and size of this Quad on the screen it belongs to. More...
 
RenderLayerGroupActiveGroup
 This is a pointer to the group of RenderLayers currently being used for rendering. More...
 
Boole AllLayersDirty
 Determines whether or not this Quad needs all of it's layers refreshed. Usually after a transform update. More...
 
ChildContainer ChildWidgets
 This is a container storing all the children that belong to this Quad. More...
 
LayoutStrategyLayoutStrat
 This is a pointer to the strategy being used by this Quad to determine the positions and sizes of children during transform updates. More...
 
Boole ManualTransformUpdates
 Controls whether or not this Quad and it's children will recieve automatic transform updates. More...
 
Boole MousePassthrough
 Controls whether or not this Quad will be considered for mouse hover checks. More...
 
QuadRenderableParentQuad
 This is a pointer to the Quad that owns this Quad and is responsible for transform updates applied to this Quad. More...
 
PositioningInfo PositioningPolicy
 This stores all the information needed to determine the specific behaviors this Quad should have when it's position is being updated. More...
 
RenderLayerGroupContainer RenderLayerGroups
 This is a container storing all the RenderLayerGroup instances created by and belonging to this Quad. More...
 
RenderLayerContainer RenderLayers
 This is a container storing all the RenderLayer instances created by and belonging to this Quad. More...
 
SizingInfo SizingPolicy
 This stores all the information needed to determine the specific behaviors this Quad should have when it's size is being updated. More...
 
ScreenRenderDataVertexCache
 This is a pointer to the optional cache of vertex's belonging to this Quad and all of it's children. More...
 
UInt16 ZOrder
 This is the ZOrder of this Quad in relation to all other Quads in it's parent. More...
 
- Protected Attributes inherited from Mezzanine::UI::Renderable
Boole Dirty
 Stores whether this Renderables vertices need to be regenerated. More...
 
String Name
 The unique name of this Renderable. More...
 
ScreenParentScreen
 A pointer to the Screen that created this Renderable. More...
 
Boole Visible
 Stores whether this Renderable is to be rendered (also dependent on parent visibility). More...
 
- Protected Attributes inherited from Mezzanine::EventPublisher
EventContainer Events
 A container storing all the Events published by this class by name. More...
 
Boole MuteEvents
 Stores whether or not events will actually be fired when requested. More...
 

Additional Inherited Members

- Public Types inherited from Mezzanine::UI::Widget
typedef StateLayerGroupMap::const_iterator ConstStateLayerGroupIterator
 Const Iterator type for RenderLayerGroup instances stored in relation to widget states.
 
typedef StateLayerGroupMap::iterator StateLayerGroupIterator
 Iterator type for RenderLayerGroup instances stored in relation to widget states.
 
typedef std::map< UInt32, RenderLayerGroup * > StateLayerGroupMap
 Container class for storing RenderLayerGroup instances in relation to widget states.
 
enum  WidgetGroupID {
  WG_Normal = 1, WG_Hovered = 2, WG_Focused = 3, WG_Dragged = 4,
  WG_Mezzanine_Reserved_1 = 9, WG_Mezzanine_Reserved_2 = 10, WG_Mezzanine_Reserved_3 = 11, WG_Mezzanine_Reserved_4 = 12,
  WG_User_Group_1 = 17, WG_User_Group_2 = 18, WG_User_Group_3 = 19, WG_User_Group_4 = 20
}
 Enum used to conveniently track the pre-made RenderLayerGroups used by Widgets.
 
enum  WidgetState {
  WS_Untouched = 0, WS_Hovered = 1, WS_Focused = 2, WS_Dragged = 4,
  WS_Mezzanine_Reserved_1 = 8, WS_Mezzanine_Reserved_2 = 16, WS_Mezzanine_Reserved_3 = 32, WS_Mezzanine_Reserved_4 = 64,
  WS_User_State_1 = 128, WS_User_State_2 = 256, WS_User_State_3 = 512, WS_User_State_4 = 1024
}
 Enum describing the current state of the widget.
 
- Public Types inherited from Mezzanine::UI::QuadRenderable
typedef std::vector< Widget * > ChildContainer
 Basic container type for Widget storage by this class.
 
typedef ChildContainer::iterator ChildIterator
 Iterator type for Widget instances stored by this class.
 
typedef ChildContainer::const_iterator ConstChildIterator
 Const Iterator type for Widget instances stored by this class.
 
typedef RenderLayerGroupContainer::const_iterator ConstRenderLayerGroupIterator
 Const Iterator type for RenderLayerGroup instances stored by this class.
 
typedef RenderLayerContainer::const_iterator ConstRenderLayerIterator
 Const Iterator type for RenderLayer instances stored by this class.
 
typedef ChildContainer::const_reverse_iterator ConstReverseChildIterator
 Const Reverse Iterator type for Widget instances stored by this class.
 
typedef std::vector< RenderLayer * > RenderLayerContainer
 Basic container type for RenderLayer storage by this class.
 
typedef std::vector< RenderLayerGroup * > RenderLayerGroupContainer
 Basic container type for RenderLayerGroup storage by this class.
 
typedef RenderLayerGroupContainer::iterator RenderLayerGroupIterator
 Iterator type for RenderLayerGroup instances stored by this class.
 
typedef RenderLayerContainer::iterator RenderLayerIterator
 Iterator type for RenderLayer instances stored by this class.
 
typedef ChildContainer::reverse_iterator ReverseChildIterator
 Reverse Iterator type for Widget instances stored by this class.
 
- Public Types inherited from Mezzanine::UI::Renderable
enum  RenderableType { RT_LineList, RT_Screen, RT_Widget }
 A small enum to describe the type of renderable this is.
 
- Public Types inherited from Mezzanine::EventPublisher
typedef EventContainer::const_iterator ConstEventIterator
 Const Iterator type for Event instances stored by this class.
 
typedef std::map< String, Event * > EventContainer
 Basic container type for Event storage by this class.
 
typedef EventContainer::iterator EventIterator
 Iterator type for Event instances stored by this class.
 

Detailed Description

This is the scrollbar base class.

If you want to have buttons to accompany your scrollbar they'll automatically have their height match the width of the scrollbar if it's vertical, or their width match their height of the scrollbar if it's horizontal, based on the dimensions provided.

Scrollbars can come in a few styles. Separate is the typical way to present them with the Up or Left button being located at the top of left side of the scroller respectively. Together is where both scroll buttons are next to each other instead of on opposite sides of the scroller.

Definition at line 126 of file scrollbar.h.

Constructor & Destructor Documentation

Mezzanine::UI::Scrollbar::Scrollbar ( Screen Parent)

Blank constructor.

Parameters
ParentThe parent screen that created this scrollbar.

Definition at line 63 of file scrollbar.cpp.

Mezzanine::UI::Scrollbar::Scrollbar ( const String RendName,
Screen Parent 
)

Standard initialization constructor.

Parameters
RendNameThe name to be given to this scrollbar.
ParentThe parent screen that created this scrollbar.

Definition at line 75 of file scrollbar.cpp.

Mezzanine::UI::Scrollbar::Scrollbar ( const String RendName,
const UnifiedRect RendRect,
Screen Parent 
)

Rect constructor.

Parameters
RendNameThe name to be given to this scrollbar.
RendRectThe rect describing this widget's transform relative to it's parent.
ParentThe parent screen that created this scrollbar.

Definition at line 87 of file scrollbar.cpp.

Member Function Documentation

virtual Boole Mezzanine::UI::Scrollbar::_ButtonScroll ( Button TheButton)
pure virtual

Performs the operations for when one of the buttons is pressed to manipulate the scroller.

Parameters
TheButtonThe button that was activated (or to simulate an activation for).
Returns
Returns true if the scroller was successfully moved, false otherwise.

Implemented in Mezzanine::UI::HorizontalScrollbar, and Mezzanine::UI::VerticalScrollbar.

virtual Boole Mezzanine::UI::Scrollbar::_MouseScroll ( const Vector2 MouseDelta)
pure virtual

Performs the operations for when the scroller is directly manipulated by the mouse.

Parameters
MouseDeltaThe amount in pixels the mouse has moved since the last frame.
Returns
Returns true if the scroller was successfully moved, false otherwise.

Implemented in Mezzanine::UI::HorizontalScrollbar, and Mezzanine::UI::VerticalScrollbar.

virtual Boole Mezzanine::UI::Scrollbar::_MouseWheelScroll ( const Integer  Direction)
pure virtual

Performs the operations for when the scroller is manipulated by the mouse wheel.

Parameters
DirectionThe direction of the mouse wheel spin. Usually this will be a casted Input::DirectionalMotionState value.
Returns
Returns true if the scroller was successfully moved, false otherwise.

Implemented in Mezzanine::UI::HorizontalScrollbar, and Mezzanine::UI::VerticalScrollbar.

void Mezzanine::UI::Scrollbar::_NotifyEvent ( EventArgumentsPtr  Args)
virtual

Notifies this subscriber of an event being fired.

Parameters
ArgsThe arguments containing specific information regarding this event.

Reimplemented from Mezzanine::UI::Widget.

Definition at line 251 of file scrollbar.cpp.

void Mezzanine::UI::Scrollbar::_OnScrollValueChanged ( const Real  OldValue,
const Real  NewValue 
)
virtual

Self logic to be executed when this scrollbar changes it's scrollvalue.

Parameters
OldValueThe previous value of this scrollbar.
NewValueThe updated value of this scrollbar.

Definition at line 238 of file scrollbar.cpp.

virtual Boole Mezzanine::UI::Scrollbar::_ScrollBackScroll ( const Vector2 HitPosition)
pure virtual

Performs the operations for when the scrollback is clicked on to manipulate the scroller.

Parameters
HitPositionThe location on the scroll back where the mouse was clicked (in screen coordinates).
Returns
Returns true if the scroller was successfully moved, false otherwise.

Implemented in Mezzanine::UI::HorizontalScrollbar, and Mezzanine::UI::VerticalScrollbar.

Boole Mezzanine::UI::Scrollbar::GetAutoHide ( ) const
virtual

Gets whether or not this scrollbar will hide when it's set page container has less than one page to display.

Returns
Returns true if this scrollbar is hiding when it's page container has less then one page to display, false if it's always visible.

Definition at line 165 of file scrollbar.cpp.

Button * Mezzanine::UI::Scrollbar::GetDownRightButton ( ) const
virtual

Gets the DownRight button within this widget, if it was initialized.

Returns
Returns a pointer to the DownRight button within this widget, or NULL if none.

Definition at line 177 of file scrollbar.cpp.

Real Mezzanine::UI::Scrollbar::GetIncrementDistance ( ) const
virtual

Gets the relative distance the scroller will move on a button press.

Returns
Returns a Real representing the relative distance to be moved on a button press.

Definition at line 159 of file scrollbar.cpp.

virtual Real Mezzanine::UI::Scrollbar::GetLowerScrollLimit ( ) const
protectedpure virtual

Gets the pixel position of the lower limit the scroller can be placed on.

Returns
Returns a Real representing the scrollers limit limit.

Implemented in Mezzanine::UI::HorizontalScrollbar, and Mezzanine::UI::VerticalScrollbar.

Button * Mezzanine::UI::Scrollbar::GetScrollBack ( ) const
virtual

Gets the Scroller background within this widget.

Returns
Returns a pointer to the Scroller background within this widget.

Definition at line 180 of file scrollbar.cpp.

Button * Mezzanine::UI::Scrollbar::GetScroller ( ) const
virtual

Gets the Scroller button within this widget.

Returns
Returns a pointer to the Scroller button within this widget.

Definition at line 171 of file scrollbar.cpp.

virtual Real Mezzanine::UI::Scrollbar::GetScrollerSize ( ) const
pure virtual

Gets the size of the scroller relative to the ScrollBack.

Returns
Returns a Real representing size of the scroller on the relevant axis relative to the ScrollBack.

Implemented in Mezzanine::UI::HorizontalScrollbar, and Mezzanine::UI::VerticalScrollbar.

virtual Real Mezzanine::UI::Scrollbar::GetScrollerValue ( ) const
pure virtual

Get the currnent scroll position represented by a value between 0 and 1.

For example, if the scroller is halfway down the limits it's allowed, this will return 0.5.
Like other values, the top and left represent origin(0) values.

Returns
Returns the stored scroll position.

Implemented in Mezzanine::UI::HorizontalScrollbar, and Mezzanine::UI::VerticalScrollbar.

Real Mezzanine::UI::Scrollbar::GetScrollRange ( ) const
protectedvirtual

Gets the range on which the scroller can be placed.

Returns
Returns the UpperScrollLimit minus the LowerScrollLimit.

Definition at line 148 of file scrollbar.cpp.

String Mezzanine::UI::Scrollbar::GetSerializableName ( )
static

Get the name of the the XML tag the Renderable class will leave behind as its instances are serialized.

Returns
A string containing the name of this class.

Definition at line 230 of file scrollbar.cpp.

Button * Mezzanine::UI::Scrollbar::GetUpLeftButton ( ) const
virtual

Gets the UpLeft button within this widget, if it was initialized.

Returns
Returns a pointer to the UpLeft button within this widget, or NULL if none.

Definition at line 174 of file scrollbar.cpp.

virtual Real Mezzanine::UI::Scrollbar::GetUpperScrollLimit ( ) const
protectedpure virtual

Gets the pixel position of the upper limit the scroller can be placed on.

Returns
Returns a Real representing the scrollers upper limit.

Implemented in Mezzanine::UI::HorizontalScrollbar, and Mezzanine::UI::VerticalScrollbar.

Boole Mezzanine::UI::Scrollbar::HandleInputImpl ( const Input::MetaCode Code)
protectedvirtual

Consumes input for this widget's use.

Parameters
CodeThe input to be processed.
Returns
Returns true if the input was handled, false otherwise.

Reimplemented from Mezzanine::UI::Widget.

Definition at line 102 of file scrollbar.cpp.

void Mezzanine::UI::Scrollbar::ProtoDeSerializeProperties ( const XML::Node SelfRoot)
virtual

Take the data stored in an XML Node and overwrite the properties of this object with it.

Parameters
SelfRootAn XML::Node containing the data to populate this class with.

Reimplemented from Mezzanine::UI::Widget.

Definition at line 202 of file scrollbar.cpp.

void Mezzanine::UI::Scrollbar::ProtoSerializeProperties ( XML::Node SelfRoot) const
virtual

Convert the properties of this class to an XML::Node ready for serialization.

Parameters
SelfRootThe root node containing all the serialized data for this instance.

Reimplemented from Mezzanine::UI::Widget.

Definition at line 186 of file scrollbar.cpp.

void Mezzanine::UI::Scrollbar::SetAutoHide ( Boole  AutoHide)
virtual

Sets whether or not this scrollbar will hide when it's set page container has less than one page to display.

Parameters
AutoHideTrue to make this hide when this scrollbars page container doesn't have more than one page to display, false to make this always visible.

Definition at line 162 of file scrollbar.cpp.

void Mezzanine::UI::Scrollbar::SetIncrementDistance ( const Real IncDist)
virtual

Sets the relative distance the scroller will move when the up/left or down/right buttons are pressed.

Remarks
Default: 0.1.
Parameters
IncDistA real representing the amount to increment. Can be negative.

Definition at line 156 of file scrollbar.cpp.

virtual void Mezzanine::UI::Scrollbar::SetScrollerSize ( const Real Size)
pure virtual

Sets the length(or height) of the scroller based on the relative size of it's background.

Parameters
SizeThe relative size you with to set the scroller to. Range: 0.0 to 1.0

Implemented in Mezzanine::UI::HorizontalScrollbar, and Mezzanine::UI::VerticalScrollbar.

virtual void Mezzanine::UI::Scrollbar::SetScrollerValue ( const Real Value)
pure virtual

Sets the value of this scrollbar and warps the scroller to that respective position.

Parameters
ValueThe value to be set for this scrollbar. Range: 0.0 to 1.0.

Implemented in Mezzanine::UI::HorizontalScrollbar, and Mezzanine::UI::VerticalScrollbar.

void Mezzanine::UI::Scrollbar::SubscribeToChildEvents ( )
protectedvirtual

Subscribes to all the events of this scrollbars children we care about. Used only on construction.

Definition at line 126 of file scrollbar.cpp.

Member Data Documentation

Boole Mezzanine::UI::Scrollbar::AutoHideScroll
protected

Stores whether or not this scrollbar should hide when there is 1 page or less of list items. Only used when this is set as a PageProvider.

Definition at line 159 of file scrollbar.h.

Button* Mezzanine::UI::Scrollbar::ChildLock
protected

This is a pointer to the specific child that is locked and being manipulated.

Definition at line 150 of file scrollbar.h.

Button* Mezzanine::UI::Scrollbar::DownRightButton
protected

The Down/Right button that when clicked will move the scroller in that respective direction.

Remarks
Depending on the button configuration this can be NULL for the lifetime of the widget.

Definition at line 147 of file scrollbar.h.

Real Mezzanine::UI::Scrollbar::IncrementDistance
protected

The distance the scroller is to be moved when the up, left, down, or right buttons are clicked.

Definition at line 153 of file scrollbar.h.

Button* Mezzanine::UI::Scrollbar::ScrollBack
protected

The background around that can be clicked on and represents the valid bounds for the scroller.

Definition at line 139 of file scrollbar.h.

Button* Mezzanine::UI::Scrollbar::Scroller
protected

The manipulatable widget that represents the current position on the scrollbar/slider.

Definition at line 136 of file scrollbar.h.

Real Mezzanine::UI::Scrollbar::ScrollerSize
protected

The size of the scroller on the appropriate axis relative to the ScrollBack.

Definition at line 156 of file scrollbar.h.

Button* Mezzanine::UI::Scrollbar::UpLeftButton
protected

The Up/Left button that when clicked will move the scroller in that respective direction.

Remarks
Depending on the button configuration this can be NULL for the lifetime of the widget.

Definition at line 143 of file scrollbar.h.


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