L_DispContainerAddAction

#include "ltivw.h"

L_INT EXT_FUNCTION L_DispContainerAddAction(hCon, nAction, uFlags)

HDISPCONTAINER hCon;

/* handle to the container */

L_INT nAction;

/* action to be added */

L_UINT uFlags;

/* reserved for future use */

Adds a new action to the container. This function is available only in the Medical Imaging Suite toolkits.

Parameter

Description

hCon

Handle to the container.

nAction

Value that indicates the action to be added. If nAction is equal to or greater than 100, it is a user-defined action. Otherwise, it should be one of these predefined actions:

 

Value

Meaning

 

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

uFlags

Reserved for future use. Must be zero.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

The same action cannot be added to a container twice.

To set or get the properties of a specific action, use L_DispContainerSetActionProperties, or L_DispContainerGetActionProperties.

Once an action has been added to the container, it can be associated with a particular mouse movement, a keystroke combination, or both. To associate an action with the mouse, call L_DispContainerSetAction. To associate an action with a keystroke combination, call L_DispContainerSetKeyboardAction.

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

Topics:

Applying Actions

 

Image Viewer Functions: Applying Actions

Example

For an example, refer to L_DispContainerCreate.