title | author | description | ms.date |
---|---|---|---|
DoubleToIntConverter - .NET MAUI Community Toolkit |
bijington |
The DoubleToIntConverter is a converter that allows users to convert an incoming double value to an int and vice-versa. |
03/09/2022 |
The DoubleToIntConverter
is a converter that allows users to convert an incoming double
value to an int
and vice-versa. Optionally the user can provide a multiplier to the conversion through the Ratio
property.
The Convert
method returns the supplied value
converted to an int
and multiplied by a ratio.
The ConvertBack
method returns the supplied value
converted to a double
and divided by a ratio.
Note
Note that the ratio can be supplied in the following ways:
- as the
ConverterParameter
in the converter binding, - as the
Ratio
property on the converter.
Note that the ConverterParameter
option will take precedence over the Ratio
property.
[!INCLUDE common converter properties]
[!INCLUDE XAML usage guidance]
The DoubleToIntConverter
can be used as follows in XAML:
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"
x:Class="CommunityToolkit.Maui.Sample.Pages.Converters.DoubleToIntConverterPage">
<ContentPage.Resources>
<ResourceDictionary>
<toolkit:DoubleToIntConverter x:Key="DoubleToIntConverter" />
</ResourceDictionary>
</ContentPage.Resources>
<Label Text="{Binding MyValue, Converter={StaticResource DoubleToIntConverter}}" />
</ContentPage>
The DoubleToIntConverter
can be used as follows in C#:
class DoubleToIntConverterPage : ContentPage
{
public DoubleToIntConverterPage()
{
var label = new Label();
label.SetBinding(
Label.TextProperty,
new Binding(
nameof(ViewModel.MyValue),
converter: new DoubleToIntConverter()));
Content = label;
}
}
Our CommunityToolkit.Maui.Markup
package provides a much more concise way to use this converter in C#.
using CommunityToolkit.Maui.Markup;
class DoubleToIntConverterPage : ContentPage
{
public DoubleToIntConverterPage()
{
Content = new Label()
.Bind(
Label.TextProperty,
static (ViewModel vm) => vm.MyValue,
converter: new DoubleToIntConverter());
}
}
Property | Type | Description |
---|---|---|
Ratio | int |
The multiplier to apply during the conversion. |
You can find an example of this converter in action in the .NET MAUI Community Toolkit Sample Application.
You can find the source code for DoubleToIntConverter
over on the .NET MAUI Community Toolkit GitHub repository.