DISPCONTAINERPROPERTIES

typedef struct tagDISPCONTAINERPROPERTIES
{
   L_UINT uStructSize;
   L_UINT uMask;
   L_UINT uMask1;
   L_UINT uNumRows;
   L_UINT uNumCols;
   COLORREF crEmptyCellBackGroundColor;
   COLORREF crBackground;
   COLORREF crText;
   COLORREF crShadow;
   COLORREF crRulerIn;
   COLORREF crRulerout;
   COLORREF crActiveBorderColor;
   COLORREF crNonActiveBorderColor;
   COLORREF crActiveSubCellBorderColor;
   HCURSOR hDefaultCursor;
   HCURSOR hRszVertCursor;
   HCURSOR hRszHorzCursor;
   HCURSOR hRszBothCursor;
   HCURSOR hAnnMoveCursor;
   HCURSOR hAnnSelectCursor;
   HCURSOR hAnnDefaultCursor;
   HCURSOR hRegionDefaultCursor;
   L_BOOL bAutoScroll;
   L_UINT uRulerStyle;
   L_UINT uCellsMaintenance;
   L_BOOL bShowFreezeText;
   L_UINT uBorderStyle;
   L_UINT uTextQuality;
   L_UINT uSplitterStyle;
   L_UINT bUseExtraSplitters;
   L_BOOL bCustomSplitterColor;
   COLORREF crSplitterColor;
   L_UINT uPaintingMethod;
   L_BOOL bShowContainerScroll;
   L_BOOL bShowCellScroll;
   L_UINT uOverlayTextSize;
   COLORREF crRegionBorderColor1;
   COLORREF crRegionBorderColor2;
   L_BOOL bInteractiveInterpolation;
} DISPCONTAINERPROPERTIES, * pDISPCONTAINERPROPERTIES;

The DISPCONTAINERPROPERTIES structure contains options for controlling the behavior of the container.

Member

Description

uStructSize

Size of this structure in bytes, for versioning. Use the sizeof() macro to calculate this value.

uMask

Value that indicates which members contains valid data for setting, or which members should be updated. Flags can be combined using the bitwise 'OR. Possible values are:

 

Value

Meaning

 

DCPF_ALL

All members must be valid or must be filled in.

 

DCPF_NUMROWS

The uNumRows member is valid or must be filled in.

 

DCPF_NUMCOLS

The uNumCols member is valid or must be filled in.

 

DCPF_EMPTYCELLBACKGROUNDCOLOR

The crEmptyCellBackGroundColor member is valid or must be filled in.

 

DCPF_BACKGROUNDCOLOR

The crBackGroundColor member is valid or must be filled in.

 

DCPF_TEXTCOLOR

The crText member is valid or must be filled in.

 

DCPF_SHADOWCOLOR

The crShadow member is valid or must be filled in.

 

DCPF_RULERINCOLOR

The crRulerIn member is valid or must be filled in.

 

DCPF_RULEROUTCOLOR

The rcRulerOut member is valid or must be filled in.

 

DCPF_ACTIVEBORDERCOLOR

The crActiveBorderColor member is valid or must be filled in.

 

DCPF_NONACTIVEBORDERCOLOR

The crNonActiveBorderColor member is valid or must be filled in.

 

DCPF_ACTIVESUBCELLBORDERCOLOR

The crActiveSubCellBorderColor member is valid or must be filled in.

 

DCPF_DEFAULTCURSOR

The hDefaultCursor member is valid or must be filled in.

 

DCPF_VERTCURSOR

The hRszVertCursor is valid or must be filled in.

 

DCPF_HORZCURSOR

The hRszHorzCursor is valid or must be filled in.

 

DCPF_BOTHCURSOR

The hRszBothCursor is valid or must be filled in.

 

DCPF_ANNDEFCURSOR

The hAnnDefaultCursor is valid or must be filled in.

 

DCPF_ANNMOVCURSOR

he hAnnMoveCursor is valid or must be filled in.

 

DCPF_ANNSELCURSOR

The hAnnSelectCursor is valid or must be filled in.

 

DCPF_RGNDEFCURSOR

The hRegionDefaultCursor is valid or must be filled in.

 

DCPF_AUTOSCROLL

The bAutoScroll member is valid or must be filled in.

 

DCPF_CELLSMAINTENANCE

The uCellsMaintenance is valid or must be filled in.

 

DCPF_SHOWFREEZETEXT

The bShowFreezText is valid or must be filled in.

 

DCPF_BORDERSTYLE

The uBorderStyle member is valid or must be filled in.

 

DCPF_TEXTQUALITY

The uTextQuality member is valid or must be filled in.

 

DCPF_RULERSTYLE

The uRulerStyle member is valid or must be filled in.

 

DCPF_SPLITTERSTYLE

The uSplitterStyle member is valid or must be filled in.

 

DCPF_SPLITTERCOLOR

The crSplitterColor member is valid or must be filled in.

 

DCPF_PAINTMETHOD

The uPaintingMethod member is valid or must be filled in.

 

DCPF_USEEXTRASPLITTERS

The bUseExtraSplitters member is valid or must filled in.

 

DCPF_SHOWVIEWERSCROLL

The bShowContainerScroll member is valid or must be filled in.

 

DCPF_SHOWCELLSCROLL

The bShowCellScroll member is valid or must be filled in.

 

DCPF_OVERLAYTEXTSIZE

The uOverlayTextSize member is valid or must be filled in.

uMask1

Additional value that indicates which members contains valid data for setting, or which members should be updated. Flags can be combined using the bitwise 'OR.  Possible values are:

 

Value

Meaning

 

DCPF1_ALL

All members must be valid or must be filled in.

 

DCPF1_REGIONCOLOR1

The crRegionBorderColor1 member is valid or must be filled in.

 

DCPF1_REGIONCOLOR2

The crRegionBorderColor2 member is valid or must be filled in.

 

DCPF1_INTERACTIVEINTERPOLATION

The bInteractiveInterpolation member is valid or must be filled in.

uNumRows

Number of rows in the container. The default value is 1. The maximum is 4.

uNumCols

Number of columns in the container. The default value is 1. The maximum is 8.

crEmptyCellBackGroundColor

Background color to display in empty cells. The default color is black.

crBackground

Background color to display in non-empty cells. The default color is black.

crText

Text color. The default color is white.

crShadow

Shadows color. The default color is black.

crRulerIn

Ruler-in color. The default color is white.

crRulerout

Ruler-out color. The default color is blue.

crActiveBorderColor

Color of the border used to designate a selected cell. The default color is RGB(255, 192, 0).

crNonActiveBorderColor

Color of the border used to designate an unselected cell. The default color is white.

crActiveSubCellBorderColor

Color of the border used to designate a selected sub cell. The default color is yellow.

hDefaultCursor

Default cursor for the container. The default value is IDC_ARROW.

hRszVertCursor

Default cursor for resizing vertically. The default value is IDC_SIZENS.

hRszHorzCursor

Default cursor for resizing horizontally. The default value is IDC_SIZEWE.

hRszBothCursor

Default cursor for resizing horizontally and vertically. The default value is IDC_SIZEBOTH.

hAnnMoveCursor

Default cursor that appears when hovering over the selected annotation body.

hAnnSelectCursor

Default cursor that appears when hovering over the unselected annotation body.

hAnnDefaultCursor

Default cursor that appears when hovering over the handles of the selected annotation object.

hRegionDefaultCursor

Default cursor that appears as the user drags the mouse to create the region.

uSplitterStyle

Flags that determine the style of the splitter. Possible values are:

 

Value

Meaning

 

CONTAINER_BORDERSIZE_NONE

No splitter is shown.

 

CONTAINER_BORDERSIZE_THIN

One pixel width splitter.

 

CONTAINER_BORDERSIZE_THICK

Thick 3D splitter (Default).

bUseExtraSplitters

Flag that indicates whether to display the extra splitter at the bottom and right of the control in order to allow adding more rows and columns dynamically. Possible values are:

 

Value

Meaning

 

TRUE

Show the splitter at the right and bottom of the control.

 

FALSE

Do not show the splitters at the right and bottom of the control.

bCustomSplitterColor

Flag that indicates whether to use crSplitterColor to draw the splitter or to use the system theme color. Possible values are:

 

Value

Meaning

 

TRUE

The color of the splitters will be specified in crSplitterColor member.

 

FALSE

The color of the splitters will be determined by the system theme color.

crSplitterColor

Color of the splitter. This value is ignored when bCustomSplitterColor is FALSE.

uPaintingMethod

Flag that indicates the method used to draw the images. Possible values are:

 

Value

Meaning

 

DISPLAYMODE_FASTPAINT

Enables or disables fast painting. Fast painting should be performed only if the current video driver is good, and the image does not need to be dithered or resized to paint. No safety check for a faulty driver is performed.

 

DISPLAYMODE_RESAMPLE

Use bilinear interpolation (resample) if the paint process needs to resize the image. (slower than regular resize)

 

DISPLAYMODE_BICUBIC

Use bicubic interpolation if the paint process needs to resize the image. (slower than DISPLAYMODE_RESAMPLE

bShowContainerScroll

Flag that indicates whether to display the viewer scroll that is used to scroll throw the cells. Possible value are:

 

Value

Meaning

 

TRUE

Display the viewer scroll

 

FALSE

Don’t display the viewer scroll.

 

uRulerStyle

Flag that indicates the style of the rulers in the cells of the container. Possible values are:

 

Value

Meaning

 

DCPF_RULERSTYLE_INVERT

The ruler is drawn using an inverted pen. This is the default value.

 

DCPF_RULERSTYLE_BORDERED

The ruler is drawn using both the pen specified in crRulerout and crRulerin.

uCellsMaintenance

Flag that indicates whether to maintain, if possible, cell size or cell position. Possible values are:

 

Value

Meaning

 

DCPF_CELLSMAINTENANCE_SIZE

Maintain cell size, if possible. This is the default value.

 

DCPF_CELLSMAINTENANCE_POS

Maintain cell position.

 

bAutoScroll

value that indicate whether to allow the medical viewer to add a scroll bar to scroll through the cells. Possible values are:

 

Value

Meaning

 

TRUE

Add a scroll bar to scroll through the cells

 

FALSE

Not to add a scroll bar to scroll through the cells

bShowFreezeText

Flag that indicates whether to display the word "Freeze" on frozen cells. Possible values are:

 

Value

Meaning

 

TRUE

Display the word "Freeze" on frozen cells. This is the default value.

 

FALSE

Do not display the word "Freeze" on frozen cells.

 

uBorderStyle

Flags that determine the style of the border. Possible values are:

 

Value

Meaning

 

PS_SOLID

Solid border.

 

PS_DASH

Dashed border.

 

PS_DOT

Dotted border. This is the default value.

 

PS_DASHDOT

Dash and dot border.

 

PS_DASHDOTDOT

Dash and two dots border.

uTextQuality

Flags that determine the quality of the text and whether it is anti-aliased. Possible values are:

 

Value

Meaning

 

DEFAULT_QUALITY

Default quality.

 

DRAFT_QUALITY

Draft quality.

 

PROOF_QUALITY

Proof quality.

 

NONANTIALIASED_QUALITY

Forces use of draft quality.

 

ANTIALIASED_QUALITY

Enables anti-aliasing for the font.

bShowCellScroll

Flag that indicates whether to display the cell scroll that is used to scroll through the cell frames. Possible value are:

 

Value

Meaning

 

TRUE

Display the cell scroll.

 

FALSE

Don’t display the cell scroll.

uOverlayTextSize

The size of the overlay tags that appears of the cell sides. Setting this value to any number will cause the text has a static size regardless of the cell being resized. If the user set this value to 0, the control will follow the old behavior and the cell tags will be resized based on the cell current size. The default value is 0.

crRegionBorderColor1

The first Color of the region marching ants. The default color is RGB(255, 0, 0).

crRegionBorderColor2

The second Color of the region marching ants. The default color is RGB(0, 0, 0).

bInteractiveInterpolation

Flag that indicates whether to use the interactive interpolation technique when using one of the image viewer UI tools. Possible value are:

 

Value

Meaning

 

TRUE

Use the interactive interpolation.

 

FALSE

Don’t use the interactive interpolation.

Comments

This structure is used by the L_DispContainerSetProperties and L_DispContainerGetProperties functions.