ILS_W_RELATION_N
 
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:
*ILS_OBJECT_BEGIN/ILS_OBJECT_END
*ILS_ENTITY_BEGIN/ILS_ENTITY_END
*ILS_MVVIEW_BEGIN/ILS_MVVIEW_END
or their derivatives.
Header File 
#include <ilserver/rtmodel.h>
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 
IlsOwns, ILS_OWNS_N, ILS_R_RELATION_N, ILS_RW_RELATION_N, IlsUses, ILS_USES_N

Version 5.8
Copyright © 2014, Rogue Wave Software, Inc. All Rights Reserved.