Export (0) Print
Expand All
0 out of 1 rated this helpful - Rate this topic

RichTextBox.ZoomFactor Property

Gets or sets the current zoom level of the RichTextBox.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
public float ZoomFactor { get; set; }

Property Value

Type: System.Single
The factor by which the contents of the control is zoomed.
ExceptionCondition
ArgumentException

The specified zoom factor did not fall within the permissible range.

The value of this property can be between 1/64 (0.015625) and 64.0, not inclusive. A value of 1.0 indicates that no zoom is applied to the control. The zoom feature performs optimally when the document contains TrueType fonts. When a font that is not TrueType is used within the document of the control, the ZoomFactor property will use the nearest whole number value. You can use this property to enable the user of the RichTextBox control to zoom into sections of the documentation that are too small to view or to condense the view to enable more of the document to be viewed on screen.

The following code example demonstrates how to create a RichTextBox that zooms in on text, automatically selects words in the text of the control when a word is double-clicked, and has a margin on the right side of the client area of the control. If the RichTextBox control has a small width, using this code will create a RichTextBox where each character of text is displayed on its own line. While in this vertical display position, clicking on any part of a word will select all characters of the word regardless of the fact that the text is displayed vertically. This example requires that you have a form that contains a RichTextBox control named richTextBox1.

		private void ZoomMyRichTextBox()
		{
			// Enable users to select entire word when double clicked.
			richTextBox1.AutoWordSelection = true;
			// Clear contents of control.
			richTextBox1.Clear();
			// Set the right margin to restrict horizontal text.
			richTextBox1.RightMargin = 2;
			// Set the text for the control.
			richTextBox1.SelectedText = "Alpha Bravo Charlie Delta Echo Foxtrot";
			// Zoom by 2 points.
			richTextBox1.ZoomFactor = 2.0f;
		}

.NET Framework

Supported in: 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft. All rights reserved.