Torque Game Engine Documentation
TGE Version 1.5.2

GuiControlProfile Class Reference

#include <guiTypes.h>

Inheritance diagram for GuiControlProfile:

Detailed Description

A GuiControlProfile is used by every GuiObject and is akin to a datablock.

It is used to control information that does not change or is unlikely to change during execution of a program. It is also a level of abstraction between script and GUI control so that you can use the same control, say a button, and have it look completly different just with a different profile.

Public Types

enum {
  BaseColor = 0,
  ColorHL,
  ColorNA,
  ColorSEL,
  ColorUser0,
  ColorUser1,
  ColorUser2,
  ColorUser3,
  ColorUser4,
  ColorUser5
}

enum AlignmentType {
  LeftJustify,
  RightJustify,
  CenterJustify
}

Public Member Functions

DECLARE_CONOBJECT (GuiControlProfile)

GuiControlProfile ()

~GuiControlProfile ()

bool onAdd ()

Called when the object is added to the sim.

S32 constructBitmapArray ()

This method creates an array of bitmaps from one single bitmap with seperator color.

void incRefCount ()

void decRefCount ()

Static Public Member Functions

static void initPersistFields ()

Register dynamic fields in a subclass of ConsoleObject.

Data Fields

S32 mRefCount

Used to determine if any controls are using this profile.

bool mTabable

True if this object is accessable from using the tab key.

bool mCanKeyFocus

True if the object can be given keyboard focus (in other words, made a first responder.

bool mModal

True if this is a Modeless dialog meaning it will pass input through instead of taking it all.

bool mOpaque

True if this object is not translucent.

ColorI mFillColor

Fill color, this is used to fill the bounds of the control if it is opaque.

ColorI mFillColorHL

This is used insetead of mFillColor if the object is highlited.

ColorI mFillColorNA

This is used to instead of mFillColor if the object is not active or disabled.

S32 mBorder

For most controls, if mBorder is > 0 a border will be drawn, some controls use this to draw different types of borders however.

S32 mBorderThickness

Border thickness.

ColorI mBorderColor

Border color, used to draw a border around the bounds if border is enabled.

ColorI mBorderColorHL

Used instead of mBorderColor when the object is highlited.

ColorI mBorderColorNA

Used instead of mBorderColor when the object is not active or disabled.

ColorI mBevelColorHL

Used for the high-light part of the bevel.

ColorI mBevelColorLL

Used for the low-light part of the bevel.

StringTableEntry mFontType

Font face name for the control.

S32 mFontSize

Font size for the control.

ColorI mFontColors [10]

Array of font colors used for drawText with escape characters for changing color mid-string.

ColorI & mFontColor

Main font color.

ColorI & mFontColorHL

Highlited font color.

ColorI & mFontColorNA

Font color when object is not active/disabled.

ColorI & mFontColorSEL

Font color when object/text is selected.

FontCharset mFontCharset

Font character set.

Resource< GFont > mFont

Font resource.

AlignmentType mAlignment

Horizontal text alignment.

bool mAutoSizeWidth

Auto-size the width-bounds of the control to fit it's contents.

bool mAutoSizeHeight

Auto-size the height-bounds of the control to fit it's contents.

bool mReturnTab

Used in GuiTextEditCtrl to specify if a tab-event should be simulated when return is pressed.

bool mNumbersOnly

For text controls, true if this should only accept numerical data.

bool mMouseOverSelected

True if this object should be "selected" while the mouse is over it.

ColorI mCursorColor

Color for the blinking cursor in text fields (for example).

Point2I mTextOffset

Text offset for the control.

StringTableEntry mBitmapName

Bitmap file name for the bitmap of the control.

TextureHandle mTextureHandle

Texture handle for the control.

Vector< RectI > mBitmapArrayRects

Used for controls which use an array of bitmaps such as checkboxes.

AudioProfile * mSoundButtonDown

Sound played when the object is "down" ie a button is pushed.

AudioProfile * mSoundButtonOver

Sound played when the mouse is over the object.

GuiControlProfile * mProfileForChildren

Profile used with children controls (such as the scroll bar on a popup menu) when defined.

Static Public Attributes

static StringTableEntry sFontCacheDirectory

Private Types

typedef SimObject Parent

Member Typedef Documentation

typedef SimObject GuiControlProfile::Parent [private]

Reimplemented from SimObject.

Member Enumeration Documentation

anonymous enum

Enumerator:

BaseColor
ColorHL
ColorNA
ColorSEL
ColorUser0
ColorUser1
ColorUser2
ColorUser3
ColorUser4
ColorUser5

enum GuiControlProfile::AlignmentType

Enumerator:

LeftJustify
RightJustify
CenterJustify

Constructor & Destructor Documentation

GuiControlProfile::GuiControlProfile ( )

GuiControlProfile::~GuiControlProfile ( )

Member Function Documentation

GuiControlProfile::DECLARE_CONOBJECT ( GuiControlProfile )

static void GuiControlProfile::initPersistFields ( ) [static]

See also:: addField(), addFieldV(), addDepricatedField(), addGroup(), endGroup()

Reimplemented from SimObject.

bool GuiControlProfile::onAdd ( ) [virtual]

Called when the object is added to the sim.

Reimplemented from SimObject.

S32 GuiControlProfile::constructBitmapArray ( )

This method creates an array of bitmaps from one single bitmap with seperator color.

The seperator color is whatever color is in pixel 0,0 of the bitmap. For an example see darkWindow.png and some of the other UI textures. It returns the number of bitmaps in the array it created It also stores the sizes in the mBitmapArrayRects vector.

void GuiControlProfile::incRefCount ( )

void GuiControlProfile::decRefCount ( )

Field Documentation

S32 GuiControlProfile::mRefCount

Used to determine if any controls are using this profile.

bool GuiControlProfile::mTabable

True if this object is accessable from using the tab key.

StringTableEntry GuiControlProfile::sFontCacheDirectory [static]

bool GuiControlProfile::mCanKeyFocus

True if the object can be given keyboard focus (in other words, made a first responder.

See also:: GuiControl)

bool GuiControlProfile::mModal

True if this is a Modeless dialog meaning it will pass input through instead of taking it all.

bool GuiControlProfile::mOpaque

True if this object is not translucent.

ColorI GuiControlProfile::mFillColor

Fill color, this is used to fill the bounds of the control if it is opaque.

ColorI GuiControlProfile::mFillColorHL

This is used insetead of mFillColor if the object is highlited.

ColorI GuiControlProfile::mFillColorNA

This is used to instead of mFillColor if the object is not active or disabled.

S32 GuiControlProfile::mBorder

For most controls, if mBorder is > 0 a border will be drawn, some controls use this to draw different types of borders however.

See also:: guiDefaultControlRender.cc

S32 GuiControlProfile::mBorderThickness

Border thickness.

ColorI GuiControlProfile::mBorderColor

Border color, used to draw a border around the bounds if border is enabled.

ColorI GuiControlProfile::mBorderColorHL

Used instead of mBorderColor when the object is highlited.

ColorI GuiControlProfile::mBorderColorNA

Used instead of mBorderColor when the object is not active or disabled.

ColorI GuiControlProfile::mBevelColorHL

Used for the high-light part of the bevel.

ColorI GuiControlProfile::mBevelColorLL

Used for the low-light part of the bevel.

StringTableEntry GuiControlProfile::mFontType

Font face name for the control.

S32 GuiControlProfile::mFontSize

Font size for the control.

ColorI GuiControlProfile::mFontColors[10]

Array of font colors used for drawText with escape characters for changing color mid-string.

ColorI& GuiControlProfile::mFontColor

Main font color.

ColorI& GuiControlProfile::mFontColorHL

Highlited font color.

ColorI& GuiControlProfile::mFontColorNA

Font color when object is not active/disabled.

ColorI& GuiControlProfile::mFontColorSEL

Font color when object/text is selected.

FontCharset GuiControlProfile::mFontCharset

Font character set.

Resource<GFont> GuiControlProfile::mFont

Font resource.

AlignmentType GuiControlProfile::mAlignment

Horizontal text alignment.

bool GuiControlProfile::mAutoSizeWidth

Auto-size the width-bounds of the control to fit it's contents.

bool GuiControlProfile::mAutoSizeHeight

Auto-size the height-bounds of the control to fit it's contents.

bool GuiControlProfile::mReturnTab

Used in GuiTextEditCtrl to specify if a tab-event should be simulated when return is pressed.

bool GuiControlProfile::mNumbersOnly

For text controls, true if this should only accept numerical data.

bool GuiControlProfile::mMouseOverSelected

True if this object should be "selected" while the mouse is over it.

ColorI GuiControlProfile::mCursorColor

Color for the blinking cursor in text fields (for example).

Point2I GuiControlProfile::mTextOffset

Text offset for the control.

StringTableEntry GuiControlProfile::mBitmapName

Bitmap file name for the bitmap of the control.

TextureHandle GuiControlProfile::mTextureHandle

Texture handle for the control.

Vector<RectI> GuiControlProfile::mBitmapArrayRects

Used for controls which use an array of bitmaps such as checkboxes.

AudioProfile* GuiControlProfile::mSoundButtonDown

Sound played when the object is "down" ie a button is pushed.

AudioProfile* GuiControlProfile::mSoundButtonOver

Sound played when the mouse is over the object.

GuiControlProfile* GuiControlProfile::mProfileForChildren

Profile used with children controls (such as the scroll bar on a popup menu) when defined.