# .NET MAUI RefreshView Thresholds

The RefreshView thresholds define how far the user must pull the content before the indicator appears and before a refresh starts. Adjust the thresholds to prevent accidental refreshes or to make the gesture shorter on small screens.

## Configure the Pull Distances

To configure the pull distances and the indicator size, use the following properties. All values are in device-independent .NET MAUI units:

* `IndicatorThreshold` (`double`)—Specifies the pull distance at which the indicator starts to appear. The default value is `0`. If the value isn't less than `PullingThreshold`, the indicator appears just before the pulling threshold is reached.
* `PullingThreshold` (`double`)—Specifies the pull distance required to start a refresh when the user releases the gesture. The default value is `80`. The value must be greater than `0`.
* `IndicatorAreaLength` (`double`)—Specifies the length of the refresh indicator along the pull direction. The default value is `48`. The value must be greater than `0`.

The RefreshView also exposes the read-only `Progress` (`double`) property. `Progress` returns the normalized pull progress from `0.0` to `1.0`. The value is `1.0` while a refresh is in progress.

## Set Custom Thresholds

The following example demonstrates how to set the `IndicatorThreshold`, `PullingThreshold`, and `IndicatorAreaLength` properties of the RefreshView.

1. Define the RefreshView in XAML:

   ```XAML
   <telerik:RadRefreshView x:Name="refreshView"
                           IndicatorThreshold="20"
                           PullingThreshold="120"
                           IndicatorAreaLength="64"
                           Refreshing="OnRefreshing">
       <VerticalStackLayout Padding="20"
                            Spacing="10"
                            BackgroundColor="#EEEEEE">
           <VerticalStackLayout Spacing="4">
               <HorizontalStackLayout>
                   <Label Text="{Binding Source={x:Reference refreshView}, Path=IndicatorThreshold, StringFormat='IndicatorThreshold: {0:F0}'}" />
                   <Slider Maximum="60"
                           Minimum="0"
                           Value="{Binding Source={x:Reference refreshView}, Path=IndicatorThreshold}" />
               </HorizontalStackLayout>
               <HorizontalStackLayout>
                   <Label Text="{Binding Source={x:Reference refreshView}, Path=PullingThreshold, StringFormat='PullingThreshold: {0:F0}'}" />
                   <Slider Maximum="200"
                           Minimum="80"
                           Value="{Binding Source={x:Reference refreshView}, Path=PullingThreshold}" />
               </HorizontalStackLayout>
               <HorizontalStackLayout>
                   <Label Text="{Binding Source={x:Reference refreshView}, Path=IndicatorAreaLength, StringFormat='IndicatorAreaLength: {0:F0}'}" />
                   <Slider Maximum="120"
                           Minimum="30"
                           Value="{Binding Source={x:Reference refreshView}, Path=IndicatorAreaLength}" />
               </HorizontalStackLayout>
               <Label Text="{Binding Source={x:Reference refreshView}, Path=Progress, StringFormat='Progress: {0:P0}'}" />
           </VerticalStackLayout>
           <Label Text="Pull down and observe how the thresholds affect the gesture." />
           <Label x:Name="statusLabel"
                  Text="Not refreshed yet" />
       </VerticalStackLayout>
   </telerik:RadRefreshView>
   ```

2. Add the `telerik` namespace:

   ```XAML
   xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui"
   ```

3. Handle the `Refreshing` event and end the refresh when the data is loaded:

   ```C#
   private async void OnRefreshing(object sender, EventArgs e)
   {
       await Task.Delay(1500);
       this.refreshCount++;
       this.statusLabel.Text = $"Refreshed {this.refreshCount} time(s)";
       this.refreshView.IsRefreshing = false;
   }
   ```

> tip For a runnable example with the RefreshView Thresholds scenario, see the [SDKBrowser Demo Application](https://www.telerik.com/maui-ui/documentation/demos-and-sample-apps/sdkbrowser-app) and go to the **RefreshView > Configuration** category.

## See Also

* [Pull Direction](https://www.telerik.com/maui-ui/documentation/controls/refreshview/pull-direction)
* [Transition Mode](https://www.telerik.com/maui-ui/documentation/controls/refreshview/transition-mode)
* [RefreshView Events](https://www.telerik.com/maui-ui/documentation/controls/refreshview/events)