RpObjectOnDereference Method (Int32, MvValue, MvValue, Int32, Boolean)

public virtual bool OnDereference(
	int attrId,
	MvValue[] argv,
	MvValue[] ackArgv,
	int index,
	bool force
)

Public Overridable Function OnDereference ( 
	attrId As Integer,
	argv As MvValue(),
	ackArgv As MvValue(),
	index As Integer,
	force As Boolean
) As Boolean

public:
virtual bool OnDereference(
	int attrId, 
	array<MvValue^>^ argv, 
	array<MvValue^>^ ackArgv, 
	int index, 
	bool force
)

Parameters

attrId

Type: SystemInt32
: The attribute identifier, which must be a hyper-reference.

argv

Type: RW.Server.ComponentMvValue
: An array of values, which will be passed to the constructor of IlsMvView or of a derived class so as to initialize the view parameter values. (See the IlsMvView constructor.)

ackArgv

Type: RW.Server.ComponentMvValue
: An array of MvValue objects : it will be given to the ackOpenView method as parameter. It can be equal to null.

index

Type: SystemInt32
: The index in the ackparams array that will contain the status of the opening view encapsulated in an MvValue whose type is Character.

force

Type: SystemBoolean
: Only considered if the same view has already been opened by the component. If true, a new view is opened, otherwise Representation.setSelection is called on the representation associated with the existing view.

Return Value

This function is identical to OnDereference(Int32, MvValue, Boolean) except that Rogue Wave Server executes a call to the representation object function AckOpenView(MvValue) during the acknowledgement or the rollback of the transaction that includes the call to OpenView(String, MvValue, MvValue, Int32, Boolean).

In case of success, the event CreateRepresentation is also triggered by Rogue Wave Server, just after it has been created. This event contains the same argument values than AckOpenView(MvValue).

But while AckOpenView(MvValue) is called on the represention object during the acknowledgement/rollback of the transaction, CreateRepresentation is triggered during the notification phase.

Reference