L_DispContainerIsCellFrozen
#include "ltivw.h"
L_LTIVW_API L_BOOL L_DispContainerIsCellFrozen(hCon, nCellIndex, uFlags)
HDISPCONTAINER hCon; |
/* handle to the container */ |
L_INT nCellIndex; |
/* index of the cell */ |
L_UINT uFlags; |
/* reserved for future use */ |
Returns a value that indicates whether the specified cell is frozen. This function is available only in the Medical Imaging Suite toolkits.
Parameter |
Description |
hCon |
Handle to the container. |
nCellIndex |
A zero-based index of the cell for which to determine the freeze status. |
uFlags |
Reserved for future use. Pass 0. |
Returns
TRUE |
The cell is frozen. |
FALSE |
The cell is not frozen, or an error occurred. To get extended error information, call GetLastError. |
Comments
To freeze or un-freeze a cell, call L_DispContainerFreezeCell.
When a cell is frozen no actions using the mouse or the keyboard can be performed on the cell. Some cell properties can still be changed manually however, using L_DispContainerSetCellProperties, L_DispContainerSelectCell and L_DispContainerSetProperties. For more information on actions associated with a container, refer to Applying Actions.
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
This procedure unfreezes any frozen cell
L_INT DispContainerIsCellFrozenExample(HDISPCONTAINER hCon) { L_INT nRet; // Get the cells count. L_INT nCount = L_DispContainerGetCellCount (hCon, 0); L_INT nI; for (nI = 0; nI < nCount; nI++) { // if there is a selected cell make it unselected and vice versa L_BOOL bFreezed = L_DispContainerIsCellFrozen (hCon, nI, 0); if (bFreezed) { nRet = L_DispContainerFreezeCell (hCon, nI, FALSE, 0); if(nRet != SUCCESS) return nRet; } } return SUCCESS; }