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 size documents. You can disable the virtualization of SfRichTextBoxAdv control by setting IsVirtualizing property as false, to experience scrolling and zooming as smoother and rapid.

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 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 the following example code to disable the virtualization specific Windows 10 Mobile.

C#:

// Creates 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 size documents.
Reduce initial loading time for large size documents.
Scrolling and zooming experience will be smoother, with a reasonable UI refresh time based on the document content size.
Memory utilization is optimal, to process large size documents. Since UI elements will be alive only for the visible contents.

Efficient for small size 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 size documents. Since UI elements will be alive for all the contents.

Did you find this information helpful?

Yes

Comments (0)

When to disable virtualization of SfRichTextBoxAdv control?

Access denied