Skip to main content

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Documentation Search all OfficeIMO/
Class

OfficeTextMeasurer

OfficeIMO.Drawing

Namespace
OfficeIMO.Drawing
Assembly
OfficeIMO.Core
Source revision
ba882f6b0d07 with working tree changes
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

Explore 1 API references to this type

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

Returned or exposed by 1

Methods

public static OfficeTextMeasurer Create(OfficeFontInfo? fallbackFontInfo = null) #

Creates a deterministic text measurer.

Parameters

fallbackFontInfo OfficeIMO.Drawing.OfficeFontInfo? = null optional
public OfficeTextMeasurementStyle CreateDefaultStyle(double dpi) #

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

Parameters

dpi double required
CreateStyle 2 overloads
public OfficeTextMeasurementStyle CreateStyle(OfficeFontInfo fontInfo) #

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

Parameters

fontInfo OfficeIMO.Drawing.OfficeFontInfo required
public OfficeTextMeasurementStyle CreateStyle(OfficeFontInfo fontInfo, double dpi) #

Creates a style from a font descriptor and DPI value.

Parameters

fontInfo OfficeIMO.Drawing.OfficeFontInfo required
dpi double required
public OfficeTextMetrics Measure(string? text, OfficeTextMeasurementStyle style) #

Measures text width and line metrics for the supplied style.

Parameters

text string? required
style OfficeIMO.Drawing.OfficeTextMeasurementStyle required
public double MeasureLineHeight(OfficeTextMeasurementStyle style) #

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

Parameters

style OfficeIMO.Drawing.OfficeTextMeasurementStyle required

Returns

double
public double MeasureLineHeightOrDefault(string? text, OfficeTextMeasurementStyle style, double fallback) #

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

Parameters

text string? required
style OfficeIMO.Drawing.OfficeTextMeasurementStyle required
fallback double required

Returns

double
public double MeasureWidth(string? text, OfficeTextMeasurementStyle style) #

Measures text width in pixels for the supplied style.

Parameters

text string? required
style OfficeIMO.Drawing.OfficeTextMeasurementStyle required

Returns

double
public double MeasureWidthOrDefault(string? text, OfficeTextMeasurementStyle style, double fallback) #

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

Parameters

text string? required
style OfficeIMO.Drawing.OfficeTextMeasurementStyle required
fallback double required

Returns

double

Properties

public OfficeTextMeasurementStyle DefaultStyle { get; } #

Default style derived from the fallback font.

public double DefaultFontSize { get; } #

Default font size in points.

public OfficeFontInfo FallbackFontInfo { get; } #

Fallback font descriptor used when no explicit font is available.

Fields

public const double DefaultDpi #

Default measurement DPI.

Value: 96