Visual Basic: DataGrid Control
MarqueeStyle Property
See Also Example Applies To
Sets or returns the Marquee style for the DataGrid control or Split object.
Syntax
object**.MarqueeStyle** [**=**value]
The MarqueeStyle property syntax has these parts:
Part | Description |
object | An object expression that evaluates to an object in the Applies To list. |
value | A number or constant that specifies the Marqee style, as described in Settings. |
Settings
The settings for value are:
Constant | Value | Description |
dbgDottedCellBorder | 0 | The current cell within the current row will be highlighted by drawing a dotted border around the cell. In Microsoft Windows terminology, this is usually called a focus rectangle. |
dbgSolidCellBorder | 1 | The current cell within the current row will be highlighted by drawing a solid box around the current cell. This is more visible than the dotted cell border, especially when 3-D divider properties are used for the grid. |
dbgHighlightCell | 2 | The entire current cell will be highlighted by inverting the colors within the cell. This provides a very distinctive block-style highlight for the current cell. |
dbgHighlightRow | 3 | The entire row containing the current cell will be highlighted by inverting the colors within the row. In this mode, it is not possible to visually determine which cell is the current cell, only the current row. When the grid or split is not editable, this setting is often preferred, since cell position is then irrelevant. |
dbgHighlightRowRaiseCell | 4 | The entire row will be highlighted. The current cell within the row will be "raised" so that it appears distinctive. This setting doesn't appear clearly with all background color and divider settings. The best effect is achieved by using 3-D dividers and a light gray background. |
dbgNoMarquee | 5 | The marquee will not be shown. This setting is useful for cases where the current row is irrelevant, or where you don't want to draw the user's attention to the grid until necessary. |
dbgFloatingEditor | 6 | The current cell will be highlighted by a floating text editor window with a blinking caret (as in Microsoft Access). This is the default setting. |
Remarks
If a grid contains multiple splits, then setting its MarqueeStyle property has the same effect as setting the MarqueeStyle property of each split individually.
Note If the floating editor marquee setting is in effect and the current cell contains radio buttons or graphics, then a dotted focus rectangle will be displayed.