L_AnnBringToFront

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnBringToFront(hObject)

HANNOBJECT 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;
}