Help Center

GridLinesUnpopulatedproperty

Returns or sets a value that determines the type of lines that are drawn between the unpopulated areas of the grid.

Windowspropertydoc-orphan
No implementation located. This member is documented, but the source scan found no matching declaration. It is likely declared in a header this scan does not resolve, or provided by a macro.

Syntax

PROPERTY GridLinesUnpopulated (BYVAL BandNumber AS LONG) AS GridLineSettings
PROPERTY GridLinesUnpopulated (BYVAL BandNumber AS LONG, BYVAL value AS GridLineSettings)
PROPERTY GridLinesUnpopulated () AS GridLineSettings
PROPERTY GridLinesUnpopulated (BYVAL value AS GridLineSettings)

Parameters

NameDescription
BandNumberA zero‑based index identifying the band whose background color is being retrieved or modified. If the band number is omited, band 0 is assumed.
valueA Long value or constant that specifies the type of lines drawn, as described in Settings.

Description

Returns or sets a value that determines whether lines are drawn within the unpopulated areas of the grid.

Remarks

When the GridLinesUnpopulated property is set to 1 (flat lines), the color of the lines is determined by the GridColorUnpopulated property. Raised and inset gridlines are always black and white.

Changing the line style triggers a complete repaint of the control. For large grids, set Redraw = False before changing this property.

Unlike the global GridLines property, GridLinesUnpopulated is an array property indexed by the band number, allowing you to apply different visual styles to the unpopulated gridlines for each level of nested data.

Example

' Removes gridlines from unpopulated areas for a cleaner look grid.GridLinesUnpopulated = flexGridNone

' Set a specific background for these empty areas to distinguish them grid.BackColorUnpopulated = vbButtonFace

Reference