In This Topic ▼

L_DispContainerSetDefaultWindowLevelValues

Summary

Stores the window level default values.

Syntax

#include "ltivw.h"

L_LTIVW_API L_INT EXT_FUNCTION L_DispContainerSetDefaultWindowLevelValues(hCellWnd, nSubCellIndex, nWidth, nCenter, uFlags)

Parameters

L_HWND hCellWnd

A handle to the window that represents the cell on which the function's effect will be applied.

L_INT nSubCellIndex

A zero-based index into the image list attached to the cell specified in nCellIndex. This image will have its default window level values stored. Pass -1 to apply this effect on all sub-cells. Pass -2 to apply this effect on the selected sub-cell.

L_INT nWidth

Value that represents the window level width that will be set as a default value.

L_INT nCenter

Value that represents the window level center that will be set as a default value.

L_UINT uFlags

Reserved for future use. Pass 0.

Returns

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

Comments

This function will not set the current window level values, meaning that the user will not see a change in the image. To set the current window level values call L_DispContainerSetActionProperties. To get the current window level values call L_DispContainerGetActionProperties.

This function will not set the current window level values; it will set the default ones. The default can be set using either this function, or can be internally calculated when the images are first set in the control using either L_DispContainerSetCellBitmapList, or through L_DispContainerSetRequestedImage when the low memory usage feature is enabled (for more information see the L_DispContainerEnableCellLowMemoryUsage function).

To set the default window level values use the L_DispContainerSetDefaultWindowLevelValues function.
To reset the window level values to the default values use the L_DispContainerResetWindowLevelValues function.