CharacterPropertiesBase.Scale Property

Gets or sets the font’s scaling percentage.

Namespace: DevExpress.XtraRichEdit.API.Native

Assembly: DevExpress.RichEdit.v20.2.Core.dll

NuGet Package: DevExpress.RichEdit.Core

NuGet Packages: DevExpress.RichEdit.Core, DevExpress.WindowsDesktop.RichEdit.Core

Declaration

C#

int? Scale { get; set; }

VB.NET

Property Scale As Integer?

Property Value

Type	Description
Nullable<Int32>	The scaling percentage (from 1 to 600); or null (Nothing in Visual Basic) for a mixture of values.

Remarks

Use this property to stretch or compress text horizontally by a percentage of the current size. If the property value is more that 600, an exception is thrown.

The code sample below shows how to specify 150% scaling for a document’s third paragraph:

C#

Document document = wordProcessor.Document;
var targetParagraph = document.Paragraphs[2];
var cP = document.BeginUpdateCharacters(targetParagraph.Range);
cP.Scale = 150;
document.EndUpdateCharacters(cP);

VB.NET

Dim document As Document = wordProcessor.Document
Dim targetParagraph = document.Paragraphs(2)
Dim cP = document.BeginUpdateCharacters(targetParagraph.Range)
cP.Scale = 150
document.EndUpdateCharacters(cP)

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the Scale property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

word-document-api-examples/CS/CodeExamples/FormattingActions.cs#L38

CharacterProperties cp = document.BeginUpdateCharacters(range);
cp.Scale = 150;
cp.Spacing = -2;

VB.NET

word-document-api-examples/VB/CodeExamples/FormattingActions.vb#L35

Dim cp As DevExpress.XtraRichEdit.API.Native.CharacterProperties = document.BeginUpdateCharacters(range)
cp.Scale = 150
cp.Spacing = -2