OGRE  1.10.12
Object-Oriented Graphics Rendering Engine
OgreBites::TextBox Class Reference

Scrollable text box widget. More...

#include <OgreTrays.h>

+ Inheritance diagram for OgreBites::TextBox:

Public Member Functions

 TextBox (const Ogre::String &name, const Ogre::DisplayString &caption, Ogre::Real width, Ogre::Real height)
 Do not instantiate any widgets directly. Use TrayManager. More...
 
void _assignListener (TrayListener *listener)
 
void _assignToTray (TrayLocation trayLoc)
 
void _cursorMoved (const Ogre::Vector2 &cursorPos, float wheelDelta)
 
void _cursorPressed (const Ogre::Vector2 &cursorPos)
 
void _cursorReleased (const Ogre::Vector2 &cursorPos)
 
void _focusLost ()
 
void appendText (const Ogre::DisplayString &text)
 
void cleanup ()
 
void clearText ()
 
const Ogre::DisplayStringgetCaption ()
 
unsigned int getHeightInLines ()
 Gets how many lines of text can fit in this window. More...
 
const Ogre::StringgetName ()
 
Ogre::OverlayElementgetOverlayElement ()
 
Ogre::Real getPadding ()
 
Ogre::Real getScrollPercentage ()
 Gets how far scrolled down the text is as a percentage. More...
 
const Ogre::DisplayStringgetText ()
 
TrayLocation getTrayLocation ()
 
void hide ()
 
bool isVisible ()
 
void refitContents ()
 Makes adjustments based on new padding, size, or alignment info. More...
 
void setCaption (const Ogre::DisplayString &caption)
 
void setPadding (Ogre::Real padding)
 
void setScrollPercentage (Ogre::Real percentage)
 Sets how far scrolled down the text is as a percentage. More...
 
void setText (const Ogre::DisplayString &text)
 Sets text box content. More...
 
void setTextAlignment (Ogre::TextAreaOverlayElement::Alignment ta)
 Sets text box content horizontal alignment. More...
 
void show ()
 

Static Public Member Functions

static Ogre::Vector2 cursorOffset (Ogre::OverlayElement *element, const Ogre::Vector2 &cursorPos)
 Static utility method used to get the cursor's offset from the center of an overlay element in pixels. More...
 
static void fitCaptionToArea (const Ogre::DisplayString &caption, Ogre::TextAreaOverlayElement *area, Ogre::Real maxWidth)
 Static utility method to cut off a string to fit in a text area. More...
 
static Ogre::Real getCaptionWidth (const Ogre::DisplayString &caption, Ogre::TextAreaOverlayElement *area)
 Static utility method used to get the width of a caption in a text area. More...
 
static bool isCursorOver (Ogre::OverlayElement *element, const Ogre::Vector2 &cursorPos, Ogre::Real voidBorder=0)
 Static utility method to check if the cursor is over an overlay element. More...
 
static void nukeOverlayElement (Ogre::OverlayElement *element)
 Static utility method to recursively delete an overlay element plus all of its children from the system. More...
 

Detailed Description

Scrollable text box widget.

Constructor & Destructor Documentation

◆ TextBox()

OgreBites::TextBox::TextBox ( const Ogre::String name,
const Ogre::DisplayString caption,
Ogre::Real  width,
Ogre::Real  height 
)

Do not instantiate any widgets directly. Use TrayManager.

Member Function Documentation

◆ setPadding()

void OgreBites::TextBox::setPadding ( Ogre::Real  padding)

◆ getPadding()

Ogre::Real OgreBites::TextBox::getPadding ( )
inline

◆ getCaption()

const Ogre::DisplayString& OgreBites::TextBox::getCaption ( )
inline

◆ setCaption()

void OgreBites::TextBox::setCaption ( const Ogre::DisplayString caption)
inline

◆ getText()

const Ogre::DisplayString& OgreBites::TextBox::getText ( )
inline

◆ setText()

void OgreBites::TextBox::setText ( const Ogre::DisplayString text)

Sets text box content.

Most of this method is for wordwrap.

◆ setTextAlignment()

void OgreBites::TextBox::setTextAlignment ( Ogre::TextAreaOverlayElement::Alignment  ta)

Sets text box content horizontal alignment.

◆ clearText()

void OgreBites::TextBox::clearText ( )
inline

◆ appendText()

void OgreBites::TextBox::appendText ( const Ogre::DisplayString text)
inline

◆ refitContents()

void OgreBites::TextBox::refitContents ( )

Makes adjustments based on new padding, size, or alignment info.

◆ setScrollPercentage()

void OgreBites::TextBox::setScrollPercentage ( Ogre::Real  percentage)

Sets how far scrolled down the text is as a percentage.

◆ getScrollPercentage()

Ogre::Real OgreBites::TextBox::getScrollPercentage ( )
inline

Gets how far scrolled down the text is as a percentage.

◆ getHeightInLines()

unsigned int OgreBites::TextBox::getHeightInLines ( )
inline

Gets how many lines of text can fit in this window.

◆ _cursorPressed()

void OgreBites::TextBox::_cursorPressed ( const Ogre::Vector2 cursorPos)
virtual

Reimplemented from OgreBites::Widget.

◆ _cursorReleased()

void OgreBites::TextBox::_cursorReleased ( const Ogre::Vector2 cursorPos)
inlinevirtual

Reimplemented from OgreBites::Widget.

◆ _cursorMoved()

void OgreBites::TextBox::_cursorMoved ( const Ogre::Vector2 cursorPos,
float  wheelDelta 
)
virtual

Reimplemented from OgreBites::Widget.

◆ _focusLost()

void OgreBites::TextBox::_focusLost ( )
inlinevirtual

Reimplemented from OgreBites::Widget.

◆ cleanup()

void OgreBites::Widget::cleanup ( )
inherited

◆ nukeOverlayElement()

static void OgreBites::Widget::nukeOverlayElement ( Ogre::OverlayElement element)
staticinherited

Static utility method to recursively delete an overlay element plus all of its children from the system.

◆ isCursorOver()

static bool OgreBites::Widget::isCursorOver ( Ogre::OverlayElement element,
const Ogre::Vector2 cursorPos,
Ogre::Real  voidBorder = 0 
)
staticinherited

Static utility method to check if the cursor is over an overlay element.

◆ cursorOffset()

static Ogre::Vector2 OgreBites::Widget::cursorOffset ( Ogre::OverlayElement element,
const Ogre::Vector2 cursorPos 
)
staticinherited

Static utility method used to get the cursor's offset from the center of an overlay element in pixels.

◆ getCaptionWidth()

static Ogre::Real OgreBites::Widget::getCaptionWidth ( const Ogre::DisplayString caption,
Ogre::TextAreaOverlayElement area 
)
staticinherited

Static utility method used to get the width of a caption in a text area.

◆ fitCaptionToArea()

static void OgreBites::Widget::fitCaptionToArea ( const Ogre::DisplayString caption,
Ogre::TextAreaOverlayElement area,
Ogre::Real  maxWidth 
)
staticinherited

Static utility method to cut off a string to fit in a text area.

◆ getOverlayElement()

Ogre::OverlayElement* OgreBites::Widget::getOverlayElement ( )
inlineinherited

◆ getName()

const Ogre::String& OgreBites::Widget::getName ( void  )
inlineinherited

◆ getTrayLocation()

TrayLocation OgreBites::Widget::getTrayLocation ( )
inlineinherited

◆ hide()

void OgreBites::Widget::hide ( )
inlineinherited

◆ show()

void OgreBites::Widget::show ( )
inlineinherited

◆ isVisible()

bool OgreBites::Widget::isVisible ( void  )
inlineinherited

◆ _assignToTray()

void OgreBites::Widget::_assignToTray ( TrayLocation  trayLoc)
inlineinherited

◆ _assignListener()

void OgreBites::Widget::_assignListener ( TrayListener listener)
inlineinherited

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