WidgetSlider Class Template Reference
[Widgets]

Slider Control class. More...

Inherits MessageMapControl< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, MessageMapPolicy >, AspectBorder< SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy > >, AspectEnabled< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, SmartWin::MessageMapControl< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, MessageMapPolicy > >, AspectFocus< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, SmartWin::MessageMapControl< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, MessageMapPolicy > >, AspectKeyPressed< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, SmartWin::MessageMapControl< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, MessageMapPolicy > >, AspectMouseClicks< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, SmartWin::MessageMapControl< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, MessageMapPolicy > >, AspectPainting< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, SmartWin::MessageMapControl< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, MessageMapPolicy > >, AspectRaw< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, SmartWin::MessageMapControl< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, MessageMapPolicy > >, AspectScrollable< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, SmartWin::MessageMapControl< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, MessageMapPolicy > >, AspectSizable< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, SmartWin::MessageMapControl< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, MessageMapPolicy > >, and AspectVisible< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, SmartWin::MessageMapControl< EventHandlerClass, SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >, MessageMapPolicy > >.

List of all members.

Public Types

typedef bool(*) boolFunctionTakingInt (EventHandlerClass *, WidgetType *, int)
 Typedef of a static/global function taking a pointer to the original class, a pointer to the this Widget class and an int returning bool.
typedef bool(*) boolFunctionTakingTstring (EventHandlerClass *, WidgetType *, const SmartUtil::tstring &)
 Typedef of a static/global function taking a pointer to the original class and a pointer to the this Widget class and a const SmartUtil::tstring & returning bool.
typedef bool(*) boolFunctionTakingUnsigned (EventHandlerClass *, WidgetType *, unsigned)
 Typedef of a static/global function taking a pointer to the original class and a pointer to the this Widget class pluss an unsigned int returning void.
typedef bool(*) boolValidationFunc (EventHandlerClass *, WidgetType *, unsigned, unsigned, SmartUtil::tstring &)
 Typedef of a static/global function taking a pointer to the original class, a pointer to the this Widget class, two unsigned int and a SmartUtil::tstring & returning bool.
typedef BrushPtr(*) brushFunctionTakingCanvas (EventHandlerClass *, WidgetType *, Canvas &canvas)
 Typedef of a static/global function taking a pointer to the original class and a pointer to the this Widget class and a Canvas & returning BrushPtr.
typedef HRESULT(*) hresultFunctionTakingLparamWparam (EventHandlerClass *, WidgetType *, LPARAM, WPARAM)
 Typedef of a static/global function taking a pointer to the original class, a pointer to the this Widget, an LPARAM and a WPARAM returning HRESULT.
typedef int(*) intCallbackCompareFunc (EventHandlerClass *, WidgetType *, LPARAM, LPARAM)
 Typedef of a static/global function taking a pointer to the original class, a pointer to the this Widget class and two LPARAM returning int.
typedef bool(EventHandlerClass::*) itsBoolFunctionTakingInt (WidgetType *, int)
 Typedef of a member function to the original class taking pointer to the this Widget and an int returning bool.
typedef bool(EventHandlerClass::*) itsBoolFunctionTakingTstring (WidgetType *, const SmartUtil::tstring &)
 Typedef of a member function to the original class taking pointer to the this Widget and a const SmartUtil::tstring & returning bool.
typedef bool(EventHandlerClass::*) itsBoolFunctionTakingUnsigned (WidgetType *, unsigned)
 Typedef of a member function to the original class taking pointer to the this Widget and unsigned and returning bool.
typedef bool(EventHandlerClass::*) itsBoolValidationFunc (WidgetType *, unsigned, unsigned, SmartUtil::tstring &)
 Typedef of a member function to the original class taking pointer to the this Widget, two unsigned int and SmartUtil::tstring & returning bool.
typedef BrushPtr(EventHandlerClass::*) itsBrushFunctionTakingCanvas (WidgetType *, Canvas &)
 Typedef of a member function to the original class taking pointer to the this Widget and a Canvas & returning BrushPtr.
typedef HRESULT(EventHandlerClass::*) itsHresultFunctionTakingLparamWparam (WidgetType *, LPARAM, WPARAM)
 Typedef of a member function to the original class taking pointer to the this Widget, an LPARAM and a WPARAM returning HRESULT.
typedef int(EventHandlerClass::*) itsIntLparamLparam (WidgetType *, LPARAM, LPARAM)
 Typedef of a member function to the original class taking pointer to the this Widget, two LPARAM returning int.
typedef void(EventHandlerClass::*) itsVoidDrawItemFunction (WidgetType *, const DRAWITEMSTRUCT &)
 Typedef of a member function to the original class taking pointer to the this Widget and a const DRAWITEMSTRUCT & returning void.
typedef void(EventHandlerClass::*) itsVoidFunctionTaking2Bool (WidgetType *, bool, bool)
 Typedef of a member function to the original class taking pointer to the this Widget and two bool returning void.
typedef void(EventHandlerClass::*) itsVoidFunctionTakingBool (WidgetType *, bool)
 Typedef of a member function to the original class taking pointer to the this Widget and a bool returning void.
typedef void(EventHandlerClass::*) itsVoidFunctionTakingCanvas (WidgetType *, Canvas &)
 Typedef of a member function to the original class taking pointer to the this Widget and a Canvas & returning void.
typedef void(EventHandlerClass::*) itsVoidFunctionTakingConstString (WidgetType *, const SmartUtil::tstring &)
 Typedef of a member function to the original class taking pointer to the this Widget and a SmartUtil::tstring & returning void.
typedef void(EventHandlerClass::*) itsVoidFunctionTakingInt (WidgetType *, int)
 Typedef of a member function to the original class taking pointer to the this Widget and an int returning void.
typedef void(EventHandlerClass::*) itsVoidFunctionTakingMouseEventResult (WidgetType *, const MouseEventResult &)
 Typedef of a member function to the original class taking pointer to the this Widget and a const MouseEventResult & returning void.
typedef void(EventHandlerClass::*) itsVoidFunctionTakingPoint (WidgetType *, const Point &)
 Typedef of a member function to the original class taking pointer to the this Widget and const Point & returning void.
typedef void(EventHandlerClass::*) itsVoidFunctionTakingString (WidgetType *, SmartUtil::tstring &)
 Typedef of a member function to the original class taking pointer to the this Widget and a SmartUtil::tstring & returning void.
typedef void(EventHandlerClass::*) itsVoidFunctionTakingSystemTime (WidgetType *, const SYSTEMTIME &)
 Typedef of a member function to the original class taking pointer to the this Widget and a const SYSTEMTIME & returning void.
typedef void(EventHandlerClass::*) itsVoidFunctionTakingUInt (WidgetType *, unsigned)
 Typedef of a member function to the original class taking pointer to the this Widget and an unsigned int returning void.
typedef void(EventHandlerClass::*) itsVoidFunctionTakingVoid (WidgetType *)
 Typedef of a member function to the original class taking pointer to the this Widget returning void.
typedef void(EventHandlerClass::*) itsVoidFunctionTakingWindowSizedEventResult (WidgetType *, const WidgetSizedEventResult &)
 Typedef of a member function to the original class taking pointer to the this Widget and const WidgetSizedEventResult & returning void.
typedef void(EventHandlerClass::*) itsVoidGetIconFunc (WidgetType *, LPARAM, unsigned, int &)
 Typedef of a member function to the original class taking pointer to the this Widget, an unsigned int and an int & returning void.
typedef void(EventHandlerClass::*) itsVoidGetItemFunc (WidgetType *, LPARAM, unsigned, unsigned, SmartUtil::tstring &)
 Typedef of a member function to the original class taking pointer to the this Widget, two unsigned int and SmartUtil::tstring & returning void.
typedef void(EventHandlerClass::*) itsVoidMeasureItemFunction (WidgetType *, MEASUREITEMSTRUCT *)
 Typedef of a member function to the original class taking pointer to the this Widget and a MEASUREITEMSTRUCT * returning void.
typedef void(EventHandlerClass::*) itsVoidUnsignedUnsignedBoolCanvasRectangle (WidgetType *, unsigned, unsigned, bool, Canvas &, const SmartWin::Rectangle &)
 Typedef of a member function to the original class taking pointer to the this Widget, two unsigned int, a Canvas & and a const Rectangle & returning void.
typedef WidgetSlider< EventHandlerClass,
MessageMapPolicy > * 
ObjectType
 Object type.
typedef WidgetSlider< EventHandlerClass,
MessageMapPolicy > 
ThisType
 Class type.
typedef void(*) voidDrawItemFunction (EventHandlerClass *, WidgetType *, const DRAWITEMSTRUCT &)
 Typedef of a static/global function taking a pointer to the original class and a pointer to the this Widget class and a const DRAWITEMSTRUCT & returning void.
typedef void(*) voidFunctionTaking2Bool (EventHandlerClass *, WidgetType *, bool, bool)
 Typedef of a static/global function taking a pointer to the original class, a pointer to the this Widget class and two bool returning void.
typedef void(*) voidFunctionTakingBool (EventHandlerClass *, WidgetType *, bool)
 Typedef of a static/global function taking a pointer to the original class, a pointer to the this Widget class and a bool returning void.
typedef void(*) voidFunctionTakingCanvas (EventHandlerClass *, WidgetType *, Canvas &)
 Typedef of a static/global function taking a pointer to the original class and a pointer to the this Widget class and a Canvas & returning void.
typedef void(*) voidFunctionTakingConstString (EventHandlerClass *, WidgetType *, const SmartUtil::tstring &)
 Typedef of a static/global function taking a pointer to the original class, a pointer to the this Widget class and a SmartUtil::tstring & returning void.
typedef void(*) voidFunctionTakingInt (EventHandlerClass *, WidgetType *, int)
 Typedef of a static/global function taking a pointer to the original class, a pointer to the this Widget class and an int returning void.
typedef void(*) voidFunctionTakingMouseEventResult (EventHandlerClass *, WidgetType *, const MouseEventResult &)
 Typedef of a static/global function taking a pointer to the original class, a pointer to the this Widget class and a const MouseEventResult & returning void.
typedef void(*) voidFunctionTakingPoint (EventHandlerClass *, WidgetType *, const Point &)
 Typedef of a static/global function taking a pointer to the original class, a pointer to the this Widget class and a const Point & returning void.
typedef void(*) voidFunctionTakingString (EventHandlerClass *, WidgetType *, SmartUtil::tstring &)
 Typedef of a static/global function taking a pointer to the original class, a pointer to the this Widget class and a SmartUtil::tstring & returning void.
typedef void(*) voidFunctionTakingSystemTime (EventHandlerClass *, WidgetType *, const SYSTEMTIME &)
 Typedef of a static/global function taking a pointer to the original class, a pointer to the this Widget class and a const SYSTEMTIME & returning void.
typedef void(*) voidFunctionTakingUInt (EventHandlerClass *, WidgetType *, unsigned)
 Typedef of a static/global function taking a pointer to the original class, a pointer to the this Widget class and an unsigned int returning void.
typedef void(*) voidFunctionTakingVoid (EventHandlerClass *, WidgetType *)
 Typedef of a static/global function taking a pointer to the original class and a pointer to the this Widget class returning void.
typedef void(*) voidFunctionTakingWindowSizedEventResult (EventHandlerClass *, WidgetType *, const WidgetSizedEventResult &)
 Typedef of a static/global function taking a pointer to the original class, a pointer to the this Widget class and a const WidgetSizedEventResult & returning void.
typedef void(*) voidGetIconFunc (EventHandlerClass *, WidgetType *, LPARAM, unsigned, int &)
 Typedef of a static/global function taking a pointer to the original class, a pointer to the this Widget class, an LPARAM, an unsigned int and an int & returning void.
typedef void(*) voidGetItemFunc (EventHandlerClass *, WidgetType *, LPARAM, unsigned, unsigned, int &)
 Typedef of a static/global function taking a pointer to the original class, a pointer to the this Widget class, an LPARAM, two unsigned int and a SmartUtil::tstring & returning void.
typedef void(*) voidMeasureItemFunction (EventHandlerClass *, WidgetType *, MEASUREITEMSTRUCT *)
 Typedef of a static/global function taking a pointer to the original class and a pointer to the this Widget class and a MEASUREITEMSTRUCT * returning void.
typedef void(*) voidUnsignedUnsignedBoolCanvasRectangle (EventHandlerClass *, WidgetType *, unsigned, unsigned, bool, Canvas &, const SmartWin::Rectangle &)
 Typedef of a static/global function taking a pointer to the original class, a pointer to the this Widget class, two unsigned int, a bool, a Canvas & and a const Rectangle & returning void.

Public Member Functions

void addRemoveExStyle (DWORD addStyle, bool add)
 Use this function to add or remove windows exStyles.
void addRemoveStyle (DWORD addStyle, bool add)
 Use this function to add or remove windows styles.
void assignBuddy (bool beginning, Widget *buddy)
 Assigns a buddy control.
void bringToBottom ()
 Brings the widget to the bottom.
void bringToFront ()
 Brings the widget to the front.
virtual void create (const Seed &cs=getDefaultSeed())
 Actually creates the Slider Control.
Rectangle getBounds () const
 Returns the position and size of the window.
bool getCapsLockOn ()
 Checks if Caps Lock is on.
Point getClientAreaSize () const
 Returns the size of the client area of the window.
bool getControlPressed ()
 Checks if control is pressed.
Utilities::CriticalSectiongetCriticalSection ()
 Returns a CriticalSection associated with the current Widget object.
HMENU getCtrlId () const
 Returns the control id of the Widget.
bool getEnabled () const
 Retrieves the enabled property of the Widget.
bool getFocus () const
 Retrieves the focus property of the Widget.
int getMaxValue ()
 Retrieves the maximum position of the Slider.
int getMinValue ()
 Retrieves the minimum position of the Slider.
WidgetgetParent () const
 Returns the parent Widget of the Widget.
Point getPosition () const
 Returns the position of the window.
int getPosition ()
 Returns the "value" of the Slider.
bool getShiftPressed ()
 Checks if shift is pressed.
Point getSize () const
 Returns the size of the window.
Point getTextSize (const SmartUtil::tstring &text)
 Fills a Point with the size of text to be drawn in the Widget's font.
bool getVisible () const
 Retrieves the visible property of the Widget.
HWND handle () const
 Returns the HWND to the Widget.
void invalidateWidget ()
 Add this widget to the update area.
void maximize ()
 Maximize your window.
void minimize ()
 Minimize your window.
void onEnabled (typename MessageMapType::itsVoidFunctionTakingBool eventHandler)
 Setting the event handler for the "enabled" event.
void onFocus (typename MessageMapType::itsVoidFunctionTakingVoid eventHandler)
 Sets the event handler for what function to be called when control loses focus.
void onKeyPressed (typename MessageMapType::itsBoolFunctionTakingInt eventHandler)
 Setting the event handler for the "key pressed" event.
void onKillFocus (typename MessageMapType::itsVoidFunctionTakingVoid eventHandler)
 Sets the event handler for what function to be called when control loses focus.
void onLeftMouseDown (typename MessageMapType::itsVoidFunctionTakingMouseEventResult eventHandler)
 Left mouse button pressed event handler setter.
void onLeftMouseUp (typename MessageMapType::itsVoidFunctionTakingMouseEventResult eventHandler)
 Left mouse button pressed and released event handler setter.
void onMiddleMouseDown (typename MessageMapType::voidFunctionTakingMouseEventResult eventHandler)
 Middle mouse button pressed event handler setter.
void onMiddleMouseUp (typename MessageMapType::itsVoidFunctionTakingMouseEventResult eventHandler)
 Middle mouse button pressed and released event handler setter.
void onMouseMove (typename MessageMapType::itsVoidFunctionTakingMouseEventResult eventHandler)
 Mouse moved event handler setter.
void onMoved (typename MessageMapType::itsVoidFunctionTakingPoint eventHandler)
void onPainting (typename MessageMapType::itsVoidFunctionTakingCanvas eventHandler)
 Painting event handler setter.
void onRaw (typename MessageMapType::itsHresultFunctionTakingLparamWparam eventHandler, const Message &msg)
 Setting the member event handler for a "raw" event.
void onRightMouseDown (typename MessageMapType::itsVoidFunctionTakingMouseEventResult eventHandler)
 Right mouse button pressed event handler setter.
void onRightMouseUp (typename MessageMapType::itsVoidFunctionTakingMouseEventResult eventHandler)
 Right mouse button pressed and released event handler setter.
void onScrollHorz (typename MessageMapType::itsVoidFunctionTakingVoid eventHandler)
 Setting the event handler for the "scrolling horizontally" event.
void onScrollVert (typename MessageMapType::itsVoidFunctionTakingVoid eventHandler)
 Setting the event handler for the "scrolling vertically" event.
void onSized (typename MessageMapType::itsVoidFunctionTakingWindowSizedEventResult eventHandler)
void onVisibilityChanged (typename MessageMapType::itsVoidFunctionTakingBool eventHandler)
 Setting the event handler for the "visible" event.
void restore ()
 Restores your window.
virtual LRESULT sendWidgetMessage (HWND hWnd, UINT msg, WPARAM &wPar, LPARAM &lPar)
 Send a message to the Widget.
void setAutoTicks (bool value=true)
 Sets the Auto Ticks property of the control.
void setBorder (bool value=true)
 Set or remove the simple border (solid line).
void setBounds (int x, int y, int width, int height, bool updateWindow=true)
 Sets the new size and position of the window.
void setBounds (const Point &newPos, const Point &newSize, bool updateWindow=true)
 Sets the new size and position of the window.
void setBounds (const Rectangle &rect, bool updateWindow=true)
 Sets the new size and position of the window.
void setEnabled (bool enabled)
 Sets the enabled property of the Widget.
void setFocus ()
 Gives the Widget the keyboard focus.
void setHorizontal (bool value=true)
 Sets the horizontal property of the control.
void setPosition (int newPosition)
 Sets the position of the thumb.
void setPositionPerPlace (SmartWin::Place &bound)
 Given a bounding Place class, place this Widget and adjust to the next position.
void setRaisedBorder (bool value=true)
 Set or remove the raised border (like in buttons).
void setRange (short minimum, short maximum)
 Sets the range of the slider.
void setShowTicks (bool value=true)
 Removes ticks.
void setShowTicksBoth (bool value=true)
 Sets the placement of the ticks to be BOTH (above/bottom or right/left).
void setShowTicksLeft (bool value=true)
 Sets the placement of the ticks.
void setShowTicksTop (bool value=true)
 Sets the placement of the ticks.
void setSizeAsCol (const Rectangle &rect, int rows, int rownum, int border=0, bool updateWindow=true)
 Given a bounding rectangle with rows, put this Widget in the rownum position.
void setSizeAsGridPerPlace (SmartWin::Place &bound, int rows, int cols)
 this Widget in the next cell.
void setSizeAsRow (const Rectangle &rect, int cols, int colnum, int border=0, bool updateWindow=true)
 Given a bounding rectangle with cols, put this Widget in the colnum position.
void setSizePerTextPerPlace (SmartWin::Place &bound, const SmartUtil::tstring &text, int extraX=0, int extraY=0)
 Place after sizing for the Widget's text, and adjust to the next position.
void setSmoothSunkenBorder (bool value=true)
 Set or remove the smooth sunken border (generally used in read only text boxes).
void setSunkenBorder (bool value=true)
 Set or remove the sunken border (like in text box widgets).
void setTickFrequency (unsigned frequency)
 Sets tick frequency.
void setVisible (bool visible)
 Sets the visibility property of the Widget.
virtual void subclass (unsigned id)
 Subclasses the dialog item with the given dialog item id.
void updateWidget ()
 Repaints the whole window.

Static Public Member Functions

static const SeedgetDefaultSeed ()
 Default values for creation.
static Point getDesktopSize ()
 Returns the screen size.
static char virtualKeyToChar (int vkey)
 Get ascii character from a Virtual Key.

Protected Member Functions

void createMessageMap ()
 make the Windows Message Procedure dispatching map right.

Classes

class  Seed
 Seed class. More...


Detailed Description

template<class EventHandlerClass, class MessageMapPolicy>
class SmartWin::WidgetSlider< EventHandlerClass, MessageMapPolicy >

Slider Control class.

You can either inherit from this class or add an instance of this class into your WidgetWindow inherited class.
If you inherit from the class you should explicitly call create e.g. in the CTOR of you class.
If you instantiate it directly (through the class Widget) you should create it by calling WidgetFactory::createxxx where xxx equals the name of the class WITHOUT the Widget part.

slider.PNG
Class for creating a Slider control Widget.
A Slider is a Widget which can be used to give e.g. percentage input. For instance a volume control of a stereo system often has several of these ones, one each for the volume, bass and tone. It contains of a thumbtrack and an axis which you can move the thumbtrack up and down, it is quite similar in functionality to the WidgetSpinner control, but have another visual appearance.


Member Function Documentation

void addRemoveExStyle ( DWORD  addStyle,
bool  add 
) [inherited]

Use this function to add or remove windows exStyles.

The first parameter is the type of style you wish to add/remove.
The second argument is a boolean indicating if you wish to add or remove the style (if true add style, else remove)

void addRemoveStyle ( DWORD  addStyle,
bool  add 
) [inherited]

Use this function to add or remove windows styles.

The first parameter is the type of style you wish to add/remove.
The second argument is a boolean indicating if you wish to add or remove the style (if true add style, else remove)

void assignBuddy ( bool  beginning,
Widget buddy 
)

Assigns a buddy control.

A "buddy control" may be of any type but most often a WidgetTextBox or a WidgetStatic is used.
It is normally used for displaying "maximum" and "minimum" text labels.
The buddy control will be positioned either to the left or right of a vertical Slider or the top or bottom of a horizontal Slider depending on the boolean value of the first argument. If the first argument is true, the buddy control will be placed to the left of a vertical Slider or above a horizontal Slider.
The buddy will be repositioned according to the position of the associated slider, BUT you MUST set the size of it. Don't burn braincells over the position setting. Only the SIZE matters.
A Slider may have TWO buddy controls, one with first argument set to true and one set to false.
If you assign another buddy control with the same first argument, the earlier instance will no longer be a buddy control, but it will still be there, it will not cease to exist or be destroyed. See the WidgetSlider sample application for an example of the buddy control in use.

void bringToBottom (  )  [inherited]

Brings the widget to the bottom.

Makes the widget become the bottom most widget meaning it will be obscured by all other widgets which are contained in the same container widget.
For instance if you have two widgets which partially hides eachother and you call bringToBottom on one of them it will make sure that the widget you call bringToBottom on will be the one which will be invisible and the other one will be all visible by the parts which are obscured by the this widget.

void bringToFront (  )  [inherited]

Brings the widget to the front.

Makes the widget become the front most widget meaning it will not be obscured by other widgets which are contained in the same container widget.
For instance if you have two widgets which partially hides eachother and you call bringToFront on one of them it will make sure that the widget you call bringToFront on will be the one which will be all visible and the other one will be partially hidden by the parts which are obscured by the this widget.

void create ( const Seed cs = getDefaultSeed()  )  [virtual]

Actually creates the Slider Control.

You should call WidgetFactory::createSlider if you instantiate class directly.
Only if you DERIVE from class you should call this function directly.

Rectangle getBounds (  )  const [inherited]

Returns the position and size of the window.

Note that this is in screen coordinates meaning the position returned is relative to the upper left corner of the desktop screen, the function also returns in the size member of the Rectangle the size of the window and not the position of the lower right point. Values includes borders, frames and toolbar etc of the window.

bool getCapsLockOn (  )  [inherited]

Checks if Caps Lock is on.

Use this function if you need to determine if Caps Lock is ON

Point getClientAreaSize (  )  const [inherited]

Returns the size of the client area of the window.

This differs from getSize because it disregards the border and headers, this function only returns the client area of the Widget meaning the area which it is possible to draw on.

bool getControlPressed (  )  [inherited]

Checks if control is pressed.

Use this function if you need to determine if any of the CTRL keys are pressed.

Utilities::CriticalSection & getCriticalSection (  )  [inherited]

Returns a CriticalSection associated with the current Widget object.

If you need serialized thread safe access to the Widget call this function and either stuff the returned object into a Utilities::ThreadLock or call Utilities::CriticalSection::lock (then you manually have to ensure CriticalSection::unlock is called on it)

HMENU getCtrlId (  )  const [inherited]

Returns the control id of the Widget.

This one only makes sense for control items, e.g. WidgetButton, WidgetComboBox etc.
Every control in a Widget has got its own control ID, mark that for a WidgetWindow this will always be ZERO

Point getDesktopSize (  )  [static, inherited]

Returns the screen size.

This is the screen size, and useful for making applications that must adapt to different screen sizes.

bool getEnabled (  )  const [inherited]

Retrieves the enabled property of the Widget.

Use this function to check if the Widget is Enabled or not. If the Widget is enabled this function will return true.

bool getFocus (  )  const [inherited]

Retrieves the focus property of the Widget.

Use this function to check if the Widget has focus or not. If the Widget has focus this function will return true.

int getMaxValue (  ) 

Retrieves the maximum position of the Slider.

The return value from this function is the maximum value of the Slider

int getMinValue (  ) 

Retrieves the minimum position of the Slider.

The return value from this function is the minimum value of the Slider

Widget* getParent (  )  const [inherited]

Returns the parent Widget of the Widget.

Most Widgets have got a parent, this function will retrieve a pointer to the Widgets parent, if the Widget doesn't have a parent it will return a null pointer.

Point getPosition (  )  const [inherited]

Returns the position of the window.

Note that this is in screen coordinates meaning the position returned is relative to the upper left corner of the desktop screen.

Reimplemented in WidgetProgressBar, and WidgetSlider.

int getPosition (  ) 

Returns the "value" of the Slider.

Returns the "value" of the Slider or the position of the thumb. If you for instance have defined the minimum/maximum value to be -10 and 10 and the thumb is in the 3/4 of the max position this function will return 5.

Reimplemented from AspectSizable.

bool getShiftPressed (  )  [inherited]

Checks if shift is pressed.

Use this function if you need to determine if any of the SHIFT keys are pressed.

Point getSize (  )  const [inherited]

Returns the size of the window.

Includes the border, frame and toolbar etc of the window.

Point getTextSize ( const SmartUtil::tstring &  text  )  [inherited]

Fills a Point with the size of text to be drawn in the Widget's font.

getTextSize determines the height and width that text will take.
This is useful if you want to allocate enough space to fit known text.
It accounts for the set font too.

bool getVisible (  )  const [inherited]

Retrieves the visible property of the Widget.

Use this function to check if the Widget is visible or not.
If the Widget is visible this function will return true.

HWND handle (  )  const [inherited]

Returns the HWND to the Widget.

Returns the HWND to the inner window of the Widget.
If you need to do directly manipulation of the window use this function to retrieve the HWND of the Widget.

void invalidateWidget (  )  [inherited]

Add this widget to the update area.

Same as updateWidget except that this does not force an immediate redraw.

void maximize (  )  [inherited]

Maximize your window.

This will make the window fill the whole area that the window has available.
This function cannot be called for any Widget types other than those derived from WidgetWindowBase.

void minimize (  )  [inherited]

Minimize your window.

This will make the window become minimized.
This function cannot be called for any Widget types other than those derived from WidgetWindowBase.

void onMiddleMouseDown ( typename MessageMapType::voidFunctionTakingMouseEventResult  eventHandler  )  [inherited]

Middle mouse button pressed event handler setter.

If supplied, function will be called when user press the Middle Mouse button in the client area of the widget.
The parameter passed is const MouseEventResult & which contains the state of the mouse.

void onRaw ( typename MessageMapType::itsHresultFunctionTakingLparamWparam  eventHandler,
const Message msg 
) [inherited]

Setting the member event handler for a "raw" event.

Sets the event handler for the "raw" event handler. Use this if any of the predefined Event Handlers are not powerful enough or if you can't find the specific Event Handler you need.
Note!
This works in a special way. Unless you add the same Message twice, it will add that Event Handler and not remove the previous one. You can have "multiple" raw Event Handlers as long as the Message is not the same!
Note also!
This is an UNTYPED Event!
If there are other events which will handle the message, USE THOSE instead of this one!!!
This is a "last resort" event type.
Two parameters are passed: LPARAM and WPARAM
Return value is HRESULT which will be passed on to the System

void restore (  )  [inherited]

Restores your window.

This will make the window become restored.
This function cannot be called for any Widget types other than those derived from WidgetWindowBase.

LRESULT sendWidgetMessage ( HWND  hWnd,
UINT  msg,
WPARAM &  wPar,
LPARAM &  lPar 
) [virtual]

Send a message to the Widget.

If you need to be able to send a message to a Widget then use this function as it will unroll into
a SendMessage from the Windows API

Reimplemented from MessageMapControl.

void setAutoTicks ( bool  value = true  ) 

Sets the Auto Ticks property of the control.

Auto ticks means that the control will have a tick note for each increment in its range of values.

void setBounds ( int  x,
int  y,
int  width,
int  height,
bool  updateWindow = true 
) [inherited]

Sets the new size and position of the window.

x is the new horizontal position of your window.
y is the new vertical position of your window.
width is the new width and height is the new height of your window.
Zenith is as in all other bounds function top/left.
A call to this function will (probably) also MOVE your Widget too.

void setBounds ( const Point newPos,
const Point newSize,
bool  updateWindow = true 
) [inherited]

Sets the new size and position of the window.

The input parameter newPos of type Point defines the new position of the window.
The newSize member of type Point is the new size of the window.
A call to this function will (probably) also MOVE your Widget too.

void setBounds ( const Rectangle rect,
bool  updateWindow = true 
) [inherited]

Sets the new size and position of the window.

The input parameter Rectangle defines the new size (and position) of the window.
The pos member of the Rectangle is the position and the size member is the size.
So a call to this function will (probably) also MOVE your Widget too.

void setEnabled ( bool  enabled  )  [inherited]

Sets the enabled property of the Widget.

Changes the enabled property of the Widget. Use this function to change the enabled property of the Widget

void setFocus (  )  [inherited]

Gives the Widget the keyboard focus.

Use this function if you wish to give the Focus to a specific Widget

void setHorizontal ( bool  value = true  ) 

Sets the horizontal property of the control.

If you want the slider to be horizontally aligned (default) then call this function with true, if you call it with false the slider will show up vertically instead.

void setPosition ( int  newPosition  ) 

Sets the position of the thumb.

This is the "value" of the control, pass in the new position/value and the control will set the thumb to that position.

void setPositionPerPlace ( SmartWin::Place bound  )  [inherited]

Given a bounding Place class, place this Widget and adjust to the next position.

This function places the Widget into the bounding rectangle specified by bound.
The size of the Widget is preserved.
The Widgets are sized and placed from left to right until a row is full, and then continues with the next row.
The internal position of bound is updated.

void setRange ( short  minimum,
short  maximum 
)

Sets the range of the slider.

The range is the unique values of the control, use this function to set the range of the control. Maximum values are 65000 and minimum are -65000

void setShowTicks ( bool  value = true  ) 

Removes ticks.

If you call this function with true the ticks will be REMOVED from the control. If you call it with false the ticks will appear again in its former positions

void setShowTicksBoth ( bool  value = true  ) 

Sets the placement of the ticks to be BOTH (above/bottom or right/left).

If you call this function with true it will show ticks on BOTH sides of the control depending on if the slider is aligned horizontally or vertically the ticks will show up either above and below or to the right and the left of the slider.

void setShowTicksLeft ( bool  value = true  ) 

Sets the placement of the ticks.

If true is passed then the ticks of the slider will be displayed to the left of the slider, else ticks will show up to the right. Only call this function if you have called the setHorizontal with false.

void setShowTicksTop ( bool  value = true  ) 

Sets the placement of the ticks.

Sets the placement of the ticks to either top (true) or bottom (false). Only call this function if you have called the setHorizontal with true

void setSizeAsCol ( const Rectangle rect,
int  rows,
int  rownum,
int  border = 0,
bool  updateWindow = true 
) [inherited]

Given a bounding rectangle with rows, put this Widget in the rownum position.

The rect defines a column made up of a number of rows. The rownum specifies a zero based index of the row to place the Widget. [ row0 ]
[ row1 ]
...
[ rownum ]
[ ]

Of course you could just generate a new bounding rectangle, but this is easier.

void setSizeAsGridPerPlace ( SmartWin::Place bound,
int  rows,
int  cols 
) [inherited]

this Widget in the next cell.

Bound determines the bounding rectangle, and borders.
rows and cols determine the size and position of each cell.
The internal position of bound is updated.
The Widgets are sized and placed according to the current cell, from left to right until a row is full, and then continues with the next row.

void setSizeAsRow ( const Rectangle rect,
int  cols,
int  colnum,
int  border = 0,
bool  updateWindow = true 
) [inherited]

Given a bounding rectangle with cols, put this Widget in the colnum position.

The rect defines a row made up of a number of columns. The colnum specifies a zero based index of the column to place the Widget.
[ col0 ] [ col1 ] ... [ colnum ] [ ] [ ]

void setSizePerTextPerPlace ( SmartWin::Place bound,
const SmartUtil::tstring &  text,
int  extraX = 0,
int  extraY = 0 
) [inherited]

Place after sizing for the Widget's text, and adjust to the next position.

This function places the Widget into the bounding rectangle specified by bound.
The idea is that the size of certain Widgets should really be large enough to show their text. Buttons and text areas are examples.
The size of the Widget is calculated from the size of getText().
It is optionally adjusted by the extraX and extraY.
The Widgets are sized and placed from left to right until a row is full, and then continues with the next row.
The internal position of bound is updated.

void setTickFrequency ( unsigned  frequency  ) 

Sets tick frequency.

Sets the frequency of the ticks, e.g. if five is given every fifth value of the slider will have a tick, default value is one.

void setVisible ( bool  visible  )  [inherited]

Sets the visibility property of the Widget.

Changes the visibility property of the Widget.
Use this function to change the visibility property of the Widget

void subclass ( unsigned  id  )  [virtual, inherited]

Subclasses the dialog item with the given dialog item id.

Subclasses a dialog item, the id is the dialog item id from the resource editor.
Should normally not be called directly but rather called from e.g. one of the creational functions found in the WidgetFactory class.

void updateWidget (  )  [inherited]

Repaints the whole window.

Invalidate the window and repaints it.

char virtualKeyToChar ( int  vkey  )  [static, inherited]

Get ascii character from a Virtual Key.

Use this to convert from the input to the response to onKeyPressed to a character.
Virtual Keys do not take into account the shift status of the keyboard, and always report UPPERCASE letters.

Back to SmartWin website
SourceForge.net Logo