L_AnnBringToFront

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnBringToFront(hObject)

/* handle to the annotation object */

Reorders the specified annotation object so that it is displayed on top of other objects in the same container.

This function is available in the Document and Medical Imaging toolkits.

Parameter	Description
hObject	Handle to the annotation object.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

(Document and Medical) This function moves the object to the end of the enumeration order for objects in the same container. When the container is displayed, using the L_AnnDraw function, this object is displayed last.

Required DLLs and Libraries

LTANN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Windows 2000 / XP/Vista.

See Also

Functions:	L_AnnDraw, L_AnnSendToBack,
	L_AnnGetBoundingRect
Topics:	Annotation Functions: Size, Position, and Shape
	Annotation Functions: Object Properties
	Implementing Annotations
	Implementing an Automated Annotation Program
	Implementing a Non-automated Annotation Program

Example

For complete sample code, refer to the Annotate example.

/* This example toggles an object, bringing it to the front or sending it to the back */
 L_INT AnnBringToFrontExample(HANNOBJECT hAnnObject)
{
   L_INT nRet;
   static BOOL InFront;

   if (InFront)
   {
      nRet = L_AnnSendToBack(hAnnObject);
      if(nRet != SUCCESS)
         return nRet;
      InFront = FALSE;
   }
   else
   {
      nRet = L_AnnBringToFront(hAnnObject);
      if(nRet != SUCCESS)
         return nRet;
      InFront = TRUE;
   }
   return SUCCESS;
}