CanvasJustificationOpportunity Structure

Specifies how to apply justification for a glyph.

Namespace: Microsoft.Graphics.Canvas.Text
Assembly: Microsoft.Graphics.Canvas (in Microsoft.Graphics.Canvas.dll) Version: 0.0.0.0

Syntax

public struct CanvasJustificationOpportunity

The CanvasJustificationOpportunity type exposes the following members.

Fields

	Name	Description
	AllowResidualCompression	Allow this compression point to use up any remaining space even after all compression priorities have been used up.
	AllowResidualExpansion	Allow this expansion point to use up any remaining slack space even after all expansion priorities have been used up.
	ApplyToLeadingEdge	Apply expansion and compression to the leading edge of the glyph.
	ApplyToTrailingEdge	Apply expansion and compression to the trailing edge of the glyph.
	CompressionMaximum	Maximum amount of compression to apply to the glyph.
	CompressionPriority	Priority of this compression point. Larger priorities are applied later, while priority zero does nothing.
	ExpansionMaximum	Maximum amount of expansion to apply to the glyph.
	ExpansionMinimum	Minimum amount of expansion to apply to the glyph.
	ExpansionPriority	Priority of this expansion point. Larger priorities are applied later, while priority zero does nothing.

Remarks

An app doesn't need to decipher or manipulate CanvasJustificationOpportunity data in order to perform justification. The array of justification data from GetJustificationOpportunities(CanvasCharacterRange, CanvasFontFace, Single, CanvasAnalyzedScript, Int32, CanvasGlyphShaping) can simply be passed to ApplyJustificationOpportunities(Single, CanvasJustificationOpportunity, CanvasGlyph) unmodified. Exposing CanvasJustificationOpportunity data gives apps the opportunity to customize justification behavior.