Scope Property (SectionPaintingEventArgs)

Visual Basic (Declaration)
Visual Basic (Usage)
C#

Public ReadOnly Property Scope As CellScope

Dim instance As SectionPaintingEventArgs
Dim value As CellScope
 
value = instance.Scope

public CellScope Scope {get;}

Property Value

A CellScope value that represents the cell area that the event occurs for.

The following code example shows how to customize a sections paint logic. This code example is part of a larger example provided for the CellPainting event.

C#

void gcMultiRow_SectionPainting(object sender, SectionPaintingEventArgs e)
        {
            if (e.RowIndex == this.gcMultiRow.NewRowIndex && e.Scope == CellScope.Row)
            {
                e.Paint(e.ClipBounds);

                StringFormat sf = new StringFormat();
                sf.Alignment = StringAlignment.Center;

                // Paint string in section face.
                e.Graphics.DrawString("Edit cell in this row to add new rows", gcMultiRow.Font, Brushes.Gray, e.SectionBounds, sf);

                // If you customize the paint logic, make sure the Handled property is set to true.
                e.Handled = true;
            }
        }

VB.NET

Private Sub gcMultiRow_SectionPainting(ByVal sender As Object, ByVal e As SectionPaintingEventArgs) Handles gcMultiRow.SectionPainting
        If e.RowIndex = Me.gcMultiRow.NewRowIndex AndAlso e.Scope = CellScope.Row Then
            e.Paint(e.ClipBounds)

            Dim sf As New StringFormat()
            sf.Alignment = StringAlignment.Center

            ' Paint string in section face.
            e.Graphics.DrawString("Edit cell in this row to add new rows", gcMultiRow.Font, Brushes.Gray, e.SectionBounds, sf)

            ' If you customize the paint logic, make sure the Handled property is set to true.
            e.Handled = True
        End If
    End Sub

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

SectionPaintingEventArgs Class
SectionPaintingEventArgs Members