Table of Contents

Namespace NanoByte.Common.Controls

WinForms controls and forms.

Dialogs

Use Msg to show simple message boxes and ErrorBox to report exceptions to the user.

InputBox and OutputBox (along with OutputGridBox and OutputTreeBox) provide quick prompts and result displays.

Derive your own dialogs from OKCancelDialog for consistent OK/Cancel behavior.

Controls

FilteredTreeView<T> displays a list of INameds in a tree with incremental search.

TaskControl, TaskProgressBar and TaskLabel display the progress of ITasks.

HintTextBox, UriTextBox and DropDownButton provide specialized variants of standard WinForms controls.

API

Classes

ControlExtensions

Provides extension methods for Controls.

DropDownButton

A Button with an additional drop-down menu.

DropDownContainer

A custom drop-down that can contain arbitrary controls instead of just a menu.

ErrorBox

A dialog displaying an error message and details.

ErrorReportForm

Presents the user with a friendly interface in case of an error, offering to report it to the developers.

FilteredTreeView<T>

Displays a list of INameds objects in a TreeView with incremental search. An automatic hierarchy is generated based on a Separator character.

HintTextBox

A special TextBox that displays a HintText when Text is empty and a clear button when it is not.

InputBox

Shows a simple dialog asking the user to input some text.

Msg

Provides easier access to typical MessageBox configurations and automatically upgrades to TaskDialogs when available.

OKCancelDialog

A base-class for creating fixed-size dialog boxes with an OK and a Cancel button.

OutputBox

A simple dialog displaying selectable multi-line text.

OutputGridBox

Displays tabular data to the user.

OutputTreeBox

Factory methods for OutputTreeBox<T>.

OutputTreeBox<T>

Displays tree data to the user.

PropertyGridForm

Contains a single property grid for manipulating the properties of an object.

ResettablePropertyGrid

A PropertyGrid that provides a "reset value" option in its context menu.

RtfBuilder

Builds an RTF-formatted string with paragraphs.

TaskControl

Combines a TaskProgressBar and a TaskLabel.

TaskLabel

A progress label that takes TaskSnapshot inputs.

TaskProgressBar

A progress bar that takes TaskSnapshot inputs.

TimeSpanControl

Allows the input of a TimeSpan using NumericUpDown boxes.

UriTextBox

A HintTextBox designed specifically for entering URIs.

Interfaces

IContextMenu

An object that can provide its own context menu.

IEditorDialog<T>

Provides an interface to a dialog that edits a single object.

Enums

RtfColor