Duraxium.Controls 3.0.0

Duraxium WPF IP TextBox Library

Two deluxe IP address text boxes for WPF – one for IPv4 addresses and another for IPv6 addresses. Both text boxes prevent invalid IP addresses from being entered.

One "hidden" text box for WPF – text entered into the text box appears normally for a short time, then is replaced by dots to obscure the characters like a password box.

Two level controls for WPF – an alternative to a slider control. The level is displayed as a bar and a numeric value. The value (and bar length) are adjusted up or down using a button on either end of the control.

Ipv4TextBox

A custom WPF TextBox control that allows only dotted-decimal IP addresses to be entered. In addition to keyboard entry, clipboard copy, cut, and paste operations are supported. The control does not support dotted octal or hexadecimal addresses.

All standard TextBox properties are supported. The Text property is used to get or set the IP address text.

An additional dependency property, UseErrorFlash, is provided. With UseErrorFlash set to true (the default) the background of the control is flashed whenever someone tries to enter invalid text. You can disable this feature by setting UseErrorFlash to false.

Setting UpdateSourceTrigger to PropertyChanged is not recommended because your view-model will receive partial (invalid) IP addresses.

If the control is initialized using an invalid IP address, it will not throw an exception – it will display “0” instead.

Ipv6TextBox

A custom WPF TextBox control that allows only colon-hexadecimal IP addresses to be entered. In addition to keyboard entry, clipboard copy, cut, and paste operations are supported.

All standard TextBox properties are supported. The Text property is used to get or set the IP address text.

An additional dependency property, UseErrorFlash, is provided. With UseErrorFlash set to true (the default) the background of the control is flashed whenever someone tries to enter invalid text. You can disable this feature by setting UseErrorFlash to false.

Setting UpdateSourceTrigger to PropertyChanged is not recommended because your view-model will receive partial (invalid) IP addresses.

If the control is initialized using an invalid IP address, it will not throw an exception – it will display '0' instead.

AddressFactory

The static class AddressFactory can be used to convert an IPv4 or IPv6 address string to an IPAddress object. It provides one method:

public static IPAddress StringToAddress(string ipText)

Convert an IP address string to an IPAddress object.

​ ipText – the IPv4 or IPv6 address string

exceptions –

​ NullReferenceException – if ipText is null

​ FormatException – if ipText is an invalid IP address

The StringToAddress method is more restrictive than the IPAddress Parse and TryParse methods as it does not support dotted octal or hexadecimal address strings.

HiddenTextBox

A WPF text box that hides text shortly after it is entered. As text is entered, it is quickly replaced by dots to obscure the characters like a password box.

Most standard TextBox properties and events are supported. Although the text is shown as dots, the unobscured characters can be accessed via the Text dependency property.

Additional dependency properties –

HideTime – specifies the time, in milliseconds, before the entered text is displayed as dots (default = 750).

DigitsOnly – when set to True, allows only the digits 0-9 to be entered (default = False).

AllowSpaces – when set to True, allows space characters to be entered (default = True).

The clipboard Copy operation is permitted, but Cut and Paste are prohibited.

VerticalLevelControl

HorizontalLevelControl

WPF controls that are alternatives to a slider. The current level is displayed as a bar and a numeric value, with the level value being adjusted up or down using a button on either end of the control. The level controls are identical except for their visual orientation.

Most standard properties and events are supported except for the Background property, which has no effect.

Additional dependency properties –

Value – the current level value.

Minimum – the minimum level value.

Maximum – the maximum level value.

SmallChange – the level increase or decrease caused by clicking the increase or decrease button.

FractionalDigits – the number of level value digits displayed after the decimal point.

LevelBrush – the brush used as the foreground of the level indicator bar.

LevelBackground – the brush used as the background of the level indicator bar.

IncreaseButtonBrush – the brush used as the foreground of the increase button.

DecreaseButtonBrush – the brush used as the foreground of the decrease button.

ButtonBackground – the brush used as the background of the increase and decrease buttons.

UseLevelClick – when set to True, the value can be changed by clicking on the indicator bar (default = False).

ShowLevelValue – when set to True, the numeric level value is displayed on the indicator bar (default = True).