L_DispContainerRemoveAction

#include "ltivw.h"

L_LTIVW_API L_INT L_DispContainerRemoveAction(hCellWnd, nAction, uFlags)

L_HWND hCellWnd;

handle to the cell window

L_INT nAction;

action ID

L_UINT uFlags;

reserved for future use

Removes the specified action from the container.

Parameter Description
hCellWnd A handle to the window that represents the Medical Viewer Cell.
nAction Value that represents the action to be removed. If nAction is equal to or greater than 100, it is a user-defined action. Otherwise, it can be one of the following predefined actions.
  Value Meaning
  CONTAINER_ACTION_NONE [0] No action
  CONTAINER_ACTION_WINDOWLEVEL [1] Window leveling
  CONTAINER_ACTION_SCALE [2] Scaling
  CONTAINER_ACTION_OFFSET [3] Offset
  CONTAINER_ACTION_STACK [4] Stacking
  CONTAINER_ACTION_MAG [5] Magnifying glass
  CONTAINER_ACTION_ALPHA [6] Alpha
  CONTAINER_ACTION_ANNOTATION_RULER [7] Ruler annotation
  CONTAINER_ACTION_ANNOTATION_ANGLE [8] Angle annotation
  CONTAINER_ACTION_ANNOTATION_TEXT [9] Text annotation
  CONTAINER_ACTION_ANNOTATION_ARROW [10] Arrow annotation
  CONTAINER_ACTION_ANNOTATION_RECTANGLE [11] Rectangle annotation
  CONTAINER_ACTION_ANNOTATION_ELLIPSE [12] Ellipse annotation
  CONTAINER_ACTION_ANNOTATION_HILITE [13] Highlight annotation
  CONTAINER_ACTION_REGION_RECTANGLE [14] Rectangular region
  CONTAINER_ACTION_REGION_ELLIPSE [15] Elliptical region
  CONTAINER_ACTION_REGION_FREEHAND [16] Free hand region
  CONTAINER_ACTION_REGION_POLYGON [17] Polygon region
  CONTAINER_ACTION_REGION_MAGICWAND [18] Magic wand (contiguous color) region
  CONTAINER_ACTION_REGION_COLORRANGE [19] Color range region
  CONTAINER_ACTION_REGION_CIRCLE [20] Circular region
  CONTAINER_ACTION_REGION_SQUARE [21] Square region
  CONTAINER_ACTION_REGION_NUDGETOOL [22] Nudge tool
  CONTAINER_ACTION_REGION_SHRINKTOOL [23] Shrink tool
uFlags Reserved for future use. Pass 0.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

When an action is removed from a container, all properties, mouse buttons, and keystroke combinations are also removed.

Required DLLs and Libraries

LTIVW

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_DispContainerAddAction, L_DispContainerSetAction, L_DispContainerSetActionProperties, L_DispContainerGetActionProperties, L_DispContainerGetActionCount, L_DispContainerSetKeyboardAction, L_DispContainerGetKeyboardAction, L_DispContainerIsActionActive, L_DispContainerGetActionCallBack, L_DispContainerSetActionCallBack

Topics:

Applying Actions

 

Image Viewer Functions: Applying Actions

Example

This function checks whether the action is assigned to a keyboard shortcut or not, if not the function removes it.

L_INT DispContainerRemoveActionExample(HWND           hWnd, 
HDISPCONTAINER hCon, 
L_INT          nAction) 
{ 
   L_INT nRet; 
   L_BOOL bActive; 
   L_UINT uVk1, uVk2, uVk3, uVk4, uModifiers; 
   if (L_DispContainerGetCellCount(hCon, 0) == 0) 
   { 
      MessageBox(NULL, TEXT("you must at least have one cell added to the viewer"), TEXT("No Cell attached"), MB_OK); 
      return FAILURE; 
   } 
   HWND hCellWnd = L_DispContainerGetCellWindowHandle(hCon, 0, 0); 
   // Is the action added to the image viewer. 
   bActive = L_DispContainerIsActionActive (hCellWnd, nAction, 0); 
   if (!bActive) 
   { 
      // Check whether a keyboard shortcut is assigned to the action or not. 
      nRet = L_DispContainerGetKeyboardAction(hCellWnd, nAction, CONTAINER_MOUSEMOVE_DOWN, &uVk1, &uModifiers, 0); 
      if(nRet != SUCCESS) 
         return nRet; 
      nRet = L_DispContainerGetKeyboardAction(hCellWnd, nAction, CONTAINER_MOUSEMOVE_DOWN, &uVk2, &uModifiers, 0); 
      if(nRet != SUCCESS) 
         return nRet; 
      nRet = L_DispContainerGetKeyboardAction(hCellWnd, nAction, CONTAINER_MOUSEMOVE_DOWN, &uVk3, &uModifiers, 0); 
      if(nRet != SUCCESS) 
         return nRet; 
      nRet = L_DispContainerGetKeyboardAction(hCellWnd, nAction, CONTAINER_MOUSEMOVE_DOWN, &uVk4, &uModifiers, 0); 
      if(nRet != SUCCESS) 
         return nRet; 
      // If there is no keyboard shortcut assigned to the action the function will remove it. 
      if ((!uVk1) && (!uVk2) && (!uVk3) && (!uVk4)) 
      { 
         nRet = L_DispContainerRemoveAction (hCellWnd, nAction, 0); 
         if(nRet != SUCCESS) 
            return nRet; 
      } 
   } 
   else 
   { 
      MessageBox(hWnd, TEXT("This action is not added to the image viewer"), TEXT("Error!"), MB_OK); 
   } 
   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