| RpObjectOpenView Method (String, MvValue, MvValue, Int32, Boolean) |
Requests the server to open a view on the server object
associated with this representation object.
Namespace: RW.Server.ComponentAssembly: RW.Server.Component (in RW.Server.Component.dll) Version: 6.3.0.0 (0.8.0.0)
Syntax public virtual void OpenView(
string viewName,
MvValue[] argv,
MvValue[] ackArgv,
int index = 0,
bool force = false
)
Public Overridable Sub OpenView (
viewName As String,
argv As MvValue(),
ackArgv As MvValue(),
Optional index As Integer = 0,
Optional force As Boolean = false
)
public:
virtual void OpenView(
String^ viewName,
array<MvValue^>^ argv,
array<MvValue^>^ ackArgv,
int index = 0,
bool force = false
)
Parameters
- viewName
- Type: SystemString
The name of the view to be opened. - argv
- Type: RW.Server.ComponentMvValue
If the view opens successfully, these values are used to
initialize the dynamic view parameters as they are declared in
the view specification file : the first value in the array is
assigned to the first view parameter, the second value to the
second view parameter, and so forth. - ackArgv
- Type: RW.Server.ComponentMvValue
The array of MvValue objects that is sent
in the invocation of the
AckOpenView()
method as parameter. It can be null. - index (Optional)
- Type: SystemInt32
The index in the ackArgv array that will
contain the status of the opening view encapsulated in an
MvValue whose type is Character. - force (Optional)
- Type: SystemBoolean
If set to true, this parameter requires to force the
opening of a view that was previously opened by the
component. If this parameter is set to false
and the view has already been opened by the component, the
view is not duplicated, but the
SetSelection method is called
on the representation associated with this view.
Remarks
This function is identical to
OpenView(String, MvValue, Boolean) except that
Rogue Wave Server executes a call to the representation object
function AckOpenView(MvValue) during the
acknowledgement or rollback of the transaction that includes
the call to this method.
In case of success, the event CreateRepresentation
is also triggered by Rogue Wave Server on the new representation's component,
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.
See Also