When to disable virtualization of SfRichTextBoxAdv control?

1 min read

By default, the SfRichTextBoxAdv control virtualizes the page on demand and helps reduce the initial load time and memory consumption when working with large-sized documents. You can disable the virtualization of the SfRichTextBoxAdv control by setting the IsVirtualizing property to false, to experience smoother and more rapid scrolling and zooming.

Please refer the following example code to disable the virtualization.

XAML:

<!-- Defines the SfRichTextBoxAdv control with virtualization disabled. --> 
<RichTextBoxAdv:SfRichTextBoxAdv x:Name="richTextBoxAdv" IsVirtualizing="False"/>

C#:

// Creates a new instance of the SfRichTextBoxAdv control.
SfRichTextBoxAdv richTextBoxAdv = new SfRichTextBoxAdv();
// Disables the virtualization of the SfRichTextBoxAdv control.
richTextBoxAdv.IsVirtualizing = false;

VB:

' Defines the SfRichTextBoxAdv control with virtualization disabled.
Dim richTextBoxAdv As New SfRichTextBoxAdv()
' Disables the virtualization of the SfRichTextBoxAdv control.
richTextBoxAdv.IsVirtualizing = False

Please refer to the following example code to disable the virtualization specific Windows 10 Mobile.

C#:

// Creates a new instance of the SfRichTextBoxAdv control.
SfRichTextBoxAdv richTextBoxAdv = new SfRichTextBoxAdv();
// Determines whether the application is running on Windows Mobile.
if (Windows.System.Profile.AnalyticsInfo.VersionInfo.DeviceFamily.Equals("Windows.Mobile", StringComparison.CurrentCultureIgnoreCase))
{
      // Disables the virtualization of the SfRichTextBoxAdv control, specific to Windows Mobile.
      richTextBoxAdv.IsVirtualizing = false;
}

VB:

' Defines the SfRichTextBoxAdv control with virtualization disabled.
Dim richTextBoxAdv As New SfRichTextBoxAdv()
' Determines whether the application is running on Windows Mobile.
If Windows.System.Profile.AnalyticsInfo.VersionInfo.DeviceFamily.Equals("Windows.Mobile", StringComparison.CurrentCultureIgnoreCase) Then
      ' Disables the virtualization of the SfRichTextBoxAdv control, specific to Windows Mobile.
      richTextBoxAdv.IsVirtualizing = False
End If

Please refer the following MSDN reference link, to create mobile specific designer file (XAML).

https://docs.microsoft.com/en-us/windows/uwp/design/layout/layouts-with-xaml#tailored-layouts

Please make use of the following tips to enable/disable virtualization of SfRichTextBoxAdv control.

Enable virtualization

Disable virtualization

Efficient for large-sized documents.
Reduces initial loading time for large-sized documents.
Scrolling and zooming experience will be smoother, with a reasonable UI refresh time based on the document content size.
Memory utilization is optimal for processing large-sized documents since UI elements will be alive only for the visible contents.

Efficient for small-sized documents.
Initial loading time will be reasonable based on the document content size.
Scrolling and zooming experience will be smoother, without any dependency on the document content size.
Memory utilization may increase rapidly for large-sized documents since UI elements will be alive for all the contents.

Did you find this information helpful?

Yes

When to disable virtualization of SfRichTextBoxAdv control?

Access denied