WidgetFactory Class Template Reference

Factory class for creating Widgets from a derived custom class. More...

Inherits WidgetFactoryPlatformImplementation< ContainerWidgetType, EventHandlerClass, MessageMapPolicy, CurrentPlatform >.

Inherited by InDialog.

List of all members.

Public Types
typedef WidgetButton< EventHandlerClass, MessageMapPolicy >	WidgetButton
	Button class type.
typedef WidgetButton::ObjectType	WidgetButtonPtr
	Button object type.
typedef WidgetCheckBox< EventHandlerClass, MessageMapPolicy >	WidgetCheckBox
	CheckBox class type.
typedef WidgetCheckBox::ObjectType	WidgetCheckBoxPtr
	CheckBox object type.
typedef SmartWin::WidgetFactory< SmartWin::WidgetChildWindow, EventHandlerClass, MessageMapPolicyNormalWidget >	WidgetChildWindow
	WidgetChildWindow class type.
typedef SmartWin::WidgetFactory< SmartWin::WidgetChildWindow, EventHandlerClass, MessageMapPolicyNormalWidget > *	WidgetChildWindowPtr
	WidgetChildWindow object type.
typedef WidgetChooseColor< SmartWin::Widget >	WidgetChooseColor
	WidgetChooseColor class and object type.
typedef WidgetChooseFolder< SmartWin::Widget >	WidgetChooseFolder
	WidgetChooseFolder class type.
typedef WidgetComboBox< EventHandlerClass, MessageMapPolicy >	WidgetComboBox
	ComboBox class type.
typedef WidgetComboBox::ObjectType	WidgetComboBoxPtr
	ComboBox object type.
typedef WidgetDataGrid< EventHandlerClass, MessageMapPolicy >	WidgetDataGrid
	DataGrid class type.
typedef WidgetDataGrid::ObjectType	WidgetDataGridPtr
	DataGrid object type.
typedef WidgetDateTimePicker< EventHandlerClass, MessageMapPolicy >	WidgetDateTimePicker
	DateTimePicker class type.
typedef WidgetDateTimePicker::ObjectType	WidgetDateTimePickerPtr
	DateTimePicker object type.
typedef WidgetGroupBox< EventHandlerClass, MessageMapPolicy >	WidgetGroupBox
	GroupBox class type.
typedef WidgetGroupBox::ObjectType	WidgetGroupBoxPtr
	GroupBox object type.
typedef WidgetLoadFile< SmartWin::Widget >	WidgetLoadFile
	LoadFileDialog class type.
typedef WidgetMDIParent< EventHandlerClass, MessageMapPolicy >	WidgetMDIParent
	MDIWindow class type.
typedef WidgetMDIParent::ObjectType	WidgetMDIParentPtr
	MDIWindow object type.
typedef WidgetMenu< EventHandlerClass, MessageMapPolicy >	WidgetMenu
	Menu class type.
typedef WidgetMenu::ObjectType	WidgetMenuPtr
	Menu object type.
typedef WidgetMessageBox< SmartWin::Widget >	WidgetMessageBox
	MessageBox class and object type.
typedef WidgetProgressBar< EventHandlerClass, MessageMapPolicy >	WidgetProgressBar
	ProgressBar class type.
typedef WidgetProgressBar::ObjectType	WidgetProgressBarPtr
	ProgressBar object type.
typedef WidgetRadioButton< EventHandlerClass, MessageMapPolicy >	WidgetRadioButton
	RadioButton class type.
typedef WidgetRadioButton::ObjectType	WidgetRadioButtonPtr
	RadioButton object type.
typedef WidgetSaveFile< SmartWin::Widget >	WidgetSaveFile
	SaveFileDialog class and object type.
typedef WidgetSlider< EventHandlerClass, MessageMapPolicy >	WidgetSlider
	Slider class type.
typedef WidgetSlider::ObjectType	WidgetSliderPtr
	Slider object type.
typedef WidgetSpinner< EventHandlerClass, MessageMapPolicy >	WidgetSpinner
	Spinner class type.
typedef WidgetSpinner::ObjectType	WidgetSpinnerPtr
	Spinner object type.
typedef WidgetStatic< EventHandlerClass, MessageMapPolicy >	WidgetStatic
	Static class type.
typedef WidgetStatic::ObjectType	WidgetStaticPtr
	Static object type.
typedef WidgetStatusBar< EventHandlerClass, MessageMapPolicy >	WidgetStatusBar
	StatusBar class type.
typedef WidgetStatusBar::ObjectType	WidgetStatusBarPtr
	StatusBar object type.
typedef SmartWin::WidgetStatusBar< EventHandlerClass, MessageMapPolicy, Section< EventHandlerClass, MessageMapPolicy > >	WidgetStatusBarSections
	StatusBarSections class type.
typedef WidgetStatusBarSections::ObjectType	WidgetStatusBarSectionsPtr
	StatusBarSections object type.
typedef WidgetTabSheet< EventHandlerClass, MessageMapPolicy >	WidgetTabSheet
	TabSheet class type.
typedef WidgetTabSheet::ObjectType	WidgetTabSheetPtr
	TabSheet object type.
typedef WidgetTextBox< EventHandlerClass, MessageMapPolicy >	WidgetTextBox
	TextBox class type.
typedef WidgetTextBox::ObjectType	WidgetTextBoxPtr
	TextBox object type.
typedef WidgetTreeView< EventHandlerClass, MessageMapPolicy >	WidgetTreeView
	TreeView class type.
typedef WidgetTreeView::ObjectType	WidgetTreeViewPtr
	TreeView object type.
typedef SmartWin::WidgetFactory< SmartWin::WidgetWindow, EventHandlerClass, MessageMapPolicyNormalWidget >	WidgetWindow
	WidgetWindow class type.
typedef SmartWin::WidgetFactory< SmartWin::WidgetWindow, EventHandlerClass, MessageMapPolicyNormalWidget > *	WidgetWindowPtr
	WidgetWindow object type.
Public Member Functions
WidgetButtonPtr	createButton (const typename WidgetButton::Seed &cs=WidgetButton::getDefaultSeed())
	Creates a Button Control and returns a pointer to it.
WidgetCheckBoxPtr	createCheckBox (const typename WidgetCheckBox::Seed &cs=WidgetCheckBox::getDefaultSeed())
	Creates a Check Box and returns a pointer to it.
WidgetChooseColor	createChooseColor ()
	Creates a WidgetChooseColor and returns it.
WidgetChooseFolder	createChooseFolder ()
	Creates a ChooseFolderDialog and returns a pointer to it.
WidgetComboBoxPtr	createComboBox (const typename WidgetComboBox::Seed &cs=WidgetComboBox::getDefaultSeed())
	Creates a Comb Box and returns a pointer to it.
WidgetDataGridPtr	createDataGrid (const typename WidgetDataGrid::Seed &cs=WidgetDataGrid::getDefaultSeed())
	Creates a List View and returns a pointer to it.
WidgetDateTimePickerPtr	createDateTimePicker (const typename WidgetDateTimePicker::Seed &cs=WidgetDateTimePicker::getDefaultSeed())
	Creates a DateTime Picker Control and returns a pointer to it.
WidgetGroupBoxPtr	createGroupBox (const typename WidgetGroupBox::Seed &cs=WidgetGroupBox::getDefaultSeed())
	Creates a Group Box Control and returns a pointer to it.
WidgetLoadFile	createLoadFile ()
	Creates a LoadFileDialog and returns a pointer to it.
WidgetMDIParentPtr	createMDIParent (const typename WidgetMDIParent::Seed &cs=WidgetMDIParent::getDefaultSeed())
	Creates a Button Control and returns a pointer to it.
WidgetMenuPtr	createMenu ()
	Creates a Menu and returns a pointer to it.
WidgetMessageBox	createMessageBox ()
	Creates a Message Box and returns a pointer to it.
WidgetProgressBarPtr	createProgressBar (const typename WidgetProgressBar::Seed &cs=WidgetProgressBar::getDefaultSeed())
	Creates a Progress Bar Control and returns a pointer to it.
WidgetRadioButtonPtr	createRadioButton (WidgetGroupBoxPtr parent, const typename WidgetRadioButton::Seed &cs=WidgetRadioButton::getDefaultSeed())
	Creates a Radio Button Control and returns a pointer to it.
WidgetSaveFile	createSaveFile ()
	Creates a SaveFileDialog and returns a pointer to it.
WidgetSliderPtr	createSlider (const typename WidgetSlider::Seed &cs=WidgetSlider::getDefaultSeed())
	Creates a Slider Control and returns a pointer to it.
WidgetSpinnerPtr	createSpinner (const typename WidgetSpinner::Seed &cs=WidgetSpinner::getDefaultSeed())
	Creates a Spinner Control and returns a pointer to it.
WidgetStaticPtr	createStatic (const typename WidgetStatic::Seed &cs=WidgetStatic::getDefaultSeed())
	Creates a Static Control and returns a pointer to it.
WidgetStatusBarPtr	createStatusBar (const typename WidgetStatusBar::Seed &cs=WidgetStatusBar::getDefaultSeed())
	Creates a Status Bar and returns a pointer to it.
WidgetStatusBarSectionsPtr	createStatusBarSections (const typename WidgetStatusBarSections::Seed &cs=WidgetStatusBarSections::getDefaultSeed())
	Creates a Status Bar and returns a pointer to it.
WidgetTabSheetPtr	createTabSheet (const typename WidgetTabSheet::Seed &cs=WidgetTabSheet::getDefaultSeed())
	Creates a Button Control and returns a pointer to it.
WidgetTextBoxPtr	createTextBox (const typename WidgetTextBox::Seed &cs=WidgetTextBox::getDefaultSeed())
	Creates a Edit Control and returns a pointer to it.
WidgetTreeViewPtr	createTreeView (const typename WidgetTreeView::Seed &cs=WidgetTreeView::getDefaultSeed())
	Creates a Tree View and returns a pointer to it.
WidgetChildWindowPtr	createWidgetChildWindow (const typename WidgetChildWindow::Seed &cs=WidgetChildWindow::getDefaultSeed())
	Creates a child window and returns a pointer to it.
WidgetButtonPtr	subclassButton (unsigned id)
	Subclasses a Button Control from the given resource id.
WidgetCheckBoxPtr	subclassCheckBox (unsigned id)
	Subclasses a Check Box from the given resource id.
WidgetComboBoxPtr	subclassComboBox (unsigned id)
	Subclasses a ComboBox Control from the given resource id.
WidgetDateTimePickerPtr	subclassDateTimePicker (unsigned id)
	Suvclasses a DateTime Picker Control and returns a pointer to it.
WidgetGroupBoxPtr	subclassGroupBox (unsigned id)
	Subclasses a Group Box Control and returns a pointer to it.
WidgetDataGridPtr	subclassList (unsigned id)
	Subclasses a Check Box from the given resource id.
WidgetRadioButtonPtr	subclassRadioButton (unsigned id)
	Subclasses a Radio Button Control and returns a pointer to it.
WidgetSliderPtr	subclassSlider (unsigned id)
	Subclasses a Slider Control from the given resource id.
WidgetSpinnerPtr	subclassSpinner (unsigned id)
	Subclasses a Spinner Control from the given resource id.
WidgetStaticPtr	subclassStatic (unsigned id)
	Subclasses a Static Control from the given resource id.
WidgetTextBoxPtr	subclassTextBox (unsigned id)
	Subclasses a Text Box Control from the given resource id.
WidgetTreeViewPtr	subclassTreeView (unsigned id)
	Subclasses a Tree View Control from the given resource id.
	WidgetFactory ()
	Default Constructor creating a factory Widget.

---

Detailed Description

template<template< class, class > class ContainerWidgetType, class EventHandlerClass, class MessageMapPolicy = MessageMapPolicyNormalWidget>
class SmartWin::WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >

Factory class for creating Widgets from a derived custom class.

This is the class you would normally derive from in your own application.
< p >Derive directly from WidgetFactory and then supply WidgetWindow as the first template parameter. The second parameter would then be YOUR CLASS ( this is needed for the SmartWin type system to function ) Example : < b >class MyMainWindow : public SmartWin::WidgetFactory< SmartWin::WidgetWindow, MyMainWindow > { ... };< /b > The third template argument is for declaring what type of Widget you're declaring, for a "normal Widget" this defaults to MessageMapPolicyNormalWidget, if this is a Widget constructed from a dialog resource, you must state so by adding SmartWin::MessageMapPolicyDialogWidget and if it is a MDI Child you must add SmartWin::MessageMapPolicyMDIChildWidget as the third argument Then when you need e.g. a WidgetButton you would create that button by calling createWidgetButton. Class contains type defs for your convenience for all Widget types that exists in the SmartWin library.< /p > Note!
It is CRUCIAL that you DON'T explicitly delete any of the objects returned from any of these functions.
SmartWin will itself keep a track of which objects are alive and which it should delete
this is with purpose to make the library easier to use and more transparent for C#, Java and newbie developers.
Some functions returns stack objects, e.g. createMenu which returns a boost::shared_ptr and createMessageBox which returns a stack object, these also should just get to "live their own life" and should not be tampered with in any "memory ways".

---

Constructor & Destructor Documentation

WidgetFactory

(

)

Default Constructor creating a factory Widget.

Default Constructor creating a factory Widget without a parent, if you need to explicitly state a parent like for instance you often would want in a WidgetChildWindow you should use the one taking a Widget * instead

---

Member Function Documentation

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetButtonPtr createButton

(

const typename WidgetButton::Seed &

cs = WidgetButton::getDefaultSeed()

)

Creates a Button Control and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetCheckBoxPtr createCheckBox

(

const typename WidgetCheckBox::Seed &

cs = WidgetCheckBox::getDefaultSeed()

)

Creates a Check Box and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetChooseColor createChooseColor

(

)

Creates a WidgetChooseColor and returns it.

Usable to let user choose font from the system installed fonts.

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetChooseFolder createChooseFolder

(

)

Creates a ChooseFolderDialog and returns a pointer to it.

Use this one to construct a ( stack object ) to show a Choose folder Dialog

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetComboBoxPtr createComboBox

(

const typename WidgetComboBox::Seed &

cs = WidgetComboBox::getDefaultSeed()

)

Creates a Comb Box and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetDataGridPtr createDataGrid

(

const typename WidgetDataGrid::Seed &

cs = WidgetDataGrid::getDefaultSeed()

)

Creates a List View and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetDateTimePickerPtr createDateTimePicker

(

const typename WidgetDateTimePicker::Seed &

cs = WidgetDateTimePicker::getDefaultSeed()

)

Creates a DateTime Picker Control and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetGroupBoxPtr createGroupBox

(

const typename WidgetGroupBox::Seed &

cs = WidgetGroupBox::getDefaultSeed()

)

Creates a Group Box Control and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetLoadFile createLoadFile

(

)

Creates a LoadFileDialog and returns a pointer to it.

Use this one to construct a ( stack object ) to show a Load File Dialog

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetMDIParentPtr createMDIParent

(

const typename WidgetMDIParent::Seed &

cs = WidgetMDIParent::getDefaultSeed()

)

Creates a Button Control and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetMenuPtr createMenu

(

)

Creates a Menu and returns a pointer to it.

The returned object is of type boost::shared_ptr< WidgetMenu >, but you should use the typedef WidgetMenuPtr and not < br > the shared_ptr itself since this may change in future releases.

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetMessageBox createMessageBox

(

)

Creates a Message Box and returns a pointer to it.

Use this one to construct a ( stack object ) to show a message box

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetProgressBarPtr createProgressBar

(

const typename WidgetProgressBar::Seed &

cs = WidgetProgressBar::getDefaultSeed()

)

Creates a Progress Bar Control and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetRadioButtonPtr createRadioButton	(	WidgetGroupBoxPtr	parent,
		const typename WidgetRadioButton::Seed &	cs = WidgetRadioButton::getDefaultSeed()
	)

Creates a Radio Button Control and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetSaveFile createSaveFile

(

)

Creates a SaveFileDialog and returns a pointer to it.

Use this one to construct a ( stack object ) to show a Save File Dialog

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetSliderPtr createSlider

(

const typename WidgetSlider::Seed &

cs = WidgetSlider::getDefaultSeed()

)

Creates a Slider Control and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetSpinnerPtr createSpinner

(

const typename WidgetSpinner::Seed &

cs = WidgetSpinner::getDefaultSeed()

)

Creates a Spinner Control and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetStaticPtr createStatic

(

const typename WidgetStatic::Seed &

cs = WidgetStatic::getDefaultSeed()

)

Creates a Static Control and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetStatusBarPtr createStatusBar

(

const typename WidgetStatusBar::Seed &

cs = WidgetStatusBar::getDefaultSeed()

)

Creates a Status Bar and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetStatusBarSectionsPtr createStatusBarSections

(

const typename WidgetStatusBarSections::Seed &

cs = WidgetStatusBarSections::getDefaultSeed()

)

Creates a Status Bar and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetTabSheetPtr createTabSheet

(

const typename WidgetTabSheet::Seed &

cs = WidgetTabSheet::getDefaultSeed()

)

Creates a Button Control and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetTextBoxPtr createTextBox

(

const typename WidgetTextBox::Seed &

cs = WidgetTextBox::getDefaultSeed()

)

Creates a Edit Control and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetTreeViewPtr createTreeView

(

const typename WidgetTreeView::Seed &

cs = WidgetTreeView::getDefaultSeed()

)

Creates a Tree View and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetChildWindowPtr createWidgetChildWindow

(

const typename WidgetChildWindow::Seed &

cs = WidgetChildWindow::getDefaultSeed()

)

Creates a child window and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetDateTimePickerPtr subclassDateTimePicker

(

unsigned

id

)

Suvclasses a DateTime Picker Control and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetGroupBoxPtr subclassGroupBox

(

unsigned

id

)

Subclasses a Group Box Control and returns a pointer to it.

DON'T delete the returned pointer!!!

WidgetFactory< ContainerWidgetType, EventHandlerClass, MessageMapPolicy >::WidgetRadioButtonPtr subclassRadioButton

(

unsigned

id

)

Subclasses a Radio Button Control and returns a pointer to it.

DON'T delete the returned pointer!!!

Back to SmartWin website