New to Telerik UI for WinForms? Start a free 30-day trial

Converts numeric or string lengths to pixel-based double values. String values support the px, in, cm, and pt suffixes; Auto maps to NaN.

Definition

Namespace:Telerik.WinControls.UI.Diagrams

Assembly:Telerik.WinControls.RadDiagram.dll

Syntax:

C#
public class LengthConverter : TypeConverter

Inheritance: objectTypeConverterLengthConverter

Inherited Members TypeConverter.CanConvertFrom(Type)TypeConverter.CanConvertTo(Type)TypeConverter.ConvertFrom(object)TypeConverter.ConvertFromInvariantString(string)TypeConverter.ConvertFromInvariantString(ITypeDescriptorContext, string)TypeConverter.ConvertFromString(string)TypeConverter.ConvertFromString(ITypeDescriptorContext, string)TypeConverter.ConvertFromString(ITypeDescriptorContext, CultureInfo, string)TypeConverter.ConvertTo(object, Type)TypeConverter.ConvertToInvariantString(object)TypeConverter.ConvertToInvariantString(ITypeDescriptorContext, object)TypeConverter.ConvertToString(object)TypeConverter.ConvertToString(ITypeDescriptorContext, object)TypeConverter.ConvertToString(ITypeDescriptorContext, CultureInfo, object)TypeConverter.CreateInstance(IDictionary)TypeConverter.CreateInstance(ITypeDescriptorContext, IDictionary)TypeConverter.GetConvertFromException(object)TypeConverter.GetConvertToException(object, Type)TypeConverter.GetCreateInstanceSupported()TypeConverter.GetCreateInstanceSupported(ITypeDescriptorContext)TypeConverter.GetProperties(object)TypeConverter.GetProperties(ITypeDescriptorContext, object)TypeConverter.GetProperties(ITypeDescriptorContext, object, Attribute[])TypeConverter.GetPropertiesSupported()TypeConverter.GetPropertiesSupported(ITypeDescriptorContext)TypeConverter.GetStandardValues()TypeConverter.GetStandardValues(ITypeDescriptorContext)TypeConverter.GetStandardValuesExclusive()TypeConverter.GetStandardValuesExclusive(ITypeDescriptorContext)TypeConverter.GetStandardValuesSupported()TypeConverter.GetStandardValuesSupported(ITypeDescriptorContext)TypeConverter.IsValid(object)TypeConverter.IsValid(ITypeDescriptorContext, object)TypeConverter.SortProperties(PropertyDescriptorCollection, string[])...

Constructors

Creates a converter for numeric and unit-suffixed length values.

C#
public LengthConverter()

Methods

Checks whether the converter accepts one of its supported numeric types or a length string.

C#
public override bool CanConvertFrom(ITypeDescriptorContext typeDescriptorContext, Type sourceType)
Parameters:typeDescriptorContextITypeDescriptorContext

The conversion context, when available.

sourceTypeType

The type of the value to convert.

Returns:

bool

true for signed or unsigned 16-, 32-, and 64-bit integers, enums with those underlying types, single- or double-precision values, decimal values, and strings; otherwise, false.

Overrides: TypeConverter.CanConvertFrom(ITypeDescriptorContext, Type)

Checks whether a length can be represented as a string or an instance descriptor.

C#
public override bool CanConvertTo(ITypeDescriptorContext typeDescriptorContext, Type destinationType)
Parameters:typeDescriptorContextITypeDescriptorContext

The conversion context, when available.

destinationTypeType

The requested output type.

Returns:

bool

true for string and InstanceDescriptor; otherwise, false.

Overrides: TypeConverter.CanConvertTo(ITypeDescriptorContext, Type)

Converts a numeric value to a double or parses a unit-suffixed length string into pixel units.

C#
public override object ConvertFrom(ITypeDescriptorContext typeDescriptorContext, CultureInfo cultureInfo, object source)
Parameters:typeDescriptorContextITypeDescriptorContext

The conversion context, when available.

cultureInfoCultureInfo

The culture used to parse numeric text.

sourceobject

A supported numeric value or length string. The string Auto produces NaN.

Returns:

object

The length in pixel units, with NaN representing Auto.

Overrides: TypeConverter.ConvertFrom(ITypeDescriptorContext, CultureInfo, object)

Converts a double length to a string or an instance descriptor. NaN is represented by the string Auto.

C#
public override object ConvertTo(ITypeDescriptorContext typeDescriptorContext, CultureInfo cultureInfo, object value, Type destinationType)
Parameters:typeDescriptorContextITypeDescriptorContext

The conversion context, when available.

cultureInfoCultureInfo

The culture used when formatting a string.

valueobject

The length value to convert.

destinationTypeType

Either string or InstanceDescriptor.

Returns:

object

The formatted length or an instance descriptor that reconstructs the value.

Exceptions: ArgumentNullException

destinationType is null.

Overrides: TypeConverter.ConvertTo(ITypeDescriptorContext, CultureInfo, object, Type)