AnnoObjSelectNext

Usage                  AnnoObjSelectNext

Description         Selects the next object in the inner object list. If there is no object selected, the method will select the first object in the list automatically (to ensure that there is no object is selected, call the AnnoObjDeselect function); therefore you do not need to deal with “SelectFirst” type methods (there is no AnnoObjSelectFirst method in Annotation SDK). The enumeration of the object can be started anywhere in the object list with the mouse or with the AnnoObjSelect function.  The point of enumeration will be continued from that point on in the object list. In other words, the enumeration can start anywhere in the object list.

Parameters         None

Return value      1 if the next object is found. 0 if the last object in the list was selected previously and the enumeration is finished. In this case, the next call to this method will select the first object in the list again.           If there is no object in the list, the method will always return 0.

Programming Notes        Use this method to enumerate all of the annotation objects on the active page. The layers of the active page are ignored in the enumeration; the method will enumerate all objects independently from the layer number. However, you can check the layer number of the selected objects to decide working on them or not. You can use the AnnoObjGetLayer method for this purpose.

                                          IMPORTANT: All of the methods started with AnnoObj words work on the selected object only! You can use the AnnoObjSelectNext method before you call any of these methods.