Back to Devexpress

CharacterPropertiesBase.Scale Property

officefileapi-devexpress-dot-xtrarichedit-dot-api-dot-native-dot-characterpropertiesbase-61f8d72d.md

latest3.2 KB
Original Source

CharacterPropertiesBase.Scale Property

Gets or sets the font’s scaling percentage.

Namespace : DevExpress.XtraRichEdit.API.Native

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

NuGet Package : DevExpress.RichEdit.Core

Declaration

csharp
int? Scale { get; set; }
vb
Property Scale As Integer?

Property Value

TypeDescription
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:

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

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.

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

csharp
// Change character spacing and scaling.
cp.Scale = 150;
cp.Spacing = -2;

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

vb
' Change character spacing and scaling.
cp.Scale = 150
cp.Spacing = -2

See Also

CharacterPropertiesBase Interface

CharacterPropertiesBase Members

DevExpress.XtraRichEdit.API.Native Namespace