PK_SESSION_set_behaviour

PK_ERROR_code_t                     PK_SESSION_set_behaviour
(
--- received arguments ---
PK_SESSION_behaviour_t              behaviour_requested,
                                                   --- requested behaviour
const PK_SESSION_set_behaviour_o_t *options,       --- option structure

--- returned arguments ---
PK_SESSION_behaviour_t *const       behaviour_set, --- newly set behaviour
PK_SESSION_behaviour_t *const       behaviour_previous,
                                                   --- previously set behaviour
PK_behaviour_status_t  *const       status         --- status of the operation
)


This function sets the behaviour of the modeller.


This function enables Parasolid to behave differently from the default
behaviour of the current session. This behaviour continues until the next time
this function is called, or the end of the session (if earlier). It allows
applications to reproduce older inferior behaviour to ensure consistent update
of legacy parts.

The requested behaviour is passed in as the value of 'behaviour_requested'.

The value that has actually been set is returned as 'behaviour_set'.

The value that was previously set is returned as 'behaviour_previous'.

The 'behaviour_value' field of 'behaviour_requested' should either be set to
the specific behaviour requested (if the 'behaviour_type' field is
PK_SESSION_behave_as_value_c) or it should be set to zero.

The 'behaviour_previous' and 'behaviour_set' return values are the values that
are returned from a call to PK_SESSION_ask_behaviour immediately before or
after the call to PK_SESSION_set_behaviour, respectively.

If a specific behaviour is requested but it is not known to this Parasolid
build then the closest match before the requested value is returned in the
'behaviour_value' field of 'behaviour_set'. If this condition occurs then
the returned 'status' value will be PK_behaviour_status_unknown_c.

See also here for more information.