# MeasureConverter Class

> The MeasureConverter class provides a way to convert a measure in twips (twentieth of a point) to a value in another measuring unit. Twips are the measuring unit used by TXTextControl. Possible conversions are handled through the Unit property. The result of the conversion is a string or a double, which can be used to display the value for the user. This class can be used in XAML as a static resource to automatically convert bound property values.

- **Product:** TX Text Control .NET for WPF
- **Section:** Reference
- **Kind:** Class
- **Introduced:** 16.0
- **Namespace:** `TXTextControl.WPF`
- **Package:** `TXTextControl.TextControl.WPF.SDK` (assembly `TXTextControl.WPF.dll`, from the private NuGet feed or Text Control Offline Packages)
- **.NET Framework:** reference `TXTextControl.WPF.dll` from the setup
- **Implements:** `System.Windows.Data.IValueConverter`
- **Path:** TX Text Control .NET for WPF > Reference > TXTextControl.WPF > MeasureConverter Class
- **893 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/measureconverter/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/measureconverter/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/measureconverter/llms-full.txt

---

### Description

The MeasureConverter class provides a way to convert a measure in twips (twentieth of a point) to a value in another measuring unit. Twips are the measuring unit used by TXTextControl. Possible conversions are handled through the [Unit](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/measureconverter/unit-property/llms-full.txt) property. The result of the conversion is a string or a double, which can be used to display the value for the user. This class can be used in XAML as a static resource to automatically convert bound property values.

### Syntax

```csharp
public class MeasureConverter : IValueConverter
```

```vbnet
Public Class MeasureConverter
    Implements IValueConverter
```

### Examples

The following XAML example binds the [InputFormat.TopDistance](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/inputformat/topdistance-property/llms-full.txt) property to a text box using the [WPF.MeasureConverter](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/measureconverter/llms-full.txt) class. The value of the top distance is converted to centimeter.

```plaintext
…
xmlns:tx="clr-namespace:TXTextControl.WPF;assembly=TXTextControl.WPF"
…
<Window.Resources>
    <tx:MeasureConverter Unit="Centimeter" x:Key="twipsConv" />
</Window.Resources>
…
<TextBox 
    Text="{Binding
        ElementName=textControl1,
        Path=InputFormat.TopDistance,
        Converter={StaticResource twipsConv},
        Mode=TwoWay}" />
```

The following example creates a Measure Converter instance and configures its unit setting for a document workflow.

```csharp
TXTextControl.WPF.MeasureConverter measureConverter = new();
measureConverter.Unit = MeasuringUnit.CentiInch;
```

```vbnet
Dim measureConverter As New TXTextControl.WPF.MeasureConverter()
measureConverter.Unit = MeasuringUnit.CentiInch
```

---

## In This Section

- [MeasureConverter.Convert Method](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/measureconverter/convert-method/llms-full.txt): Converts a value from twips to another meaasuring unit.
- [MeasureConverter.ConvertBack Method](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/measureconverter/convertback-method/llms-full.txt): Converts a value from another measuring unit to twips.
- [MeasureConverter.Decimals Property](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/measureconverter/decimals-property/llms-full.txt): Gets or sets the number of decimals for the converted value.
- [MeasureConverter.ShowAllDecimals Property](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/measureconverter/showalldecimals-property/llms-full.txt): Gets or sets a value specifying whether all decimals set with the Decimals property are shown, when the result is a string. If 3 decimals are set and the value is 15.5, the resulting string contains 15.500 when ShowAllDecimals is true and 15.5 when ShowAllDecimals is false. If the result is a double, this property has no meaning.
- [MeasureConverter.Unit Property](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/measureconverter/unit-property/llms-full.txt): Gets or sets the measuring unit for the conversion.

---

## Nearby

- **Previous:** [LogarithmicConverter.OutputMinimum Property](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/logarithmicconverter/outputminimum-property/llms-full.txt)
- **Next:** [MeasureConverter.Convert Method](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/measureconverter/convert-method/llms-full.txt)