Gets the RebarBand that is currently being dragged.

Property Value

The RebarBand being dragged, or a null reference (Nothing in Visual Basic) if no band is currently being dragged.

Remarks

You can also use the IsDragging property to determine whether or not a band is being dragged.

Example

This example handles the DragBand, DragBandComplete and DrawBand events of a Rebar control. It demonstrates two things:

• When a band is dragged, the status bar text is set to the band's text.
• Drawing a rebar band using custom code. In this example, the band being dragged is drawn using a highlighted background.

This example requires the following:

• A form with a Rebar control named "rebar" and a StatusBar control named "statusBar".
• The DrawMode property of the Rebar control is set to OwnerDraw.
• The DragBand, DragBandComplete and DrawBand events are handled by the methods in the example.

private void rebar_DragBand(object sender, Skybound.Rebar.RebarBandEventArgs e)
{
    // set status bar text to the text on the band:
    statusBar.Text = e.Band.Text;
    // force band to repaint:
    e.Band.Refresh();
}

private void rebar_DragBandComplete(object sender, Skybound.Rebar.RebarBandEventArgs e)
{
    // clear status bar text:
    statusBar.Text = "";
    // force band to repaint:
    e.Band.Refresh();
}

private void rebar_DrawBand(object sender, Skybound.Rebar.DrawBandEventArgs e)
{
    // ensure that a band is dragging, and that the band we are drawing is being dragged:
    if (rebar.IsDragging && rebar.DraggingBand == e.Band)
    {
        // fill background of band with a semi-transparent brush, based on the system highlight color
        using (SolidBrush brush = new SolidBrush(Color.FromArgb(96, SystemColors.Highlight)))
            e.Graphics.FillRectangle(brush, e.Renderer.Bounds);
    }
    // call default implementation to render the band:
    e.Renderer.RenderBand(e.Graphics);
}
            

See Also

Rebar Class | Skybound.Rebar Namespace

---