Support Forum G3D Web Page |
Inherits G3D::GuiControl.
Public Member Functions | |
GuiScrollBar (GuiContainer *parent, const Pointer< float > &value, float maxValue, float extent=1, bool vertical=true, GuiControl *eventSource=nullptr) | |
const GuiText & | caption () const |
float | captionHeight () const |
For controls that have a caption outside the bounds of the control on the top or bottom, this is the size reserved for the caption. More... | |
float | captionWidth () const |
For controls that have a caption outside the bounds of the control on the left, this is the size reserved for the caption. More... | |
const Rect2D & | clickRect () const |
Used by GuiContainers. More... | |
virtual float | defaultCaptionHeight () const |
Default caption size for this control. More... | |
virtual float | defaultCaptionWidth () const |
bool | enabled () const |
virtual void | findControlUnderMouse (Vector2 mouse, GuiControl *&control) |
Return the enabled, visible control containing the mouse. More... | |
bool | focused () const |
Vector2 | fromOSWindowCoords (const Vector2 &v) const |
Transforms v from OS window coordinates to this control's coordinates. More... | |
bool | mouseOver () const |
void | moveBy (const Vector2 &delta) |
void | moveBy (float dx, float dy) |
void | moveRightOf (const GuiControl *control, const Vector2 &offset) |
If these two controls have the same parent, move this one immediately to the right of the argument. More... | |
void | moveRightOf (const GuiControl *control, float offsetX=0.0f) |
const Rect2D & | rect () const |
virtual void | render (RenderDevice *rd, const shared_ptr< GuiTheme > &theme, bool ancestorsEnabled) const override |
Only methods on theme may be called from this method by default. More... | |
virtual void | setCaption (const GuiText &caption) |
virtual void | setCaptionHeight (float c) |
virtual void | setCaptionWidth (float c) |
virtual void | setEnabled (bool e) |
void | setEventSource (GuiControl *c) |
void | setExtent (float extent) |
void | setFocused (bool b) |
Grab or release keyboard focus. More... | |
void | setHeight (float h) |
void | setMax (float max) |
void | setPosition (const Vector2 &v) |
void | setPosition (float x, float y) |
virtual void | setRect (const Rect2D &rect) |
If you explicitly change the rectangle of a control, the containing pane may clip its borders. More... | |
void | setSize (const Vector2 &v) |
void | setSize (float x, float y) |
void | setThumbPos (float pos) |
void | setVisible (bool b) |
void | setWidth (float w) |
shared_ptr< GuiTheme > | theme () const |
virtual bool | toolStyle () const |
Return true if this is in tool button style. More... | |
Vector2 | toOSWindowCoords (const Vector2 &v) const |
Returns the coordinates of v, which is in the coordinate system of this object, relative to the OSWindow on which it will be rendered. More... | |
Rect2D | toOSWindowCoords (const Rect2D &r) const |
bool | visible () const |
GuiWindow * | window () const |
Get the window containing this control. More... | |
Protected Types | |
enum | { LEFT_CAPTION_WIDTH = 80, TOP_CAPTION_HEIGHT = 20 } |
enum | State { NONE, ARROW_UP_SCROLLING, ARROW_DOWN_SCROLLING, ARROW_UP, ARROW_DOWN, IN_DRAG } |
Protected Member Functions | |
void | fireEvent (GEventType type) |
Fires an event. More... | |
float | floatValue () const |
returns the value of the thumb from 0 to the maxValue/extent - 1. More... | |
void | getAllBounds (Rect2D &top, Rect2D &bottom, Rect2D &barBounds, Rect2D &thumbBounds) const |
float | maxValue () const |
returns the max value that thumb pos can be, when everything is called by m_extent. More... | |
virtual bool | onEvent (const GEvent &event) override |
Events are only delivered (by GuiWindow) to a GuiControl when the control has the key focus. More... | |
void | setFloatValue (float f) |
Set value on the range set the value of thumb pos; used only in render and on event. More... | |
void | updateScroll () |
Protected Attributes | |
GuiText | m_caption |
float | m_captionHeight |
float | m_captionWidth |
Rect2D | m_clickRect |
Rect bounds used for mouse actions. More... | |
Vector2 | m_dragStart |
Position from which the mouse drag started, relative to m_gui.m_clientRect. More... | |
float | m_dragStartValue |
bool | m_enabled |
GuiControl * | m_eventSource |
Sent events should appear to be from this object, which is usually "this". More... | |
float | m_extent |
GuiWindow * | m_gui |
The window that ultimately contains this control. More... | |
float | m_maxValue |
GuiContainer * | m_parent |
Parent pane. More... | |
Rect2D | m_rect |
Rect bounds used for rendering and layout. More... | |
State | m_state |
Pointer< float > | m_value |
bool | m_vertical |
bool | m_visible |
Friends | |
class | GuiPane |
class | GuiWindow |
|
protected |
G3D::GuiScrollBar::GuiScrollBar | ( | GuiContainer * | parent, |
const Pointer< float > & | value, | ||
float | maxValue, | ||
float | extent = 1 , |
||
bool | vertical = true , |
||
GuiControl * | eventSource = nullptr |
||
) |
maxValue | - Is the maximum length of the slider. value will never reach it, the highest it will give is maxValue - extent. |
extent | - extent is the size of a single screen or single situation. If maxValue is twice as large as extent then the thumb will be exactly half as long as the track. |
eventSource | - If used in any hybrid controls should be set to the pane it is on so that all events fired from the scroll bar come from that pane. |
|
inherited |
Referenced by G3D::GuiPane::addDropDownList(), G3D::GuiPane::addMultiLineTextBox(), and G3D::GuiPane::addTextBox().
|
inherited |
For controls that have a caption outside the bounds of the control on the top or bottom, this is the size reserved for the caption.
|
inherited |
For controls that have a caption outside the bounds of the control on the left, this is the size reserved for the caption.
|
inlineinherited |
Used by GuiContainers.
|
inlinevirtualinherited |
Default caption size for this control.
Reimplemented in G3D::GuiFunctionBox.
|
inlinevirtualinherited |
|
inherited |
Referenced by G3D::GuiNumberBox< int >::render().
|
inlinevirtualinherited |
Return the enabled, visible control containing the mouse.
The default implementation returns itself if the mouse is within its bounds. GuiContainers should override this to iterate through children. Since only one (non-overlapping) child will write to control, it is sufficient to call this on all children without testing to see if one already wrote to control.
Reimplemented in G3D::GuiNumberBox< Value >, G3D::GuiNumberBox< float >, G3D::GuiNumberBox< int >, G3D::GuiTextureBox, G3D::GuiPane, G3D::GuiScrollPane, G3D::GuiFrameBox, and G3D::GuiTabPane.
Referenced by G3D::GuiNumberBox< int >::findControlUnderMouse().
|
protectedinherited |
Fires an event.
|
inlineprotected |
returns the value of the thumb from 0 to the maxValue/extent - 1.
which is the amount of thumbW it is from the top of the bar.
|
inherited |
Transforms v from OS window coordinates to this control's coordinates.
|
protected |
|
inlineprotected |
returns the max value that thumb pos can be, when everything is called by m_extent.
N.B. not the same as m_maxValue - this returns the number of bar lengths away from the top where as m_maxValue is the maximum pixel value
|
inherited |
|
inherited |
|
inherited |
|
inherited |
If these two controls have the same parent, move this one immediately to the right of the argument.
offset | May be negative |
Referenced by G3D::GuiControl::moveRightOf().
|
inlineinherited |
|
overrideprotectedvirtual |
Events are only delivered (by GuiWindow) to a GuiControl when the control has the key focus.
If the control does not consume the event, the event is delivered to each of its GUI parents in order, back to the window's root pane.
Key focus is transferred during a mouse down event.
Reimplemented from G3D::GuiControl.
|
inherited |
|
overridevirtual |
Only methods on theme may be called from this method by default.
To make arbitrary RenderDevice calls, wrap them in GuiTheme::pauseRendering ... GuiTheme::resumeRendering.
Implements G3D::GuiControl.
|
virtualinherited |
Reimplemented in G3D::GuiNumberBox< Value >, G3D::GuiNumberBox< float >, G3D::GuiNumberBox< int >, G3D::GuiTextureBox, and G3D::GuiPane.
Referenced by G3D::GuiNumberBox< int >::setCaption().
|
virtualinherited |
|
virtualinherited |
|
virtualinherited |
Reimplemented in G3D::GuiNumberBox< Value >, G3D::GuiNumberBox< float >, G3D::GuiNumberBox< int >, and G3D::GuiFrameBox.
Referenced by G3D::GuiNumberBox< int >::setEnabled().
|
inlineinherited |
|
inline |
|
inlineprotected |
Set value on the range set the value of thumb pos; used only in render and on event.
to set value of thumb pos use setThumbPos
|
inherited |
Grab or release keyboard focus.
|
inherited |
|
inline |
|
inherited |
|
inherited |
|
virtualinherited |
If you explicitly change the rectangle of a control, the containing pane may clip its borders.
Call pack() on the containing pane (or window) to resize that container appropriately.
Reimplemented in G3D::GuiNumberBox< Value >, G3D::GuiNumberBox< float >, G3D::GuiNumberBox< int >, G3D::GuiTextureBox, G3D::GuiPane, G3D::GuiTextBox, G3D::GuiDropDownList, G3D::GuiScrollPane, G3D::GuiTabPane, G3D::GuiContainer, G3D::GuiFrameBox, G3D::GuiRadioButton, and G3D::GuiCheckBox.
|
inherited |
Referenced by G3D::GuiPane::addRadioButton().
|
inherited |
|
inline |
|
inherited |
|
inherited |
|
inherited |
|
inlinevirtualinherited |
Return true if this is in tool button style.
Reimplemented in G3D::GuiRadioButton, G3D::GuiButton, and G3D::GuiCheckBox.
Returns the coordinates of v, which is in the coordinate system of this object, relative to the OSWindow on which it will be rendered.
Referenced by G3D::GuiControl::toOSWindowCoords().
|
protected |
|
inherited |
|
inherited |
Get the window containing this control.
|
friend |
|
friend |
|
protectedinherited |
Referenced by G3D::GuiNumberBox< int >::render().
|
protectedinherited |
|
protectedinherited |
Referenced by G3D::GuiNumberBox< int >::setRect().
|
protectedinherited |
|
protected |
Position from which the mouse drag started, relative to m_gui.m_clientRect.
When dragging the thumb, the cursor may not be centered on the thumb the way it is when the mouse clicks on the track.
|
protected |
|
protectedinherited |
|
protectedinherited |
Sent events should appear to be from this object, which is usually "this".
Other controls can set the event source to create compound controls that seem atomic from the outside.
Referenced by G3D::GuiSlider< int >::GuiSlider(), G3D::GuiNumberBox< Value >::MyTextBox::MyTextBox(), and G3D::GuiControl::setEventSource().
|
protected |
Referenced by floatValue(), maxValue(), setExtent(), setFloatValue(), and setThumbPos().
|
protectedinherited |
The window that ultimately contains this control.
|
protected |
Referenced by maxValue(), setMax(), and setThumbPos().
|
protectedinherited |
Parent pane.
|
protectedinherited |
Rect bounds used for rendering and layout.
Relative to the enclosing pane's clientRect.
Referenced by G3D::GuiControl::findControlUnderMouse(), G3D::GuiNumberBox< int >::render(), G3D::GuiNumberBox< int >::setCaption(), and G3D::GuiNumberBox< int >::setRect().
|
protected |
|
protected |
Referenced by floatValue(), setFloatValue(), and setThumbPos().
|
protected |
|
protectedinherited |