WinForms › Scroll Bar Marker

Scroll Bar Marker

.NET Framework 4.8.NET 6 / 8 / 10v3.1.0WinForms

What every scroll bar mark has: the position it marks, its size and alignment, an optional border, a tool tip and a tag for your own data.

10public types

56public members

1namespaces

Assembly

Assembly	`Binarymission.WinForms.Controls.MarkerScrollBar.dll`
Root namespace	`Binarymission.WinForms.Controls.MarkerScrollBar`
Target frameworks	.NET Framework 4.8, .NET 6 / 8 / 10
Depends on	`BinaryMenu`, `BinaryScrollBars`

Overview

Add the derived marks – ScrollBarShapeMark, ScrollBarRangeMark, ScrollBarImageMark – to the ScrollBarMarks list of a MarkerVerticalScrollBar or MarkerHorizontalScrollBar. A plain ScrollBarMarkBase in the list is not drawn.

Getting started

using Binarymission.WinForms.Controls.MarkerScrollBar;

// Designer: build the solution once, then drag ScrollBarMarkBase from the Toolbox onto a form.
// In code:
var scrollBarMarkBase = new ScrollBarMarkBase
{
    Dock = DockStyle.Fill,
};
this.Controls.Add(scrollBarMarkBase);

API reference

`Binarymission.WinForms.Controls.MarkerScrollBar`

enum `ImageMarkSizingMode`	How a `ScrollBarImageMark` chooses the size its image is drawn at.
class `MarkerHorizontalScrollBar`	A horizontal scroll bar that shows marks on its track - events on a timeline, bookmarks, selected ranges - at the positions they belong to, so the user can see where they are and click to go there.
class `MarkerVerticalScrollBar`	A vertical scroll bar that shows marks on its track - errors, warnings, bookmarks, changed regions - at the positions they belong to, so the user can see where they are in a long document and click to go there.
class `ScrollBarImageMark`	A small image on a marker scroll bar, centred on the position it marks - a bookmark flag, a breakpoint dot, a status icon.
enum `ScrollBarMarkAlignment`	Where a mark sits across a marker scroll bar. Left, Center and Right apply to a vertical bar; Top, Center and Bottom to a horizontal one.
class `ScrollBarMarkBase`	What every scroll bar mark has: the position it marks, its size and alignment, an optional border, a tool tip and a tag for your own data.
class `ScrollBarRangeMark`	A band on a marker scroll bar covering a stretch of the range, from `Value` to `EndValue` - a changed region, a selection, a time window.
class `ScrollBarShapeMark`	A coloured rectangle or oval on a marker scroll bar, centred on the position it marks - the usual way to show an error, a warning or a search hit.
enum `ScrollBarShapedMarkMode`	How a `ScrollBarShapeMark` or `ScrollBarRangeMark` is filled.
enum `ScrollBarShapedMarkShape`	The shape of a `ScrollBarShapeMark` or `ScrollBarRangeMark`.