ILS_W_RELATION_N
Category
Dynamic view-related macro (server side)
Description
This macro declares a multiple server relation as being accessible at runtime. This type of relation differs from the runtime relations declared with the macros
ILS_OWNS_N and
ILS_USES_N in that its modifier (that is, the member function used to add or remove target objects) is user-defined. This macro can be enclosed only between the following pairs of macros
:or their derivatives.
Synopsis
ILS_W_RELATION_N(originType,targetType,relation,modifier)
Arguments
This macro takes the following arguments:
originType designates the class where the relation is declared.
targetType specifies the class of the relation target.
relation stands for the name of the relation.
modifier is an editing function with the following signature:
IlsBoolean ownerType::modifier(targetType&,IlsBoolean);
Its first argument specifies the object to be added to or removed from the relation. The second argument is a Boolean value that indicates whether that object should be added (IlsTrue) or removed (IlsFalse).
The signature of this function can vary under the following conditions:
The function is a member of the class
originType or of a parent class.
Its result converts to
IlsBoolean.
It can be invoked with two arguments of type
targetType and
IlsBoolean respectively.
When the modifier returns
IlsFalse and if the rollback is enabled by the component, the current transaction is rolled back by the server and a rollback transaction is sent to the component that requested the modification. See the
“Transaction Control” sections in the
IlsMvComponent and
IlsMvServer class descriptions for more information.
See Also
Version 5.8
Copyright © 2014, Rogue Wave Software, Inc. All Rights Reserved.