All Frameworks  Class Hierarchy  This Framework  Previous  Next  Indexes

KnowledgeInterfaces Interface CATIParmManipulator

System.IUnknown
  |
  +---System.IDispatch
    |
    +---System.CATBaseUnknown
      |
      +---CATIParmManipulator
 

Usage: an implementation of this interface is supplied and you must use it as is. You should not reimplement it.


interface CATIParmManipulator

Interface dedicated to parameters manipulator management.
Role: A manipulator is an object to be associated to one or several parameters. with CATICkeParm::Setmanipulator (m) method

It gathers informations about how the literal can be modified - range (min,max) And it collects informations accessible in literals Spinner editors - step - old steps - old values Double used in this interface are in Model unit if any (millimeter and degree)

See also:
CATICkeParm


Method Index


o AccurateRange(double&,int&,double&,int&)
Gets range values (min and max).
o GetEnumerateValues(void*)
Get the list of enumerate values.
o GetParameter(CATBaseUnknown_var&)
Retrieves the parameter manipulated by the manipulator.
o HasMultipleValues()
Indicates if the parameter is multiple valuated.
o NbSteps()
Returns the number of steps remembered by the system.
o NbValues()
Returns the number of old values to remember by the system.
o SetAccurateRange(double,int,double,int)
Sets range values (min and max).
o SetEnumerateValues(void*)
Initialization of the list of enumerate values.
o SetNbSteps(int)
Sets the number of steps remembered by the system (contextual menu).
o SetNbValues(int)
Sets the number of old values to remember by the system (contextual menu).
o SetStep(double)
Adds a step to the steps remembered.
o SetValue(double)
Adds a value to the old values remembered.
o Step()
Returns the last step used.
o Steps()
Returns the list of last steps used.
o SuppressEnumerateValues()
Destroys the list of enumerate values on the parameter.
o TestValue(double,CATICkeMagnitude_var&)
Tests if a given value is authorized considering bounds, authorized values, etc.
o Values()
Returns the ist of last old values.

Enumerated Type Index


o TestRC

Methods


o AccurateRange
public virtual void AccurateRange(double& oRmin,
int& oBmin,
double& oRmax,
int& oBmax) const =0
Gets range values (min and max).
Parameters:
oRmin
minimum value in model unit
oBmin
0 if no minimum defined, 1 if defined and can be reached, 2 if defined and can not be reached, 3 if defined, can be reached and is not modifiable by the final user, 4 if defined, can not be reached and is not modifiable by the final user
oRmax
maximum value in model unit
oBmax
0 if no maximum defined, 1 if defined and can be reached, 2 if defined and can not be reached, 3 if defined, can be reached and is not modifiable by the final user, 4 if defined, can not be reached and is not modifiable by the final user
o GetEnumerateValues
public virtual void GetEnumerateValues(void* iList) = 0
Get the list of enumerate values. (last entered element is at the end of the list) For string parameters, iList is a pointer to a CATListOfCATUnicodeString provided as input of the method. The list if filled by the method
For other parameters, iList is a pointer to a CATListOfDouble provided as input of the method.The list if filled by the method
Returns:
ioList list of available values (not to be deallocated)
o GetParameter
public virtual HRESULT GetParameter(CATBaseUnknown_var& oParameter) = 0
Retrieves the parameter manipulated by the manipulator.
Parameters:
oParameter
: the parameter manipulated
Returns:
S_OK
if a parameter has been found
E_FAIL
if no parameter has been found
o HasMultipleValues
public virtual int HasMultipleValues()= 0
Indicates if the parameter is multiple valuated.
Returns:
0 if one value, 1 if list of values
o NbSteps
public virtual int NbSteps()const = 0
Returns the number of steps remembered by the system.
o NbValues
public virtual int NbValues()const = 0
Returns the number of old values to remember by the system.
o SetAccurateRange
public virtual void SetAccurateRange( const double iRmin,
const int iBmin,
const double iRmax,
const int iBmax) =0
Sets range values (min and max).
Parameters:
iRrmin
minimum value in model unit
iBmin
0 if no minimum defined, 1 if defined and can be reached, 2 if defined and can not be reached, 3 if defined, can be reached and is not modifiable by the final user, 4 if defined, can not be reached and is not modifiable by the final user
iRmax
maximum value in model unit
iBmax
0 if no maximum defined, 1 if defined and can be reached, 2 if defined and can not be reached, 3 if defined, can be reached and is not modifiable by the final user, 4 if defined, can not be reached and is not modifiable by the final user
o SetEnumerateValues
public virtual void SetEnumerateValues(void* iList) = 0
Initialization of the list of enumerate values. (last entered element is at the end of the list) For string parameters, iList is a pointer to a CATListOfCATUnicodeString provided as input of the method.
For other parameters, iList is a pointer to a CATListOfDouble provided as input of the method.
Parameters:
iList
list of available values
o SetNbSteps
public virtual void SetNbSteps( const int iNb) = 0
Sets the number of steps remembered by the system (contextual menu).
Parameters:
iNb
number of steps to remember
o SetNbValues
public virtual void SetNbValues( const int iNb) = 0
Sets the number of old values to remember by the system (contextual menu).
Parameters:
iNb
number of old values to remember
o SetStep
public virtual void SetStep( const double iValue) = 0
Adds a step to the steps remembered. become last step).
Parameters:
iValue
step added in model unit
o SetValue
public virtual void SetValue( const double iValue) = 0
Adds a value to the old values remembered. (become last value)
Parameters:
iValue
value added in model unit
o Step
public virtual double Step()const = 0
Returns the last step used.
Returns:
last step in model unit
o Steps
public virtual const CATListOfDouble * Steps()const = 0
Returns the list of last steps used.
Returns:
list of last steps used in model unit (not to be deallocated)
o SuppressEnumerateValues
public virtual void SuppressEnumerateValues()= 0
Destroys the list of enumerate values on the parameter.
o TestValue
public virtual CATIParmManipulator::TestRC TestValue( const double iValue,
const CATICkeMagnitude_var& iMag= NULL_var) const = 0
Tests if a given value is authorized considering bounds, authorized values, etc...
Parameters:
iValue
value to be tested
iMag
magnitude
Returns:
indicates if value is authorized
o Values
public virtual const CATListOfDouble * Values()const = 0
Returns the ist of last old values. (last entered element is at the end of the list)
Returns:
list of last values used in model unit (not to be deallocated)

Enumerated Types


o TestRC
enum TestRC {
  Ok,
  MinReached,
  MaxReached,
  NotInEnum,
  NotAuthorized
}

This object is included in the file: CATIParmManipulator.h
If needed, your Imakefile.mk should include the module: KnowledgeItf

Copyright © 2003, Dassault Systèmes. All rights reserved.