[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 orderCreate()
 Create new order
------------------------------------------------------------------------------
 Prototype

     ERRCODE orderCreate(
                          AREAP wa,
                          LPDBORDERCREATEINFO lpdbCreateOrderInfo
                          )

 Arguments

     wa is a pointer to self.

     lpdbCreateOrderInfo is a pointer to a structure containing
     information for order creation.

 Description

     The orderCreate method creates a new order in wa.

 Default Behavior

     You must implement the default behavior of this method through a
     subclass.

 Implementation Notes

     .  Before you create and attach a new order to the work area,
        call goCold().

     .  orderCreate() provides the functionality of the CA-Clipper
        INDEX ON command.  In most implementations, orderCreate() should
        close any currently open orders before creating the new order.  After
        order creation, the closed orders may then be reopened or left
        closed, as dictated by the RDD implementation.

     .  The base ordering procedure requires key evaluation on an
        empty phantom row.  To reposition to a phantom row, perform a
        SELF_GOTO().  See go() for more information.

     Warning!  If you choose to allow orders to remain open during order
     creation, and your implementation provides for scoped or conditional
     orders, keep in mind that future order creations may be affected by such
     orders.

 Files  Header file is Rdd.api.


See Also: AREA DBORDERCREATEINFO go() orderListRebuild()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson