All Frameworks Class Hierarchy This Framework Previous Next Indexes
DialogEngine Class CATPanelState
System.IUnknown
|
+---System.IDispatch
|
+---System.CATBaseUnknown
|
+---DialogEngine.CATDialogState
|
+---DialogEngine.CATCustomizableState
|
+---CATPanelState
Usage: you must use this class as is. You should never derive it.
public class CATPanelState
Class representing a state dedicated to manage a dialog box.
Role: A dialog state is linked to agents, conditions and outgoing
transitions which depend on the Ok, Cancel, Apply, Preview, Close and
Help buttons of the dialog.
More precisely, this state has the following outgoing transitions:
- a Cancel transition which fires when the Cancel button is selected
and whose target state is the cancel state.
- an Ok transition which fires when the Ok button is selected
and whose target state is the NULL state.
- an Apply transition which fires when the Apply button is selected
and whose target state is the dialog state itself.
- a Preview transition which fires when the Preview button is selected
and whose target state is the dialog state itself.
- a Close transition which fires when the Close button is selected
and whose target state is the NULL state.
- a Help transition which fires when the Help button is selected
and whose target state is the dialog state itself.
As a command developer, you only need to associate an action to each
transition.
You may also add agents and outgoing transitions to this state and even
add a condition on the state or on the transition if a button selection is
not sufficient to fire a transition.
- See also:
- CATDialogTransition
Constructor and Destructor Index
- o
CATPanelState(CATCommand*,CATString&,CATDlgDialog*)
- Constructs a dialog state.
- o
~CATPanelState()
-
Method Index
- o
GetApplyTransition()
- Returns the transition linked to the Apply button.
- o
GetCancelTransition()
- Returns the transition linked to the Cancel button.
- o
GetCloseTransition()
- Returns the transition linked to the Close button.
- o
GetHelpTransition()
- Returns the transition linked to the Help button.
- o
GetOkTransition()
- Returns the transition linked to the Ok button.
- o
GetPreviewTransition()
- Returns the transition linked to the Preview button.
Constructor and Destructor
o CATPanelState
-
Constructs a dialog state.
- Parameters:
-
- iCmd
- The command to which the state belongs.
Legal values: iCmd must be a
CATStateCommand.
- iId
- The resource identifier used to retrieve the state prompt in the command
message file.
- iDialog
- The dialog linked to the state.
o ~CATPanelState
public virtual ~CATPanelState( | ) |
-
Methods
o GetApplyTransition
-
Returns the transition linked to the Apply button.
- Returns:
- The transition.
Lifecycle rules deviation: This method doesn't AddRef the
returned value.
o GetCancelTransition
-
Returns the transition linked to the Cancel button.
- Returns:
- The transition.
Lifecycle rules deviation: This method doesn't AddRef the
returned value.
o GetCloseTransition
-
Returns the transition linked to the Close button.
- Returns:
- The transition.
Lifecycle rules deviation: This method doesn't AddRef the
returned value.
o GetHelpTransition
-
Returns the transition linked to the Help button.
- Returns:
- The transition.
Lifecycle rules deviation: This method doesn't AddRef the
returned value.
o GetOkTransition
-
Returns the transition linked to the Ok button.
- Returns:
- The transition.
Lifecycle rules deviation: This method doesn't AddRef the
returned value.
o GetPreviewTransition
-
Returns the transition linked to the Preview button.
- Returns:
- The transition.
Lifecycle rules deviation: This method doesn't AddRef the
returned value.
This object is included in the file: CATPanelState.h
If needed, your Imakefile.mk should include the module: CATDialogEngine