Skip to main content
SearchCtrl K
Community

Source code

OfficeIMO.NET libraries, CLI, Studio and browser tools 565 stars PSWriteOfficePowerShell module 165 stars

Talk and help

DiscordQuestions, ideas and show and tell Report an issueBugs and feature requests SponsorFund ongoing development

Mode

Background

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Search the whole siteOpen search page →
Documentation Search all OfficeIMO/

API Reference

Class

OfficeTextMeasurer

Edit on GitHub
Namespace OfficeIMO.Drawing
Assembly OfficeIMO.Core
Source ../../../../_/OfficeIMO.Core/OfficeTextMeasurer.cs:38
Modifiers sealed

Deterministic, zero-dependency text measurer for Office layout estimates.

Inheritance

  • Object
  • OfficeTextMeasurer

Remarks

This measurer intentionally does not call operating-system font APIs. It provides stable Office-oriented estimates for layout decisions such as autofit and wrapping.

Usage

This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.

Returned or exposed by

Methods

public static OfficeTextMeasurer Create(Nullable<OfficeFontInfo> fallbackFontInfo = null) #
../../../../_/OfficeIMO.Core/OfficeTextMeasurer.cs:38
Returns: OfficeTextMeasurer

Creates a deterministic text measurer.

Parameters

fallbackFontInfo System.Nullable{OfficeIMO.Drawing.OfficeFontInfo} = null optionalposition: 0
public OfficeTextMeasurementStyle CreateDefaultStyle(Double dpi) #
../../../../_/OfficeIMO.Core/OfficeTextMeasurer.cs:42
Returns: OfficeTextMeasurementStyle

Creates a style from the measurer fallback font and a DPI value.

Parameters

dpi System.Double requiredposition: 0
CreateStyle 2 overloads
public OfficeTextMeasurementStyle CreateStyle(OfficeFontInfo fontInfo) #
../../../../_/OfficeIMO.Core/OfficeTextMeasurer.cs:46
Returns: OfficeTextMeasurementStyle

Creates a style from a font descriptor using the default DPI.

Parameters

fontInfo OfficeIMO.Drawing.OfficeFontInfo requiredposition: 0
public OfficeTextMeasurementStyle CreateStyle(OfficeFontInfo fontInfo, Double dpi) #
../../../../_/OfficeIMO.Core/OfficeTextMeasurer.cs:50
Returns: OfficeTextMeasurementStyle

Creates a style from a font descriptor and DPI value.

Parameters

fontInfo OfficeIMO.Drawing.OfficeFontInfo requiredposition: 0
dpi System.Double requiredposition: 1
public OfficeTextMetrics Measure(String text, OfficeTextMeasurementStyle style) #
../../../../_/OfficeIMO.Core/OfficeTextMeasurer.cs:58
Returns: OfficeTextMetrics

Measures text width and line metrics for the supplied style.

Parameters

text System.String requiredposition: 0
style OfficeIMO.Drawing.OfficeTextMeasurementStyle requiredposition: 1
public Double MeasureLineHeight(OfficeTextMeasurementStyle style) #
../../../../_/OfficeIMO.Core/OfficeTextMeasurer.cs:90
Returns: Double

Measures a single-line text height in pixels for the supplied style.

Parameters

style OfficeIMO.Drawing.OfficeTextMeasurementStyle requiredposition: 0
public Double MeasureLineHeightOrDefault(String text, OfficeTextMeasurementStyle style, Double fallback) #
../../../../_/OfficeIMO.Core/OfficeTextMeasurer.cs:94
Returns: Double

Measures line height or returns the provided fallback when text is empty.

Parameters

text System.String requiredposition: 0
style OfficeIMO.Drawing.OfficeTextMeasurementStyle requiredposition: 1
fallback System.Double requiredposition: 2
public Double MeasureWidth(String text, OfficeTextMeasurementStyle style) #
../../../../_/OfficeIMO.Core/OfficeTextMeasurer.cs:65
Returns: Double

Measures text width in pixels for the supplied style.

Parameters

text System.String requiredposition: 0
style OfficeIMO.Drawing.OfficeTextMeasurementStyle requiredposition: 1
public Double MeasureWidthOrDefault(String text, OfficeTextMeasurementStyle style, Double fallback) #
../../../../_/OfficeIMO.Core/OfficeTextMeasurer.cs:84
Returns: Double

Measures text width or returns the provided fallback when text cannot be measured.

Parameters

text System.String requiredposition: 0
style OfficeIMO.Drawing.OfficeTextMeasurementStyle requiredposition: 1
fallback System.Double requiredposition: 2

Properties

public OfficeTextMeasurementStyle DefaultStyle { get; } #
../../../../_/OfficeIMO.Core/OfficeTextMeasurer.cs:28

Default style derived from the fallback font.

public Double DefaultFontSize { get; } #
../../../../_/OfficeIMO.Core/OfficeTextMeasurer.cs:31

Default font size in points.

public OfficeFontInfo FallbackFontInfo { get; } #
../../../../_/OfficeIMO.Core/OfficeTextMeasurer.cs:34

Fallback font descriptor used when no explicit font is available.

Fields

public const Double DefaultDpi #

Default measurement DPI.

Value: 96