BscDlgDialogController Class Reference

Inheritance diagram for BscDlgDialogController:

Public Member Functions
	BscDlgDialogController (IPMUnknown *boss)
virtual void	InitializeDialogFields (IActiveContext *dlgContext)
virtual WidgetID	ValidateDialogFields (IActiveContext *myContext)
virtual void	ApplyDialogFields (IActiveContext *myContext, const WidgetID &widgetId)
Public Member Functions inherited from CDialogController
	CDialogController (IPMUnknown *boss)
virtual void	UserCancelled ()
virtual void	ClosingDialog (IActiveContext *lastChanceToUseMyContext)
virtual bool16	HasBeenInitialized () const
virtual void	SetInitialized (bool16 initialized)
virtual void	SetOwner (IControlView *ownerPanel)
virtual IControlView *	GetOwner () const
virtual void	GetName (PMString &name)
virtual void	SetTextControlData (const WidgetID &widgetId, const PMString &text, const IPanelControlData *panel=nil, bool16 invalidate=kTrue, bool16 notifyOfChange=kTrue)
virtual PMString	GetTextControlData (const WidgetID &widgetId, const IPanelControlData *panel=nil) const
virtual void	SetTextValue (const WidgetID &widgetId, const PMReal &value, const IPanelControlData *panel=nil, bool16 invalidate=kTrue, bool16 notifyOfChange=kTrue)
virtual PMReal	GetTextValue (const WidgetID &widgetId, const IPanelControlData *panel=nil, bool16 *outParsingError=nil, bool16 *outIsBlank=nil) const
virtual void	SetTextValueControlState (const WidgetID &widgetId, ITextValue::TextControlState controlState, const IPanelControlData *panel=nil, bool16 invalidate=kTrue, bool16 notifyOfChange=kTrue)
virtual ITextValue::TextControlState	GetTextValueControlState (const WidgetID &widgetId, const IPanelControlData *panel=nil) const
virtual void	SetBooleanControlData (const WidgetID &widgetId, bool16 isChecked, const IPanelControlData *panel=nil, bool16 invalidate=kTrue, bool16 notifyOfChange=kTrue)
virtual bool16	GetBooleanControlData (const WidgetID &widgetId, const IPanelControlData *panel=nil) const
virtual void	SetTriStateControlData (const WidgetID &widgetId, bool16 isSelected, const IPanelControlData *panel=nil, bool16 invalidate=kTrue, bool16 notifyOfChange=kTrue)
virtual void	SetTriStateControlData (const WidgetID &widgetId, ITriStateControlData::TriState triState, const IPanelControlData *panel=nil, bool16 invalidate=kTrue, bool16 notifyOfChange=kTrue)
virtual ITriStateControlData::TriState	GetTriStateControlData (const WidgetID &widgetId, const IPanelControlData *panel=nil) const
virtual WidgetID	GetSelectedClusterWidget (WidgetID cluster, const IPanelControlData *panel=nil)
virtual void	SetSelectedClusterWidget (WidgetID clusterId, WidgetID widgetToSelect, const IPanelControlData *panel=nil, bool16 invalidate=kTrue, bool16 notifyOfChange=kTrue)
virtual IStringListControlData *	QueryListControlDataInterface (const WidgetID &widgetId, const IPanelControlData *panel=nil) const
virtual IPanelControlData *	QueryIfNilElseAddRef (const IPanelControlData *panel) const
virtual void	SelectDialogWidget (const WidgetID &widgetId)
virtual bool16	GetPreviewModeOn ()
virtual void	SetPreviewModeOn (bool16 bOn)
virtual IActiveContext *	QueryDialogContext ()
Public Member Functions inherited from CPMUnknown< IDialogController >
IPMUnknown *	QueryInterface (PMIID interfaceID) const
void	AddRef () const
void	Release () const
void	PreDirty (ImplementationID prop=kInvalidImpl, bool16 allowModification=kTrue)
void	PreDirtyNoMessage (ImplementationID prop=kInvalidImpl, bool16 allowModification=kTrue)
	CPMUnknown (const CPMUnknown &)=delete
CPMUnknown &	operator= (const CPMUnknown &)=delete
Dialog protocol
Dialog query methods
Owner query methods
Previewable dialog methods
Dialog helper methods

Additional Inherited Members
Public Types inherited from IDialogController
enum	{ kDefaultIID = IID_IDIALOGCONTROLLER }
Protected Member Functions inherited from CDialogController
virtual void	ResetDialogFields (IActiveContext *myContext)
Protected Attributes inherited from CPMUnknown< IDialogController >
HelperInterface	fHelperInterface

Detailed Description

Implements IDialogController based on the partial implementation CDialogController; its methods allow for the initialization, validation, and application of dialog widget values.

The methods take an additional parameter for 3.0, of type IActiveContext. See the design document for an explanation of the rationale for this new parameter and the renaming of the methods that CDialogController supports.

Constructor & Destructor Documentation

BscDlgDialogController::BscDlgDialogController ( IPMUnknown *  boss )

inline

Constructor.

Parameters

boss	interface ptr from boss object on which this interface is aggregated.

Member Function Documentation

void BscDlgDialogController::ApplyDialogFields ( IActiveContext *  myContext, const WidgetID &  widgetId  )

virtual

Retrieve the values from the widgets and act on them.

Parameters

myContext
widgetId	identifies the widget on which to act.

Reimplemented from CDialogController.

Binds the C implementation class onto its ImplementationID making the C code callable by the application *void BscDlgDialogController::InitializeDialogFields ( IActiveContext *  dlgContext )

virtual

Initializes each widget in the dialog with its default value. Called when the dialog is opened.

Parameters

dlgContext

Reimplemented from CDialogController.

WidgetID BscDlgDialogController::ValidateDialogFields ( IActiveContext *  myContext )

virtual

Validate the values in the widgets. By default, the widget with ID kOKButtonWidgetID causes this method to be called. When all widgets are valid, ApplyFields will be called.

Parameters

myContext

Returns

kDefaultWidgetId if all widget values are valid, WidgetID of the widget to select otherwise.

Reimplemented from CDialogController.