#include "ltivw.h"

L_LTIVW_API L_INT L_DispContainerGetBuiltInTagCallBack(hCellWnd, ppBuiltInTagCallBack, ppUserData);

L_HWND hCellWnd;

handle to the cell window


pointer to be updated with the callback function

L_VOID ** ppUserData;

pointer to be updated with user data

Gets the current built-in tag callback function along with the user data, which were set using L_DispContainerSetBuiltInTagCallBack.



hCellWnd A handle to the window that represents the Medical Viewer Cell.
ppBuiltInTagCallBack Pointer to a pointer to a callback function to be updated with the last action callback function set using L_DispContainerSetBuiltInTagCallBack.
ppUserData Void pointer to be updated with the value of user defined data associated with the tag callback. If you are not interested in the user-defined data, pass NULL for this parameter.


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


To set the current callback function used to handle the built-in tag, call L_DispContainerSetBuiltInTagCallBack


The built-in tag is an overlay text that gets updated automatically once the image changes its correspondent property.

To add a tag to the medical viewer, use the function L_DispContainerSetCellTag.

Required DLLs and Libraries

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.
See Also
Functions: L_DispContainerSetBuiltInTagCallBack, L_DispContainerSetTagCallBack, L_DispContainerGetTagCallBack, L_DispContainerSetActionCallBack, DISPCONTAINERTAGCALLBACK, DISPCONTAINERACTIONCALLBACK
Topics: Applying Actions
Image Viewer Functions: Applying Actions


This function get built-in tag call.

L_TCHAR * szOutput = NULL; 
L_TCHAR * EXT_CALLBACK pBuildInTagCallback (L_HWND hCellWnd, 
L_INT nSubCellIndex, 
L_UINT      uTagType, 
L_TCHAR *      pString, 
L_VOID * pUserData) 
   if (uTagType == DISPWIN_TYPE_SCALE) 
      L_DOUBLE dScale; 
      L_DispContainerGetCellScale(hCellWnd, nSubCellIndex, &dScale, 0); 
      if (szOutput == NULL) 
         szOutput = (L_TCHAR *)malloc(sizeof(L_TCHAR) * 100); 
      wsprintf(szOutput, TEXT("Scale Value is = %f4"), dScale); 
      return szOutput; 
      return pString; 
L_INT L_DispContainerGetBuiltInTagCallBackExample(HWND hCellWnd) 
   L_VOID * pUserData; 
   L_DispContainerSetCellTag(hCellWnd, 1, DISPWIN_ALIGN_TOPLEFT, DISPWIN_TYPE_SCALE, NULL, 0); 
   L_DispContainerGetBuiltInTagCallBack(hCellWnd, &pBuildInTag, &pUserData); 
   L_DispContainerSetBuiltInTagCallBack(hCellWnd, pBuildInTagCallback, NULL); 
   return SUCCESS; 

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Medical Image Viewer C API Help