LImageViewer::GetActionProperties
#include "ltwrappr.h"
L_INT LImageViewer::GetActionProperties (nAction, nCellIndex, nSubCellIndex, pActionProperties, uFlags);
L_INT nAction; |
/* action ID */ |
L_INT nCellIndex; |
/* index of a cell */ |
L_INT nSubCellIndex; |
/* index into the image list attached to the cell */ |
LONG pActionProperties; |
/* pointer to a structure */ |
L_UINT uFlags; |
/* type of properties */ |
Gets the current properties of a specific action. This function is available only in the Medical Imaging Suite toolkits.
Parameter |
Description |
|
nAction |
Value that specifies the action for which to get the properties. 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_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 region |
|
CONTAINER_ACTION_REGION_COLORRANGE |
[19] Color range region |
|
CONTAINER_ACTION_REGION_CIRCLE |
[20] Circular region |
|
CONTAINER_ACTION_REGION_SQUARE |
[21] Square region |
nCellIndex |
A zero-based index of the cell for which to get the action properties. This parameter is only valid when CONTAINER_ACTION_CELLLEVEL is set in uFlags. If uFlags contains CONTAINER_ACTION_CONTAINERLEVEL, this parameter is ignored. Pass -2 to retrieve the action properties of selected sub-cell. |
|
nSubCellIndex |
A zero-based index into the image list attached to the cell specified in nCellIndex. This parameter is only valid when CONTAINER_ACTION_CELLLEVEL is set in uFlags. If uFlags contains CONTAINER_ACTION_CONTAINERLEVEL, this parameter is ignored. |
|
pActionProperties |
Pointer to a structure to be updated with the action properties. The type of structure pointed to depends on the action specified in the nAction parameter. |
|
|
If nAction contains: |
then pActionProperties points to this structure: |
|
CONTAINER_ACTION_WINDOWLEVEL |
DISPWLEVELACTIONPROPS |
|
CONTAINER_ACTION_SCALE |
DISPSCALEACTIONPROPS |
|
CONTAINER_ACTION_OFFSET |
DISPOFFSETACTIONPROPS |
|
CONTAINER_ACTION_STACK |
DISPSTACKACTIONPROPS |
|
CONTAINER_ACTION_MAG |
DISPMAGACTIONPROPS |
|
CONTAINER_ACTION_ALPHA |
DISPALPHAACTIONPROPS |
|
CONTAINER_ACTION_ANNOTATION_RULER |
DISPANNOTATIONPROPS |
|
CONTAINER_ACTION_ANNOTATION_ANGLE |
DISPANNOTATIONPROPS |
|
CONTAINER_ACTION_ANNOTATION_TEXT |
DISPANNOTATIONPROPS |
|
CONTAINER_ACTION_ANNOTATION_ARROW |
DISPANNOTATIONPROPS |
|
CONTAINER_ACTION_ANNOTATION_RECTANGLE |
DISPANNOTATIONPROPS |
|
CONTAINER_ACTION_ANNOTATION_ELLIPSE |
DISPANNOTATIONPROPS |
|
CONTAINER_ACTION_ANNOTATION_HILITE |
DISPANNOTATIONPROPS |
|
CONTAINER_ACTION_REGION_RECTANGLE |
DISPREGIONPROPS |
|
CONTAINER_ACTION_REGION_ELLIPSE |
DISPREGIONPROPS |
|
CONTAINER_ACTION_REGION_FREEHAND |
DISPREGIONPROPS |
|
CONTAINER_ACTION_REGION_POLYGON |
DISPREGIONPROPS |
|
CONTAINER_ACTION_REGION_MAGICWAND |
DISPREGIONPROPS |
|
CONTAINER_ACTION_REGION_COLORRANGE |
DISPREGIONPROPS |
|
CONTAINER_ACTION_REGION_CIRCLE |
DISPREGIONPROPS |
|
CONTAINER_ACTION_REGION_SQUARE |
DISPREGIONPROPS |
|
Owner Action |
DISPOWNERACTIONPROPS |
uFlags |
Flag that determines which properties to get. Possible values are: |
|
|
Value |
Meaning |
|
CONTAINER_ACTION_CONTAINERLEVEL |
[0x00000000] Get the general properties. |
|
CONTAINER_ACTION_CELLLEVEL |
[0x00000001] Get the specific properties. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
Each of the structures that may be pointed to by pActionProperties contains a member that is a DISPCONTAINERACTIONPROPS structure. Each of these structures also contains one or more other members. The DISPCONTAINERACTIONPROPS structure contains "general properties" that are common to all actions. The other members of the structures are considered may be "general properties" or "specific properties", depending on whether they are applied at the container level or the cell level. Those members that are applied at the container level are also considered "general properties". Members that are applied at the cell level or the sub-cell level are considered "specific properties". For example, if this function is called to get the scale action properties, a variable of type DISPSCALEACTIONPROPS should be declared. Pass a pointer to this structure for the pActionProperties parameter. To get only the general properties, set uFlags to CONTAINER_ACTION_CONTAINERLEVEL. To get the specific properties, set uFlags to CONTAINER_ACTION_CELLLEVEL.
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
Example
For an example, refer to LImageViewer::Create.